@formspec/eslint-plugin 0.1.0-alpha.10

package/dist/utils/decorator-utils.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Utility functions for working with decorator AST nodes.
+ */
+import { TSESTree } from "@typescript-eslint/utils";
+/**
+ * Information extracted from a decorator.
+ */
+export interface DecoratorInfo {
+    /** The decorator name (e.g., "Minimum", "Field", "EnumOptions") */
+    name: string;
+    /** The arguments passed to the decorator */
+    args: TSESTree.Expression[];
+    /** The original decorator node */
+    node: TSESTree.Decorator;
+}
+/**
+ * FormSpec decorator names that imply specific field types.
+ */
+export declare const DECORATOR_TYPE_HINTS: {
+    readonly Minimum: "number";
+    readonly Maximum: "number";
+    readonly ExclusiveMinimum: "number";
+    readonly ExclusiveMaximum: "number";
+    readonly MinLength: "string";
+    readonly MaxLength: "string";
+    readonly Pattern: "string";
+    readonly EnumOptions: "enum";
+};
+export type TypeHintDecorator = keyof typeof DECORATOR_TYPE_HINTS;
+/**
+ * All known FormSpec decorator names.
+ */
+export declare const FORMSPEC_DECORATORS: Set<string>;
+/**
+ * Extracts decorator information from a Decorator AST node.
+ *
+ * Handles both:
+ * - `@DecoratorName` (identifier)
+ * - `@DecoratorName(args)` (call expression)
+ *
+ * @param decorator - The decorator AST node
+ * @returns Decorator info or null if not a recognized pattern
+ */
+export declare function getDecoratorInfo(decorator: TSESTree.Decorator): DecoratorInfo | null;
+/**
+ * Finds all decorators on a property definition.
+ *
+ * @param node - The property definition node
+ * @returns Array of decorator info objects for FormSpec decorators
+ */
+export declare function getFormSpecDecorators(node: TSESTree.PropertyDefinition): DecoratorInfo[];
+/**
+ * Finds a specific decorator by name on a property.
+ *
+ * @param node - The property definition node
+ * @param name - The decorator name to find
+ * @returns The decorator info or null if not found
+ */
+export declare function findDecorator(node: TSESTree.PropertyDefinition, name: string): DecoratorInfo | null;
+/**
+ * Checks if a property has a specific decorator.
+ *
+ * @param node - The property definition node
+ * @param name - The decorator name to check
+ * @returns True if the decorator is present
+ */
+export declare function hasDecorator(node: TSESTree.PropertyDefinition, name: string): boolean;
+/**
+ * Gets the first argument of a decorator as a literal value.
+ *
+ * @param decorator - The decorator info
+ * @returns The literal value or null if not a literal
+ */
+export declare function getDecoratorLiteralArg(decorator: DecoratorInfo): unknown;
+/**
+ * Gets the first argument of a decorator as an array of values.
+ * Used for @EnumOptions(["a", "b", "c"]).
+ *
+ * @param decorator - The decorator info
+ * @returns Array of values or null if not an array expression
+ */
+export declare function getDecoratorArrayArg(decorator: DecoratorInfo): unknown[] | null;
+/**
+ * Gets the field reference from a @ShowWhen predicate.
+ * @ShowWhen({ _predicate: "equals", field: "foo", value: "bar" })
+ *
+ * @param decorator - The ShowWhen decorator info
+ * @returns The field name or null if not found
+ */
+export declare function getShowWhenField(decorator: DecoratorInfo): string | null;
+/**
+ * Gets the property name from a PropertyDefinition.
+ *
+ * @param node - The property definition node
+ * @returns The property name or null if computed/symbol
+ */
+export declare function getPropertyName(node: TSESTree.PropertyDefinition): string | null;
+/**
+ * Gets all property names from a class definition.
+ *
+ * @param classNode - The class declaration/expression node
+ * @returns Set of property names
+ */
+export declare function getClassPropertyNames(classNode: TSESTree.ClassDeclaration | TSESTree.ClassExpression): Set<string>;
+//# sourceMappingURL=decorator-utils.d.ts.map

package/dist/utils/decorator-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorator-utils.d.ts","sourceRoot":"","sources":["../../src/utils/decorator-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAkB,MAAM,0BAA0B,CAAC;AAGpE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,IAAI,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC;IAC5B,kCAAkC;IAClC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC;CAC1B;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;CASvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,oBAAoB,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,mBAAmB,aAA4C,CAAC;AAE7E;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,GAAG,aAAa,GAAG,IAAI,CAyBpF;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,QAAQ,CAAC,kBAAkB,GAAG,aAAa,EAAE,CAexF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,QAAQ,CAAC,kBAAkB,EACjC,IAAI,EAAE,MAAM,GACX,aAAa,GAAG,IAAI,CAGtB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,kBAAkB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAErF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAqBxE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,EAAE,GAAG,IAAI,CAgC/E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAqBxE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,kBAAkB,GAAG,MAAM,GAAG,IAAI,CAQhF;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,QAAQ,CAAC,gBAAgB,GAAG,QAAQ,CAAC,eAAe,GAC9D,GAAG,CAAC,MAAM,CAAC,CAWb"}

package/dist/utils/decorator-utils.js

@@ -0,0 +1,216 @@
+/**
+ * Utility functions for working with decorator AST nodes.
+ */
+import { TSESTree, AST_NODE_TYPES } from "@typescript-eslint/utils";
+import { FORMSPEC_DECORATOR_NAMES } from "@formspec/core";
+/**
+ * FormSpec decorator names that imply specific field types.
+ */
+export const DECORATOR_TYPE_HINTS = {
+    Minimum: "number",
+    Maximum: "number",
+    ExclusiveMinimum: "number",
+    ExclusiveMaximum: "number",
+    MinLength: "string",
+    MaxLength: "string",
+    Pattern: "string",
+    EnumOptions: "enum",
+};
+/**
+ * All known FormSpec decorator names.
+ */
+export const FORMSPEC_DECORATORS = new Set(FORMSPEC_DECORATOR_NAMES);
+/**
+ * Extracts decorator information from a Decorator AST node.
+ *
+ * Handles both:
+ * - `@DecoratorName` (identifier)
+ * - `@DecoratorName(args)` (call expression)
+ *
+ * @param decorator - The decorator AST node
+ * @returns Decorator info or null if not a recognized pattern
+ */
+export function getDecoratorInfo(decorator) {
+    const expr = decorator.expression;
+    // Case 1: @DecoratorName() - CallExpression
+    if (expr.type === AST_NODE_TYPES.CallExpression) {
+        const callee = expr.callee;
+        if (callee.type === AST_NODE_TYPES.Identifier) {
+            return {
+                name: callee.name,
+                args: expr.arguments,
+                node: decorator,
+            };
+        }
+    }
+    // Case 2: @DecoratorName - Identifier (no parentheses)
+    if (expr.type === AST_NODE_TYPES.Identifier) {
+        return {
+            name: expr.name,
+            args: [],
+            node: decorator,
+        };
+    }
+    return null;
+}
+/**
+ * Finds all decorators on a property definition.
+ *
+ * @param node - The property definition node
+ * @returns Array of decorator info objects for FormSpec decorators
+ */
+export function getFormSpecDecorators(node) {
+    const decorators = node.decorators;
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- decorators can be undefined
+    if (!decorators || decorators.length === 0) {
+        return [];
+    }
+    const result = [];
+    for (const decorator of decorators) {
+        const info = getDecoratorInfo(decorator);
+        if (info && FORMSPEC_DECORATORS.has(info.name)) {
+            result.push(info);
+        }
+    }
+    return result;
+}
+/**
+ * Finds a specific decorator by name on a property.
+ *
+ * @param node - The property definition node
+ * @param name - The decorator name to find
+ * @returns The decorator info or null if not found
+ */
+export function findDecorator(node, name) {
+    const decorators = getFormSpecDecorators(node);
+    return decorators.find((d) => d.name === name) ?? null;
+}
+/**
+ * Checks if a property has a specific decorator.
+ *
+ * @param node - The property definition node
+ * @param name - The decorator name to check
+ * @returns True if the decorator is present
+ */
+export function hasDecorator(node, name) {
+    return findDecorator(node, name) !== null;
+}
+/**
+ * Gets the first argument of a decorator as a literal value.
+ *
+ * @param decorator - The decorator info
+ * @returns The literal value or null if not a literal
+ */
+export function getDecoratorLiteralArg(decorator) {
+    const arg = decorator.args[0];
+    if (!arg) {
+        return null;
+    }
+    if (arg.type === AST_NODE_TYPES.Literal) {
+        return arg.value;
+    }
+    // Handle negative numbers: -5 is a UnaryExpression('-', Literal(5))
+    if (arg.type === AST_NODE_TYPES.UnaryExpression &&
+        arg.operator === "-" &&
+        arg.argument.type === AST_NODE_TYPES.Literal &&
+        typeof arg.argument.value === "number") {
+        return -arg.argument.value;
+    }
+    return null;
+}
+/**
+ * Gets the first argument of a decorator as an array of values.
+ * Used for @EnumOptions(["a", "b", "c"]).
+ *
+ * @param decorator - The decorator info
+ * @returns Array of values or null if not an array expression
+ */
+export function getDecoratorArrayArg(decorator) {
+    const arg = decorator.args[0];
+    if (!arg) {
+        return null;
+    }
+    if (arg.type === AST_NODE_TYPES.ArrayExpression) {
+        const values = [];
+        for (const element of arg.elements) {
+            if (!element)
+                continue;
+            if (element.type === AST_NODE_TYPES.Literal) {
+                values.push(element.value);
+            }
+            else if (element.type === AST_NODE_TYPES.ObjectExpression) {
+                // Handle { id: "x", label: "X" } objects
+                const obj = {};
+                for (const prop of element.properties) {
+                    if (prop.type === AST_NODE_TYPES.Property &&
+                        prop.key.type === AST_NODE_TYPES.Identifier &&
+                        prop.value.type === AST_NODE_TYPES.Literal) {
+                        obj[prop.key.name] = prop.value.value;
+                    }
+                }
+                values.push(obj);
+            }
+        }
+        return values;
+    }
+    return null;
+}
+/**
+ * Gets the field reference from a @ShowWhen predicate.
+ * @ShowWhen({ _predicate: "equals", field: "foo", value: "bar" })
+ *
+ * @param decorator - The ShowWhen decorator info
+ * @returns The field name or null if not found
+ */
+export function getShowWhenField(decorator) {
+    const arg = decorator.args[0];
+    if (!arg) {
+        return null;
+    }
+    if (arg.type === AST_NODE_TYPES.ObjectExpression) {
+        for (const prop of arg.properties) {
+            if (prop.type === AST_NODE_TYPES.Property &&
+                prop.key.type === AST_NODE_TYPES.Identifier &&
+                prop.key.name === "field" &&
+                prop.value.type === AST_NODE_TYPES.Literal &&
+                typeof prop.value.value === "string") {
+                return prop.value.value;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Gets the property name from a PropertyDefinition.
+ *
+ * @param node - The property definition node
+ * @returns The property name or null if computed/symbol
+ */
+export function getPropertyName(node) {
+    if (node.key.type === AST_NODE_TYPES.Identifier) {
+        return node.key.name;
+    }
+    if (node.key.type === AST_NODE_TYPES.Literal && typeof node.key.value === "string") {
+        return node.key.value;
+    }
+    return null;
+}
+/**
+ * Gets all property names from a class definition.
+ *
+ * @param classNode - The class declaration/expression node
+ * @returns Set of property names
+ */
+export function getClassPropertyNames(classNode) {
+    const names = new Set();
+    for (const member of classNode.body.body) {
+        if (member.type === AST_NODE_TYPES.PropertyDefinition) {
+            const name = getPropertyName(member);
+            if (name) {
+                names.add(name);
+            }
+        }
+    }
+    return names;
+}
+//# sourceMappingURL=decorator-utils.js.map

package/dist/utils/decorator-utils.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Utility functions for FormSpec ESLint rules.
+ */
+export * from "./decorator-utils.js";
+export * from "./type-utils.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,6 @@
+/**
+ * Utility functions for FormSpec ESLint rules.
+ */
+export * from "./decorator-utils.js";
+export * from "./type-utils.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC"}

package/dist/utils/jsdoc-utils.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Utility functions for extracting constraint tags from JSDoc comments.
+ */
+import { type TSESTree } from "@typescript-eslint/utils";
+import type { SourceCode } from "@typescript-eslint/utils/ts-eslint";
+/** A constraint extracted from a JSDoc comment tag. */
+export interface JSDocConstraint {
+    /** The constraint name (e.g., "Minimum", "Maximum") */
+    name: string;
+    /** The parsed value */
+    value: number | string;
+    /** The comment node (for error reporting location) */
+    comment: TSESTree.Comment;
+}
+/**
+ * Extracts constraint tags from JSDoc comments preceding a node.
+ *
+ * @param node - The AST node to check for preceding JSDoc comments
+ * @param sourceCode - The ESLint source code object
+ * @returns Array of parsed JSDoc constraints
+ */
+export declare function getJSDocConstraints(node: TSESTree.Node, sourceCode: SourceCode): JSDocConstraint[];
+/**
+ * Finds a specific constraint by name in a JSDoc constraints array.
+ *
+ * @param constraints - The array of JSDoc constraints to search
+ * @param name - The constraint name to find
+ * @returns The matching constraint or null if not found
+ */
+export declare function findJSDocConstraint(constraints: JSDocConstraint[], name: string): JSDocConstraint | null;
+//# sourceMappingURL=jsdoc-utils.d.ts.map

package/dist/utils/jsdoc-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsdoc-utils.d.ts","sourceRoot":"","sources":["../../src/utils/jsdoc-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAGrE,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,sDAAsD;IACtD,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC;CAC3B;AAiBD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,CAAC,IAAI,EACnB,UAAU,EAAE,UAAU,GACrB,eAAe,EAAE,CAsDnB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,eAAe,EAAE,EAC9B,IAAI,EAAE,MAAM,GACX,eAAe,GAAG,IAAI,CAExB"}

package/dist/utils/jsdoc-utils.js

@@ -0,0 +1,81 @@
+/**
+ * Utility functions for extracting constraint tags from JSDoc comments.
+ */
+import { AST_NODE_TYPES } from "@typescript-eslint/utils";
+import { CONSTRAINT_TAG_DEFINITIONS } from "@formspec/core";
+const NUMERIC_TAG_NAMES = Object.keys(CONSTRAINT_TAG_DEFINITIONS).filter((k) => CONSTRAINT_TAG_DEFINITIONS[k] === "number");
+const NUMERIC_TAGS_PATTERN = NUMERIC_TAG_NAMES.join("|");
+// Numeric tags: value stops at the next `@` tag, `*/`, or end-of-line
+const NUMERIC_TAG_REGEX = new RegExp(`@(${NUMERIC_TAGS_PATTERN})\\s+(.+?)(?=\\s*@|\\s*\\*\\/|\\s*$)`, "gm");
+// Pattern tag: value captures everything until `*/` or end-of-line,
+// because regex patterns can contain `@` (e.g., email validation)
+const PATTERN_TAG_REGEX = /@Pattern\s+(.+?)(?=\s*\*\/|\s*$)/gm;
+/**
+ * Extracts constraint tags from JSDoc comments preceding a node.
+ *
+ * @param node - The AST node to check for preceding JSDoc comments
+ * @param sourceCode - The ESLint source code object
+ * @returns Array of parsed JSDoc constraints
+ */
+export function getJSDocConstraints(node, sourceCode) {
+    // Collect comments before the node itself
+    const comments = [...sourceCode.getCommentsBefore(node)];
+    // For PropertyDefinition with decorators, also check comments before the
+    // property key. JSDoc comments placed between decorators and the property
+    // name (e.g., `@Minimum(5)\n/** @Maximum 100 */\nvalue!: number;`) are
+    // not "before" the PropertyDefinition node — they're between the
+    // decorator and the key.
+    if (node.type === AST_NODE_TYPES.PropertyDefinition && node.decorators.length > 0) {
+        const keyComments = sourceCode.getCommentsBefore(node.key);
+        for (const c of keyComments) {
+            if (!comments.includes(c)) {
+                comments.push(c);
+            }
+        }
+    }
+    const results = [];
+    for (const comment of comments) {
+        // Only process JSDoc-style block comments (/** ... */)
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-enum-comparison -- TSESTree.Comment uses "Block"/"Line" strings, not AST_NODE_TYPES enum
+        if (comment.type !== "Block" || !comment.value.startsWith("*")) {
+            continue;
+        }
+        // Extract numeric constraint tags (Minimum, Maximum, MinLength, etc.)
+        NUMERIC_TAG_REGEX.lastIndex = 0;
+        let match;
+        while ((match = NUMERIC_TAG_REGEX.exec(comment.value)) !== null) {
+            const name = match[1];
+            const rawValue = match[2];
+            if (!name || !rawValue)
+                continue;
+            const cleanedValue = rawValue.replace(/^\s*\*\s*/gm, "").trim();
+            const parsed = Number(cleanedValue);
+            if (Number.isNaN(parsed))
+                continue;
+            results.push({ name, value: parsed, comment });
+        }
+        // Extract @Pattern separately — its value can contain `@` (e.g., email regex)
+        PATTERN_TAG_REGEX.lastIndex = 0;
+        while ((match = PATTERN_TAG_REGEX.exec(comment.value)) !== null) {
+            const rawValue = match[1];
+            if (!rawValue)
+                continue;
+            const cleanedValue = rawValue.replace(/^\s*\*\s*/gm, "").trim();
+            if (cleanedValue === "")
+                continue;
+            results.push({ name: "Pattern", value: cleanedValue, comment });
+        }
+    }
+    return results;
+}
+/**
+ * Finds a specific constraint by name in a JSDoc constraints array.
+ *
+ * @param constraints - The array of JSDoc constraints to search
+ * @param name - The constraint name to find
+ * @returns The matching constraint or null if not found
+ */
+export function findJSDocConstraint(constraints, name) {
+    return constraints.find((c) => c.name === name) ?? null;
+}
+//# sourceMappingURL=jsdoc-utils.js.map

package/dist/utils/jsdoc-utils.js.map

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

package/dist/utils/type-utils.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Utility functions for TypeScript type checking in ESLint rules.
+ */
+import type { ParserServicesWithTypeInformation } from "@typescript-eslint/utils";
+import type { TSESTree } from "@typescript-eslint/utils";
+import type ts from "typescript";
+/**
+ * Field type categories for FormSpec.
+ */
+export type FieldTypeCategory = "string" | "number" | "boolean" | "array" | "object" | "union" | "unknown";
+/**
+ * Checks if a TypeScript type is a string type.
+ *
+ * Handles string primitives, string literals, and unions of string types.
+ *
+ * @param type - The TypeScript type to check
+ * @param checker - The TypeScript type checker instance
+ * @returns True if the type is string, a string literal, or a union of string types
+ */
+export declare function isStringType(type: ts.Type, checker: ts.TypeChecker): boolean;
+/**
+ * Checks if a TypeScript type is a number type.
+ *
+ * Handles number primitives, number literals, and unions of number types.
+ *
+ * @param type - The TypeScript type to check
+ * @param checker - The TypeScript type checker instance
+ * @returns True if the type is number, a number literal, or a union of number types
+ */
+export declare function isNumberType(type: ts.Type, checker: ts.TypeChecker): boolean;
+/**
+ * Checks if a TypeScript type is a boolean type.
+ *
+ * Handles boolean primitives, boolean literals (true/false), and unions of boolean types.
+ *
+ * @param type - The TypeScript type to check
+ * @param checker - The TypeScript type checker instance
+ * @returns True if the type is boolean, true, false, or a union of boolean types
+ */
+export declare function isBooleanType(type: ts.Type, checker: ts.TypeChecker): boolean;
+/**
+ * Checks if a TypeScript type is an array type.
+ *
+ * Handles Array<T>, T[], and readonly arrays.
+ *
+ * @param type - The TypeScript type to check
+ * @param checker - The TypeScript type checker instance
+ * @returns True if the type is an array type
+ */
+export declare function isArrayType(type: ts.Type, checker: ts.TypeChecker): boolean;
+/**
+ * Determines the field type category from a TypeScript type.
+ *
+ * Categories help determine which decorators are valid for a field.
+ *
+ * @param type - The TypeScript type to categorize
+ * @param checker - The TypeScript type checker instance
+ * @returns The field type category
+ */
+export declare function getFieldTypeCategory(type: ts.Type, checker: ts.TypeChecker): FieldTypeCategory;
+/**
+ * Gets the TypeScript type of a class property.
+ */
+export declare function getPropertyType(node: TSESTree.PropertyDefinition, services: ParserServicesWithTypeInformation): ts.Type | null;
+/**
+ * Extracts string literal values from a union type.
+ * For type "a" | "b" | "c", returns ["a", "b", "c"].
+ */
+export declare function getStringLiteralUnionValues(type: ts.Type, _checker: ts.TypeChecker): string[] | null;
+/**
+ * Checks if a field is marked as optional (has `?` modifier).
+ */
+export declare function isOptionalProperty(node: TSESTree.PropertyDefinition): boolean;
+/**
+ * Gets the type checker from parser services.
+ */
+export declare function getTypeChecker(services: ParserServicesWithTypeInformation): ts.TypeChecker;
+/**
+ * Converts a TypeScript type to a readable string.
+ */
+export declare function typeToString(type: ts.Type, checker: ts.TypeChecker): string;
+//# sourceMappingURL=type-utils.d.ts.map

package/dist/utils/type-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-utils.d.ts","sourceRoot":"","sources":["../../src/utils/type-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,0BAA0B,CAAC;AAClF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAEjC;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,OAAO,GACP,QAAQ,GACR,OAAO,GACP,SAAS,CAAC;AAEd;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,GAAG,OAAO,CAiB5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,GAAG,OAAO,CAiB5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,GAAG,OAAO,CAiB7E;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,GAAG,OAAO,CAqB3E;AA2BD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,GAAG,iBAAiB,CAoB9F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,QAAQ,CAAC,kBAAkB,EACjC,QAAQ,EAAE,iCAAiC,GAC1C,EAAE,CAAC,IAAI,GAAG,IAAI,CAchB;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,EAAE,CAAC,IAAI,EACb,QAAQ,EAAE,EAAE,CAAC,WAAW,GACvB,MAAM,EAAE,GAAG,IAAI,CAoBjB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,CAAC,kBAAkB,GAAG,OAAO,CAE7E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,iCAAiC,GAAG,EAAE,CAAC,WAAW,CAE1F;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,GAAG,MAAM,CAE3E"}