@formspec/eslint-plugin 0.1.0-alpha.3

package/dist/rules/index.js

@@ -0,0 +1,11 @@
+/**
+ * All FormSpec ESLint rules.
+ */
+export { decoratorFieldTypeMismatch } from "./decorator-field-type-mismatch.js";
+export { enumOptionsMatchType } from "./enum-options-match-type.js";
+export { showwhenFieldExists } from "./showwhen-field-exists.js";
+export { showwhenSuggestsOptional } from "./showwhen-suggests-optional.js";
+export { minMaxValidRange } from "./min-max-valid-range.js";
+export { noConflictingDecorators } from "./no-conflicting-decorators.js";
+export { noDuplicateDecorators } from "./no-duplicate-decorators.js";
+//# sourceMappingURL=index.js.map

package/dist/rules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rules/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/rules/min-max-valid-range.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Rule: min-max-valid-range
+ *
+ * Ensures @Min value is less than or equal to @Max value when both are present.
+ *
+ * Valid:
+ *   @Min(0)
+ *   @Max(100)
+ *   value!: number;
+ *
+ *   @Min(5)
+ *   @Max(5)  // Equal is OK
+ *   value!: number;
+ *
+ * Invalid:
+ *   @Min(100)
+ *   @Max(50)  // Min > Max
+ *   value!: number;
+ */
+import { ESLintUtils } from "@typescript-eslint/utils";
+type MessageIds = "minGreaterThanMax" | "minItemsGreaterThanMaxItems";
+export declare const minMaxValidRange: ESLintUtils.RuleModule<MessageIds, [], unknown, ESLintUtils.RuleListener> & {
+    name: string;
+};
+export {};
+//# sourceMappingURL=min-max-valid-range.d.ts.map

package/dist/rules/min-max-valid-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"min-max-valid-range.d.ts","sourceRoot":"","sources":["../../src/rules/min-max-valid-range.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAOvD,KAAK,UAAU,GAAG,mBAAmB,GAAG,6BAA6B,CAAC;AAEtE,eAAO,MAAM,gBAAgB;;CAsE3B,CAAC"}

package/dist/rules/min-max-valid-range.js

@@ -0,0 +1,82 @@
+/**
+ * Rule: min-max-valid-range
+ *
+ * Ensures @Min value is less than or equal to @Max value when both are present.
+ *
+ * Valid:
+ *   @Min(0)
+ *   @Max(100)
+ *   value!: number;
+ *
+ *   @Min(5)
+ *   @Max(5)  // Equal is OK
+ *   value!: number;
+ *
+ * Invalid:
+ *   @Min(100)
+ *   @Max(50)  // Min > Max
+ *   value!: number;
+ */
+import { ESLintUtils } from "@typescript-eslint/utils";
+import { findDecorator, getDecoratorLiteralArg } from "../utils/decorator-utils.js";
+const createRule = ESLintUtils.RuleCreator((name) => `https://formspec.dev/eslint-plugin/rules/${name}`);
+export const minMaxValidRange = createRule({
+    name: "min-max-valid-range",
+    meta: {
+        type: "problem",
+        docs: {
+            description: "Ensures @Min/@Max and @MinItems/@MaxItems have valid ranges",
+        },
+        messages: {
+            minGreaterThanMax: "@Min({{min}}) is greater than @Max({{max}}). Min must be less than or equal to Max.",
+            minItemsGreaterThanMaxItems: "@MinItems({{min}}) is greater than @MaxItems({{max}}). MinItems must be less than or equal to MaxItems.",
+        },
+        schema: [],
+    },
+    defaultOptions: [],
+    create(context) {
+        return {
+            PropertyDefinition(node) {
+                // Check @Min/@Max
+                const minDecorator = findDecorator(node, "Min");
+                const maxDecorator = findDecorator(node, "Max");
+                if (minDecorator && maxDecorator) {
+                    const minValue = getDecoratorLiteralArg(minDecorator);
+                    const maxValue = getDecoratorLiteralArg(maxDecorator);
+                    if (typeof minValue === "number" &&
+                        typeof maxValue === "number" &&
+                        minValue > maxValue) {
+                        context.report({
+                            node: minDecorator.node,
+                            messageId: "minGreaterThanMax",
+                            data: {
+                                min: String(minValue),
+                                max: String(maxValue),
+                            },
+                        });
+                    }
+                }
+                // Check @MinItems/@MaxItems
+                const minItemsDecorator = findDecorator(node, "MinItems");
+                const maxItemsDecorator = findDecorator(node, "MaxItems");
+                if (minItemsDecorator && maxItemsDecorator) {
+                    const minValue = getDecoratorLiteralArg(minItemsDecorator);
+                    const maxValue = getDecoratorLiteralArg(maxItemsDecorator);
+                    if (typeof minValue === "number" &&
+                        typeof maxValue === "number" &&
+                        minValue > maxValue) {
+                        context.report({
+                            node: minItemsDecorator.node,
+                            messageId: "minItemsGreaterThanMaxItems",
+                            data: {
+                                min: String(minValue),
+                                max: String(maxValue),
+                            },
+                        });
+                    }
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=min-max-valid-range.js.map

package/dist/rules/min-max-valid-range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"min-max-valid-range.js","sourceRoot":"","sources":["../../src/rules/min-max-valid-range.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAEpF,MAAM,UAAU,GAAG,WAAW,CAAC,WAAW,CACxC,CAAC,IAAI,EAAE,EAAE,CAAC,4CAA4C,IAAI,EAAE,CAC7D,CAAC;AAIF,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAiB;IACzD,IAAI,EAAE,qBAAqB;IAC3B,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,WAAW,EACT,6DAA6D;SAChE;QACD,QAAQ,EAAE;YACR,iBAAiB,EACf,qFAAqF;YACvF,2BAA2B,EACzB,yGAAyG;SAC5G;QACD,MAAM,EAAE,EAAE;KACX;IACD,cAAc,EAAE,EAAE;IAClB,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,kBAAkB,CAAC,IAAI;gBACrB,kBAAkB;gBAClB,MAAM,YAAY,GAAG,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBAChD,MAAM,YAAY,GAAG,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBAEhD,IAAI,YAAY,IAAI,YAAY,EAAE,CAAC;oBACjC,MAAM,QAAQ,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAC;oBACtD,MAAM,QAAQ,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAC;oBAEtD,IACE,OAAO,QAAQ,KAAK,QAAQ;wBAC5B,OAAO,QAAQ,KAAK,QAAQ;wBAC5B,QAAQ,GAAG,QAAQ,EACnB,CAAC;wBACD,OAAO,CAAC,MAAM,CAAC;4BACb,IAAI,EAAE,YAAY,CAAC,IAAI;4BACvB,SAAS,EAAE,mBAAmB;4BAC9B,IAAI,EAAE;gCACJ,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC;gCACrB,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC;6BACtB;yBACF,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;gBAED,4BAA4B;gBAC5B,MAAM,iBAAiB,GAAG,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;gBAC1D,MAAM,iBAAiB,GAAG,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;gBAE1D,IAAI,iBAAiB,IAAI,iBAAiB,EAAE,CAAC;oBAC3C,MAAM,QAAQ,GAAG,sBAAsB,CAAC,iBAAiB,CAAC,CAAC;oBAC3D,MAAM,QAAQ,GAAG,sBAAsB,CAAC,iBAAiB,CAAC,CAAC;oBAE3D,IACE,OAAO,QAAQ,KAAK,QAAQ;wBAC5B,OAAO,QAAQ,KAAK,QAAQ;wBAC5B,QAAQ,GAAG,QAAQ,EACnB,CAAC;wBACD,OAAO,CAAC,MAAM,CAAC;4BACb,IAAI,EAAE,iBAAiB,CAAC,IAAI;4BAC5B,SAAS,EAAE,6BAA6B;4BACxC,IAAI,EAAE;gCACJ,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC;gCACrB,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC;6BACtB;yBACF,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/rules/no-conflicting-decorators.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Rule: no-conflicting-decorators
+ *
+ * Ensures a field doesn't have decorators that imply conflicting types.
+ *
+ * Invalid:
+ *   @Min(0)           // Implies number
+ *   @Placeholder("x") // Implies string
+ *   field!: string;
+ *
+ *   @MinItems(1)      // Implies array
+ *   @Min(0)           // Implies number
+ *   field!: number[];
+ */
+import { ESLintUtils } from "@typescript-eslint/utils";
+export declare const noConflictingDecorators: ESLintUtils.RuleModule<"conflictingDecorators", [], unknown, ESLintUtils.RuleListener> & {
+    name: string;
+};
+//# sourceMappingURL=no-conflicting-decorators.d.ts.map

package/dist/rules/no-conflicting-decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-conflicting-decorators.d.ts","sourceRoot":"","sources":["../../src/rules/no-conflicting-decorators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAavD,eAAO,MAAM,uBAAuB;;CA6DlC,CAAC"}

package/dist/rules/no-conflicting-decorators.js

@@ -0,0 +1,76 @@
+/**
+ * Rule: no-conflicting-decorators
+ *
+ * Ensures a field doesn't have decorators that imply conflicting types.
+ *
+ * Invalid:
+ *   @Min(0)           // Implies number
+ *   @Placeholder("x") // Implies string
+ *   field!: string;
+ *
+ *   @MinItems(1)      // Implies array
+ *   @Min(0)           // Implies number
+ *   field!: number[];
+ */
+import { ESLintUtils } from "@typescript-eslint/utils";
+import { getFormSpecDecorators, DECORATOR_TYPE_HINTS, } from "../utils/decorator-utils.js";
+const createRule = ESLintUtils.RuleCreator((name) => `https://formspec.dev/eslint-plugin/rules/${name}`);
+export const noConflictingDecorators = createRule({
+    name: "no-conflicting-decorators",
+    meta: {
+        type: "problem",
+        docs: {
+            description: "Ensures a field doesn't have decorators that imply conflicting types",
+        },
+        messages: {
+            conflictingDecorators: "Field has conflicting decorators: @{{decorator1}} implies {{type1}}, but @{{decorator2}} implies {{type2}}",
+        },
+        schema: [],
+    },
+    defaultOptions: [],
+    create(context) {
+        return {
+            PropertyDefinition(node) {
+                const decorators = getFormSpecDecorators(node);
+                if (decorators.length < 2)
+                    return;
+                // Collect type hints from decorators
+                const typeHints = [];
+                for (const decorator of decorators) {
+                    // Only process decorators that have type hints
+                    if (decorator.name in DECORATOR_TYPE_HINTS) {
+                        const decoratorName = decorator.name;
+                        const typeHint = DECORATOR_TYPE_HINTS[decoratorName];
+                        typeHints.push({ decorator: decoratorName, type: typeHint });
+                    }
+                }
+                // Check for conflicts
+                if (typeHints.length < 2)
+                    return;
+                const firstHint = typeHints[0];
+                if (!firstHint)
+                    return;
+                for (let i = 1; i < typeHints.length; i++) {
+                    const hint = typeHints[i];
+                    if (!hint)
+                        continue;
+                    if (hint.type !== firstHint.type) {
+                        context.report({
+                            node: node.key,
+                            messageId: "conflictingDecorators",
+                            data: {
+                                decorator1: firstHint.decorator,
+                                type1: firstHint.type,
+                                decorator2: hint.decorator,
+                                type2: hint.type,
+                            },
+                        });
+                        // Only report once per field
+                        break;
+                    }
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=no-conflicting-decorators.js.map

package/dist/rules/no-conflicting-decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-conflicting-decorators.js","sourceRoot":"","sources":["../../src/rules/no-conflicting-decorators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EACL,qBAAqB,EACrB,oBAAoB,GAErB,MAAM,6BAA6B,CAAC;AAErC,MAAM,UAAU,GAAG,WAAW,CAAC,WAAW,CACxC,CAAC,IAAI,EAAE,EAAE,CAAC,4CAA4C,IAAI,EAAE,CAC7D,CAAC;AAIF,MAAM,CAAC,MAAM,uBAAuB,GAAG,UAAU,CAAiB;IAChE,IAAI,EAAE,2BAA2B;IACjC,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,WAAW,EACT,sEAAsE;SACzE;QACD,QAAQ,EAAE;YACR,qBAAqB,EACnB,4GAA4G;SAC/G;QACD,MAAM,EAAE,EAAE;KACX;IACD,cAAc,EAAE,EAAE;IAClB,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,kBAAkB,CAAC,IAAI;gBACrB,MAAM,UAAU,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;gBAC/C,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;oBAAE,OAAO;gBAElC,qCAAqC;gBACrC,MAAM,SAAS,GAA0C,EAAE,CAAC;gBAE5D,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;oBACnC,+CAA+C;oBAC/C,IAAI,SAAS,CAAC,IAAI,IAAI,oBAAoB,EAAE,CAAC;wBAC3C,MAAM,aAAa,GAAG,SAAS,CAAC,IAAyB,CAAC;wBAC1D,MAAM,QAAQ,GAAG,oBAAoB,CAAC,aAAa,CAAC,CAAC;wBACrD,SAAS,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;oBAC/D,CAAC;gBACH,CAAC;gBAED,sBAAsB;gBACtB,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;oBAAE,OAAO;gBAEjC,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;gBAC/B,IAAI,CAAC,SAAS;oBAAE,OAAO;gBAEvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBAC1C,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;oBAC1B,IAAI,CAAC,IAAI;wBAAE,SAAS;oBAEpB,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;wBACjC,OAAO,CAAC,MAAM,CAAC;4BACb,IAAI,EAAE,IAAI,CAAC,GAAG;4BACd,SAAS,EAAE,uBAAuB;4BAClC,IAAI,EAAE;gCACJ,UAAU,EAAE,SAAS,CAAC,SAAS;gCAC/B,KAAK,EAAE,SAAS,CAAC,IAAI;gCACrB,UAAU,EAAE,IAAI,CAAC,SAAS;gCAC1B,KAAK,EAAE,IAAI,CAAC,IAAI;6BACjB;yBACF,CAAC,CAAC;wBACH,6BAA6B;wBAC7B,MAAM;oBACR,CAAC;gBACH,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/rules/no-duplicate-decorators.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Rule: no-duplicate-decorators
+ *
+ * Ensures a field doesn't have the same decorator applied multiple times.
+ *
+ * Invalid:
+ *   @Label("First")
+ *   @Label("Second")  // Duplicate
+ *   field!: string;
+ *
+ *   @EnumOptions(["a", "b"])
+ *   @EnumOptions(["x", "y"])  // Duplicate
+ *   field!: string;
+ */
+import { ESLintUtils } from "@typescript-eslint/utils";
+export declare const noDuplicateDecorators: ESLintUtils.RuleModule<"duplicateDecorator", [], unknown, ESLintUtils.RuleListener> & {
+    name: string;
+};
+//# sourceMappingURL=no-duplicate-decorators.d.ts.map

package/dist/rules/no-duplicate-decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-duplicate-decorators.d.ts","sourceRoot":"","sources":["../../src/rules/no-duplicate-decorators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAyBvD,eAAO,MAAM,qBAAqB;;CA0ChC,CAAC"}

package/dist/rules/no-duplicate-decorators.js

@@ -0,0 +1,74 @@
+/**
+ * Rule: no-duplicate-decorators
+ *
+ * Ensures a field doesn't have the same decorator applied multiple times.
+ *
+ * Invalid:
+ *   @Label("First")
+ *   @Label("Second")  // Duplicate
+ *   field!: string;
+ *
+ *   @EnumOptions(["a", "b"])
+ *   @EnumOptions(["x", "y"])  // Duplicate
+ *   field!: string;
+ */
+import { ESLintUtils } from "@typescript-eslint/utils";
+import { getFormSpecDecorators } from "../utils/decorator-utils.js";
+const createRule = ESLintUtils.RuleCreator((name) => `https://formspec.dev/eslint-plugin/rules/${name}`);
+/**
+ * Decorators that should only appear once per field.
+ */
+const SINGLE_USE_DECORATORS = new Set([
+    "Label",
+    "Placeholder",
+    "Optional",
+    "Min",
+    "Max",
+    "MinItems",
+    "MaxItems",
+    "EnumOptions",
+    "Group",
+    "ShowWhen",
+]);
+export const noDuplicateDecorators = createRule({
+    name: "no-duplicate-decorators",
+    meta: {
+        type: "problem",
+        docs: {
+            description: "Ensures a field doesn't have the same decorator applied multiple times",
+        },
+        messages: {
+            duplicateDecorator: "Duplicate @{{decorator}} decorator. Each decorator should only appear once per field.",
+        },
+        schema: [],
+    },
+    defaultOptions: [],
+    create(context) {
+        return {
+            PropertyDefinition(node) {
+                const decorators = getFormSpecDecorators(node);
+                if (decorators.length < 2)
+                    return;
+                // Track seen decorators
+                const seen = new Map();
+                for (const decorator of decorators) {
+                    if (!SINGLE_USE_DECORATORS.has(decorator.name))
+                        continue;
+                    if (seen.has(decorator.name)) {
+                        context.report({
+                            node: decorator.node,
+                            messageId: "duplicateDecorator",
+                            data: {
+                                decorator: decorator.name,
+                            },
+                        });
+                    }
+                    else {
+                        seen.set(decorator.name, true);
+                    }
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=no-duplicate-decorators.js.map

package/dist/rules/no-duplicate-decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-duplicate-decorators.js","sourceRoot":"","sources":["../../src/rules/no-duplicate-decorators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,MAAM,UAAU,GAAG,WAAW,CAAC,WAAW,CACxC,CAAC,IAAI,EAAE,EAAE,CAAC,4CAA4C,IAAI,EAAE,CAC7D,CAAC;AAIF;;GAEG;AACH,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IACpC,OAAO;IACP,aAAa;IACb,UAAU;IACV,KAAK;IACL,KAAK;IACL,UAAU;IACV,UAAU;IACV,aAAa;IACb,OAAO;IACP,UAAU;CACX,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,UAAU,CAAiB;IAC9D,IAAI,EAAE,yBAAyB;IAC/B,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,WAAW,EACT,wEAAwE;SAC3E;QACD,QAAQ,EAAE;YACR,kBAAkB,EAChB,uFAAuF;SAC1F;QACD,MAAM,EAAE,EAAE;KACX;IACD,cAAc,EAAE,EAAE;IAClB,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,kBAAkB,CAAC,IAAI;gBACrB,MAAM,UAAU,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;gBAC/C,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;oBAAE,OAAO;gBAElC,wBAAwB;gBACxB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAmB,CAAC;gBAExC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;oBACnC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC;wBAAE,SAAS;oBAEzD,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;wBAC7B,OAAO,CAAC,MAAM,CAAC;4BACb,IAAI,EAAE,SAAS,CAAC,IAAI;4BACpB,SAAS,EAAE,oBAAoB;4BAC/B,IAAI,EAAE;gCACJ,SAAS,EAAE,SAAS,CAAC,IAAI;6BAC1B;yBACF,CAAC,CAAC;oBACL,CAAC;yBAAM,CAAC;wBACN,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;oBACjC,CAAC;gBACH,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/rules/showwhen-field-exists.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Rule: showwhen-field-exists
+ *
+ * Ensures @ShowWhen references a field that exists in the same class.
+ *
+ * Valid:
+ *   @EnumOptions(["a", "b"])
+ *   type!: "a" | "b";
+ *
+ *   @ShowWhen({ _predicate: "equals", field: "type", value: "a" })
+ *   conditionalField?: string;
+ *
+ * Invalid:
+ *   @ShowWhen({ _predicate: "equals", field: "nonexistent", value: "x" })
+ *   field?: string;  // "nonexistent" doesn't exist
+ */
+import { ESLintUtils } from "@typescript-eslint/utils";
+export declare const showwhenFieldExists: ESLintUtils.RuleModule<"fieldDoesNotExist", [], unknown, ESLintUtils.RuleListener> & {
+    name: string;
+};
+//# sourceMappingURL=showwhen-field-exists.d.ts.map

package/dist/rules/showwhen-field-exists.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"showwhen-field-exists.d.ts","sourceRoot":"","sources":["../../src/rules/showwhen-field-exists.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,WAAW,EAAkB,MAAM,0BAA0B,CAAC;AAavE,eAAO,MAAM,mBAAmB;;CAqD9B,CAAC"}

package/dist/rules/showwhen-field-exists.js

@@ -0,0 +1,68 @@
+/**
+ * Rule: showwhen-field-exists
+ *
+ * Ensures @ShowWhen references a field that exists in the same class.
+ *
+ * Valid:
+ *   @EnumOptions(["a", "b"])
+ *   type!: "a" | "b";
+ *
+ *   @ShowWhen({ _predicate: "equals", field: "type", value: "a" })
+ *   conditionalField?: string;
+ *
+ * Invalid:
+ *   @ShowWhen({ _predicate: "equals", field: "nonexistent", value: "x" })
+ *   field?: string;  // "nonexistent" doesn't exist
+ */
+import { ESLintUtils, AST_NODE_TYPES } from "@typescript-eslint/utils";
+import { findDecorator, getShowWhenField, getClassPropertyNames, } from "../utils/decorator-utils.js";
+const createRule = ESLintUtils.RuleCreator((name) => `https://formspec.dev/eslint-plugin/rules/${name}`);
+export const showwhenFieldExists = createRule({
+    name: "showwhen-field-exists",
+    meta: {
+        type: "problem",
+        docs: {
+            description: "Ensures @ShowWhen references a field that exists in the same class",
+        },
+        messages: {
+            fieldDoesNotExist: "@ShowWhen references field '{{referencedField}}' which does not exist in this class",
+        },
+        schema: [],
+    },
+    defaultOptions: [],
+    create(context) {
+        return {
+            PropertyDefinition(node) {
+                const showWhenDecorator = findDecorator(node, "ShowWhen");
+                if (!showWhenDecorator)
+                    return;
+                const referencedField = getShowWhenField(showWhenDecorator);
+                if (!referencedField)
+                    return;
+                // Find the parent class
+                // PropertyDefinition -> ClassBody -> ClassDeclaration/ClassExpression
+                // TypeScript guarantees node.parent is ClassBody for PropertyDefinition
+                const classBody = node.parent;
+                const classNode = classBody.parent;
+                if (classNode.type !== AST_NODE_TYPES.ClassDeclaration &&
+                    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- defensive check
+                    classNode.type !== AST_NODE_TYPES.ClassExpression) {
+                    return;
+                }
+                // Get all property names in the class
+                const propertyNames = getClassPropertyNames(classNode);
+                // Check if the referenced field exists
+                if (!propertyNames.has(referencedField)) {
+                    context.report({
+                        node: showWhenDecorator.node,
+                        messageId: "fieldDoesNotExist",
+                        data: {
+                            referencedField,
+                        },
+                    });
+                }
+            },
+        };
+    },
+});
+//# sourceMappingURL=showwhen-field-exists.js.map

package/dist/rules/showwhen-field-exists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"showwhen-field-exists.js","sourceRoot":"","sources":["../../src/rules/showwhen-field-exists.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AAErC,MAAM,UAAU,GAAG,WAAW,CAAC,WAAW,CACxC,CAAC,IAAI,EAAE,EAAE,CAAC,4CAA4C,IAAI,EAAE,CAC7D,CAAC;AAIF,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAiB;IAC5D,IAAI,EAAE,uBAAuB;IAC7B,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,WAAW,EACT,oEAAoE;SACvE;QACD,QAAQ,EAAE;YACR,iBAAiB,EACf,qFAAqF;SACxF;QACD,MAAM,EAAE,EAAE;KACX;IACD,cAAc,EAAE,EAAE;IAClB,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,kBAAkB,CAAC,IAAI;gBACrB,MAAM,iBAAiB,GAAG,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;gBAC1D,IAAI,CAAC,iBAAiB;oBAAE,OAAO;gBAE/B,MAAM,eAAe,GAAG,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;gBAC5D,IAAI,CAAC,eAAe;oBAAE,OAAO;gBAE7B,wBAAwB;gBACxB,sEAAsE;gBACtE,wEAAwE;gBACxE,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC;gBAC9B,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC;gBACnC,IACE,SAAS,CAAC,IAAI,KAAK,cAAc,CAAC,gBAAgB;oBAClD,0FAA0F;oBAC1F,SAAS,CAAC,IAAI,KAAK,cAAc,CAAC,eAAe,EACjD,CAAC;oBACD,OAAO;gBACT,CAAC;gBAED,sCAAsC;gBACtC,MAAM,aAAa,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;gBAEvD,uCAAuC;gBACvC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;oBACxC,OAAO,CAAC,MAAM,CAAC;wBACb,IAAI,EAAE,iBAAiB,CAAC,IAAI;wBAC5B,SAAS,EAAE,mBAAmB;wBAC9B,IAAI,EAAE;4BACJ,eAAe;yBAChB;qBACF,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/rules/showwhen-suggests-optional.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Rule: showwhen-suggests-optional
+ *
+ * Suggests that fields with @ShowWhen should be marked as optional (`?`)
+ * since they may not be present in the output when the condition is false.
+ *
+ * Valid:
+ *   @ShowWhen({ _predicate: "equals", field: "type", value: "a" })
+ *   conditionalField?: string;  // Optional - good
+ *
+ * Warning:
+ *   @ShowWhen({ _predicate: "equals", field: "type", value: "a" })
+ *   conditionalField!: string;  // Not optional - may cause issues
+ */
+import { ESLintUtils } from "@typescript-eslint/utils";
+export declare const showwhenSuggestsOptional: ESLintUtils.RuleModule<"shouldBeOptional", [], unknown, ESLintUtils.RuleListener> & {
+    name: string;
+};
+//# sourceMappingURL=showwhen-suggests-optional.d.ts.map

package/dist/rules/showwhen-suggests-optional.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"showwhen-suggests-optional.d.ts","sourceRoot":"","sources":["../../src/rules/showwhen-suggests-optional.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,WAAW,EAAkB,MAAM,0BAA0B,CAAC;AAUvE,eAAO,MAAM,wBAAwB;;CAqCnC,CAAC"}

package/dist/rules/showwhen-suggests-optional.js

@@ -0,0 +1,53 @@
+/**
+ * Rule: showwhen-suggests-optional
+ *
+ * Suggests that fields with @ShowWhen should be marked as optional (`?`)
+ * since they may not be present in the output when the condition is false.
+ *
+ * Valid:
+ *   @ShowWhen({ _predicate: "equals", field: "type", value: "a" })
+ *   conditionalField?: string;  // Optional - good
+ *
+ * Warning:
+ *   @ShowWhen({ _predicate: "equals", field: "type", value: "a" })
+ *   conditionalField!: string;  // Not optional - may cause issues
+ */
+import { ESLintUtils, AST_NODE_TYPES } from "@typescript-eslint/utils";
+import { findDecorator } from "../utils/decorator-utils.js";
+import { isOptionalProperty } from "../utils/type-utils.js";
+const createRule = ESLintUtils.RuleCreator((name) => `https://formspec.dev/eslint-plugin/rules/${name}`);
+export const showwhenSuggestsOptional = createRule({
+    name: "showwhen-suggests-optional",
+    meta: {
+        type: "suggestion",
+        docs: {
+            description: "Suggests that fields with @ShowWhen should be marked as optional",
+        },
+        messages: {
+            shouldBeOptional: "Field '{{field}}' uses @ShowWhen but is not optional. Consider adding '?' since the field may not be in the output when the condition is false.",
+        },
+        schema: [],
+    },
+    defaultOptions: [],
+    create(context) {
+        return {
+            PropertyDefinition(node) {
+                const showWhenDecorator = findDecorator(node, "ShowWhen");
+                if (!showWhenDecorator)
+                    return;
+                // Check if the field is already optional
+                if (isOptionalProperty(node))
+                    return;
+                const fieldName = node.key.type === AST_NODE_TYPES.Identifier ? node.key.name : "<computed>";
+                context.report({
+                    node: node.key,
+                    messageId: "shouldBeOptional",
+                    data: {
+                        field: fieldName,
+                    },
+                });
+            },
+        };
+    },
+});
+//# sourceMappingURL=showwhen-suggests-optional.js.map

package/dist/rules/showwhen-suggests-optional.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"showwhen-suggests-optional.js","sourceRoot":"","sources":["../../src/rules/showwhen-suggests-optional.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,UAAU,GAAG,WAAW,CAAC,WAAW,CACxC,CAAC,IAAI,EAAE,EAAE,CAAC,4CAA4C,IAAI,EAAE,CAC7D,CAAC;AAIF,MAAM,CAAC,MAAM,wBAAwB,GAAG,UAAU,CAAiB;IACjE,IAAI,EAAE,4BAA4B;IAClC,IAAI,EAAE;QACJ,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE;YACJ,WAAW,EACT,kEAAkE;SACrE;QACD,QAAQ,EAAE;YACR,gBAAgB,EACd,iJAAiJ;SACpJ;QACD,MAAM,EAAE,EAAE;KACX;IACD,cAAc,EAAE,EAAE;IAClB,MAAM,CAAC,OAAO;QACZ,OAAO;YACL,kBAAkB,CAAC,IAAI;gBACrB,MAAM,iBAAiB,GAAG,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;gBAC1D,IAAI,CAAC,iBAAiB;oBAAE,OAAO;gBAE/B,yCAAyC;gBACzC,IAAI,kBAAkB,CAAC,IAAI,CAAC;oBAAE,OAAO;gBAErC,MAAM,SAAS,GACb,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC;gBAE7E,OAAO,CAAC,MAAM,CAAC;oBACb,IAAI,EAAE,IAAI,CAAC,GAAG;oBACd,SAAS,EAAE,kBAAkB;oBAC7B,IAAI,EAAE;wBACJ,KAAK,EAAE,SAAS;qBACjB;iBACF,CAAC,CAAC;YACL,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,103 @@
+/**
+ * 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., "Min", "Label", "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 Min: "number";
+    readonly Max: "number";
+    readonly Placeholder: "string";
+    readonly MinItems: "array";
+    readonly MaxItems: "array";
+    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;AAEpE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+DAA+D;IAC/D,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;;;;;;;CAWvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,oBAAoB,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,mBAAmB,aAY9B,CAAC;AAEH;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,GAAG,aAAa,GAAG,IAAI,CAyBpF;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,QAAQ,CAAC,kBAAkB,GAChC,aAAa,EAAE,CAejB;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,CAWxE;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"}