@formspec/eslint-plugin 0.1.0-alpha.3

package/dist/utils/decorator-utils.js

@@ -0,0 +1,222 @@
+/**
+ * Utility functions for working with decorator AST nodes.
+ */
+import { TSESTree, AST_NODE_TYPES } from "@typescript-eslint/utils";
+/**
+ * FormSpec decorator names that imply specific field types.
+ */
+export const DECORATOR_TYPE_HINTS = {
+    // Number field decorators
+    Min: "number",
+    Max: "number",
+    // String/text field decorators
+    Placeholder: "string",
+    // Array field decorators
+    MinItems: "array",
+    MaxItems: "array",
+    // Enum field decorators
+    EnumOptions: "enum",
+};
+/**
+ * All known FormSpec decorator names.
+ */
+export const FORMSPEC_DECORATORS = new Set([
+    "FormClass",
+    "Label",
+    "Optional",
+    "Placeholder",
+    "Min",
+    "Max",
+    "EnumOptions",
+    "Group",
+    "ShowWhen",
+    "MinItems",
+    "MaxItems",
+]);
+/**
+ * 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;
+    }
+    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/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,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAE3G;;;;;;;;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;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,EAAE,CAAC,IAAI,EACb,OAAO,EAAE,EAAE,CAAC,WAAW,GACtB,iBAAiB,CAiBnB;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,CAC5B,QAAQ,EAAE,iCAAiC,GAC1C,EAAE,CAAC,WAAW,CAEhB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,EAAE,CAAC,IAAI,EACb,OAAO,EAAE,EAAE,CAAC,WAAW,GACtB,MAAM,CAER"}

package/dist/utils/type-utils.js

@@ -0,0 +1,192 @@
+/**
+ * Utility functions for TypeScript type checking in ESLint rules.
+ */
+/**
+ * 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 function isStringType(type, checker) {
+    // Check for string primitive
+    if (type.flags & 4 /* ts.TypeFlags.String */) {
+        return true;
+    }
+    // Check for string literal
+    if (type.flags & 128 /* ts.TypeFlags.StringLiteral */) {
+        return true;
+    }
+    // Check for union of string literals (e.g., "a" | "b")
+    if (type.isUnion()) {
+        return type.types.every((t) => isStringType(t, checker));
+    }
+    return false;
+}
+/**
+ * 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 function isNumberType(type, checker) {
+    // Check for number primitive
+    if (type.flags & 8 /* ts.TypeFlags.Number */) {
+        return true;
+    }
+    // Check for number literal
+    if (type.flags & 256 /* ts.TypeFlags.NumberLiteral */) {
+        return true;
+    }
+    // Check for union of number literals
+    if (type.isUnion()) {
+        return type.types.every((t) => isNumberType(t, checker));
+    }
+    return false;
+}
+/**
+ * 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 function isBooleanType(type, checker) {
+    // Check for boolean primitive
+    if (type.flags & 16 /* ts.TypeFlags.Boolean */) {
+        return true;
+    }
+    // Check for boolean literal (true or false)
+    if (type.flags & 512 /* ts.TypeFlags.BooleanLiteral */) {
+        return true;
+    }
+    // Check for union of true | false
+    if (type.isUnion()) {
+        return type.types.every((t) => isBooleanType(t, checker));
+    }
+    return false;
+}
+/**
+ * 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 function isArrayType(type, checker) {
+    // Check symbol name for Array
+    const symbol = type.getSymbol();
+    if (symbol?.name === "Array") {
+        return true;
+    }
+    // Check for array type node (T[])
+    const typeString = checker.typeToString(type);
+    if (typeString.endsWith("[]") || typeString.startsWith("Array<")) {
+        return true;
+    }
+    // Check if it's a reference to Array
+    const typeRef = type;
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- target may not exist on non-reference types
+    if (typeRef.target && typeRef.target.symbol?.name === "Array") {
+        return true;
+    }
+    return false;
+}
+/**
+ * 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 function getFieldTypeCategory(type, checker) {
+    if (isStringType(type, checker))
+        return "string";
+    if (isNumberType(type, checker))
+        return "number";
+    if (isBooleanType(type, checker))
+        return "boolean";
+    if (isArrayType(type, checker))
+        return "array";
+    // Check for object types (but not arrays)
+    if (type.flags & 524288 /* ts.TypeFlags.Object */) {
+        return "object";
+    }
+    // Check for unions that aren't all strings/numbers
+    if (type.isUnion()) {
+        return "union";
+    }
+    return "unknown";
+}
+/**
+ * Gets the TypeScript type of a class property.
+ */
+export function getPropertyType(node, services) {
+    try {
+        const checker = services.program.getTypeChecker();
+        const tsNode = services.esTreeNodeToTSNodeMap.get(node);
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- map.get() can return undefined
+        if (!tsNode)
+            return null;
+        // Get the type from the type annotation or initializer
+        const type = checker.getTypeAtLocation(tsNode);
+        return type;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Extracts string literal values from a union type.
+ * For type "a" | "b" | "c", returns ["a", "b", "c"].
+ */
+export function getStringLiteralUnionValues(type, _checker) {
+    if (!type.isUnion()) {
+        // Single string literal
+        if (type.isStringLiteral()) {
+            return [type.value];
+        }
+        return null;
+    }
+    const values = [];
+    for (const t of type.types) {
+        if (t.isStringLiteral()) {
+            values.push(t.value);
+        }
+        else {
+            // Not all members are string literals
+            return null;
+        }
+    }
+    return values.length > 0 ? values : null;
+}
+/**
+ * Checks if a field is marked as optional (has `?` modifier).
+ */
+export function isOptionalProperty(node) {
+    return node.optional;
+}
+/**
+ * Gets the type checker from parser services.
+ */
+export function getTypeChecker(services) {
+    return services.program.getTypeChecker();
+}
+/**
+ * Converts a TypeScript type to a readable string.
+ */
+export function typeToString(type, checker) {
+    return checker.typeToString(type);
+}
+//# sourceMappingURL=type-utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"type-utils.js","sourceRoot":"","sources":["../../src/utils/type-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,IAAa,EAAE,OAAuB;IACjE,6BAA6B;IAC7B,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,yBAAyB,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,2BAA2B;IAC3B,IAAI,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,gCAAgC,EAAE,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,uDAAuD;IACvD,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,IAAa,EAAE,OAAuB;IACjE,6BAA6B;IAC7B,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,yBAAyB,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,2BAA2B;IAC3B,IAAI,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,gCAAgC,EAAE,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qCAAqC;IACrC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,IAAa,EAAE,OAAuB;IAClE,8BAA8B;IAC9B,IAAI,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,0BAA0B,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4CAA4C;IAC5C,IAAI,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,iCAAiC,EAAE,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kCAAkC;IAClC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,IAAa,EAAE,OAAuB;IAChE,8BAA8B;IAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAChC,IAAI,MAAM,EAAE,IAAI,KAAK,OAAO,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kCAAkC;IAClC,MAAM,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qCAAqC;IACrC,MAAM,OAAO,GAAG,IAAwB,CAAC;IACzC,sHAAsH;IACtH,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,KAAK,OAAO,EAAE,CAAC;QAC9D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAa,EACb,OAAuB;IAEvB,IAAI,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC;QAAE,OAAO,QAAQ,CAAC;IACjD,IAAI,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC;QAAE,OAAO,QAAQ,CAAC;IACjD,IAAI,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IACnD,IAAI,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAE/C,0CAA0C;IAC1C,IAAI,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,yBAAyB,EAAE,CAAC;QAClD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,mDAAmD;IACnD,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;QACnB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAiC,EACjC,QAA2C;IAE3C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;QAClD,MAAM,MAAM,GAAG,QAAQ,CAAC,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAExD,yGAAyG;QACzG,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAEzB,uDAAuD;QACvD,MAAM,IAAI,GAAG,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,IAAa,EACb,QAAwB;IAExB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;QACpB,wBAAwB;QACxB,IAAI,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,CAAC,eAAe,EAAE,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,sCAAsC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAiC;IAClE,OAAO,IAAI,CAAC,QAAQ,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,QAA2C;IAE3C,OAAO,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAa,EACb,OAAuB;IAEvB,OAAO,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@formspec/eslint-plugin",
+  "version": "0.1.0-alpha.3",
+  "description": "ESLint rules for FormSpec decorator DSL type safety",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/eslint-plugin.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/eslint-plugin.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@typescript-eslint/utils": "^8.0.0"
+  },
+  "peerDependencies": {
+    "eslint": "^9.0.0",
+    "typescript": "^5.0.0"
+  },
+  "devDependencies": {
+    "@typescript-eslint/rule-tester": "^8.0.0",
+    "vitest": "^3.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "UNLICENSED",
+  "keywords": [
+    "eslint",
+    "eslint-plugin",
+    "formspec",
+    "decorators",
+    "typescript"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist temp",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "api-extractor": "api-extractor run",
+    "api-extractor:local": "api-extractor run --local",
+    "api-documenter": "api-documenter markdown -i temp -o docs"
+  }
+}