@formspec/eslint-plugin 0.1.0-alpha.3 → 0.1.0-alpha.7

package/dist/index.d.ts

@@ -1,13 +1,12 @@
 /**
  * @formspec/eslint-plugin
  *
- * ESLint plugin for FormSpec decorator DSL type safety.
+ * ESLint plugin for FormSpec type safety and constraint validation.
  *
- * Provides rules to catch common mistakes when using FormSpec decorators:
- * - Type mismatches between decorators and field types
- * - Invalid enum option configurations
- * - Missing or invalid @ShowWhen references
- * - Conflicting or duplicate decorators
+ * Provides rules to:
+ * - Catch common mistakes when using FormSpec decorators
+ * - Validate Chain DSL usage against project constraints
+ * - Ensure forms comply with target environment capabilities
  */
 import type { TSESLint } from "@typescript-eslint/utils";
 import { decoratorFieldTypeMismatch } from "./rules/decorator-field-type-mismatch.js";
@@ -17,6 +16,7 @@ import { showwhenSuggestsOptional } from "./rules/showwhen-suggests-optional.js"
 import { minMaxValidRange } from "./rules/min-max-valid-range.js";
 import { noConflictingDecorators } from "./rules/no-conflicting-decorators.js";
 import { noDuplicateDecorators } from "./rules/no-duplicate-decorators.js";
+import { allowedFieldTypes, allowedLayouts } from "./rules/constraints/index.js";
 /**
  * The FormSpec ESLint plugin.
  */
@@ -46,6 +46,12 @@ declare const plugin: {
         readonly "no-duplicate-decorators": TSESLint.RuleModule<"duplicateDecorator", [], unknown, TSESLint.RuleListener> & {
             name: string;
         };
+        readonly "constraints-allowed-field-types": TSESLint.RuleModule<"disallowedFieldType", import("./rules/constraints/allowed-field-types.js").Options, unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
+        readonly "constraints-allowed-layouts": TSESLint.RuleModule<"disallowedGroup" | "disallowedConditional", import("./rules/constraints/allowed-layouts.js").Options, unknown, TSESLint.RuleListener> & {
+            name: string;
+        };
     };
     configs: {
         recommended: TSESLint.FlatConfig.ConfigArray;
@@ -53,5 +59,5 @@ declare const plugin: {
     };
 };
 export default plugin;
-export { decoratorFieldTypeMismatch, enumOptionsMatchType, showwhenFieldExists, showwhenSuggestsOptional, minMaxValidRange, noConflictingDecorators, noDuplicateDecorators, };
+export { decoratorFieldTypeMismatch, enumOptionsMatchType, showwhenFieldExists, showwhenSuggestsOptional, minMaxValidRange, noConflictingDecorators, noDuplicateDecorators, allowedFieldTypes, allowedLayouts, };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AA6E3E;;GAEG;AACH,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAOX,CAAC;AAEF,eAAe,MAAM,CAAC;AAGtB,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,EAChB,uBAAuB,EACvB,qBAAqB,GACtB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAG3E,OAAO,EACL,iBAAiB,EACjB,cAAc,EACf,MAAM,8BAA8B,CAAC;AAkFtC;;GAEG;AACH,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAOX,CAAC;AAEF,eAAe,MAAM,CAAC;AAGtB,OAAO,EAEL,0BAA0B,EAC1B,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,EAChB,uBAAuB,EACvB,qBAAqB,EAErB,iBAAiB,EACjB,cAAc,GACf,CAAC"}

package/dist/index.js

@@ -1,13 +1,12 @@
 /**
  * @formspec/eslint-plugin
  *
- * ESLint plugin for FormSpec decorator DSL type safety.
+ * ESLint plugin for FormSpec type safety and constraint validation.
  *
- * Provides rules to catch common mistakes when using FormSpec decorators:
- * - Type mismatches between decorators and field types
- * - Invalid enum option configurations
- * - Missing or invalid @ShowWhen references
- * - Conflicting or duplicate decorators
+ * Provides rules to:
+ * - Catch common mistakes when using FormSpec decorators
+ * - Validate Chain DSL usage against project constraints
+ * - Ensure forms comply with target environment capabilities
  */
 import { decoratorFieldTypeMismatch } from "./rules/decorator-field-type-mismatch.js";
 import { enumOptionsMatchType } from "./rules/enum-options-match-type.js";
@@ -16,10 +15,13 @@ import { showwhenSuggestsOptional } from "./rules/showwhen-suggests-optional.js"
 import { minMaxValidRange } from "./rules/min-max-valid-range.js";
 import { noConflictingDecorators } from "./rules/no-conflicting-decorators.js";
 import { noDuplicateDecorators } from "./rules/no-duplicate-decorators.js";
+// Constraint rules for Chain DSL
+import { allowedFieldTypes, allowedLayouts, } from "./rules/constraints/index.js";
 /**
  * All rules provided by this plugin.
  */
 const rules = {
+    // Decorator DSL rules
     "decorator-field-type-mismatch": decoratorFieldTypeMismatch,
     "enum-options-match-type": enumOptionsMatchType,
     "showwhen-field-exists": showwhenFieldExists,
@@ -27,6 +29,9 @@ const rules = {
     "min-max-valid-range": minMaxValidRange,
     "no-conflicting-decorators": noConflictingDecorators,
     "no-duplicate-decorators": noDuplicateDecorators,
+    // Constraint rules for Chain DSL
+    "constraints-allowed-field-types": allowedFieldTypes,
+    "constraints-allowed-layouts": allowedLayouts,
 };
 /**
  * Plugin metadata.
@@ -100,5 +105,9 @@ const plugin = {
 };
 export default plugin;
 // Named exports for individual rules
-export { decoratorFieldTypeMismatch, enumOptionsMatchType, showwhenFieldExists, showwhenSuggestsOptional, minMaxValidRange, noConflictingDecorators, noDuplicateDecorators, };
+export { 
+// Decorator DSL rules
+decoratorFieldTypeMismatch, enumOptionsMatchType, showwhenFieldExists, showwhenSuggestsOptional, minMaxValidRange, noConflictingDecorators, noDuplicateDecorators, 
+// Constraint rules for Chain DSL
+allowedFieldTypes, allowedLayouts, };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAE3E;;GAEG;AACH,MAAM,KAAK,GAAG;IACZ,+BAA+B,EAAE,0BAA0B;IAC3D,yBAAyB,EAAE,oBAAoB;IAC/C,uBAAuB,EAAE,mBAAmB;IAC5C,4BAA4B,EAAE,wBAAwB;IACtD,qBAAqB,EAAE,gBAAgB;IACvC,2BAA2B,EAAE,uBAAuB;IACpD,yBAAyB,EAAE,qBAAqB;CACxC,CAAC;AAEX;;GAEG;AACH,MAAM,IAAI,GAAG;IACX,IAAI,EAAE,yBAAyB;CAChC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,iBAAiB,GAAoC;IACzD;QACE,OAAO,EAAE;YACP,WAAW,EAAE;gBACX,IAAI;gBACJ,KAAK;aACN;SACF;QACD,KAAK,EAAE;YACL,yCAAyC,EAAE,OAAO;YAClD,mCAAmC,EAAE,OAAO;YAC5C,iCAAiC,EAAE,OAAO;YAC1C,sCAAsC,EAAE,MAAM;YAC9C,+BAA+B,EAAE,OAAO;YACxC,qCAAqC,EAAE,OAAO;YAC9C,mCAAmC,EAAE,OAAO;SAC7C;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,YAAY,GAAoC;IACpD;QACE,OAAO,EAAE;YACP,WAAW,EAAE;gBACX,IAAI;gBACJ,KAAK;aACN;SACF;QACD,KAAK,EAAE;YACL,yCAAyC,EAAE,OAAO;YAClD,mCAAmC,EAAE,OAAO;YAC5C,iCAAiC,EAAE,OAAO;YAC1C,sCAAsC,EAAE,OAAO;YAC/C,+BAA+B,EAAE,OAAO;YACxC,qCAAqC,EAAE,OAAO;YAC9C,mCAAmC,EAAE,OAAO;SAC7C;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,GAAG;IACb,IAAI;IACJ,KAAK;IACL,OAAO,EAAE;QACP,WAAW,EAAE,iBAAiB;QAC9B,MAAM,EAAE,YAAY;KACrB;CACF,CAAC;AAEF,eAAe,MAAM,CAAC;AAEtB,qCAAqC;AACrC,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,EAChB,uBAAuB,EACvB,qBAAqB,GACtB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAE3E,iCAAiC;AACjC,OAAO,EACL,iBAAiB,EACjB,cAAc,GACf,MAAM,8BAA8B,CAAC;AAEtC;;GAEG;AACH,MAAM,KAAK,GAAG;IACZ,sBAAsB;IACtB,+BAA+B,EAAE,0BAA0B;IAC3D,yBAAyB,EAAE,oBAAoB;IAC/C,uBAAuB,EAAE,mBAAmB;IAC5C,4BAA4B,EAAE,wBAAwB;IACtD,qBAAqB,EAAE,gBAAgB;IACvC,2BAA2B,EAAE,uBAAuB;IACpD,yBAAyB,EAAE,qBAAqB;IAEhD,iCAAiC;IACjC,iCAAiC,EAAE,iBAAiB;IACpD,6BAA6B,EAAE,cAAc;CACrC,CAAC;AAEX;;GAEG;AACH,MAAM,IAAI,GAAG;IACX,IAAI,EAAE,yBAAyB;CAChC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,iBAAiB,GAAoC;IACzD;QACE,OAAO,EAAE;YACP,WAAW,EAAE;gBACX,IAAI;gBACJ,KAAK;aACN;SACF;QACD,KAAK,EAAE;YACL,yCAAyC,EAAE,OAAO;YAClD,mCAAmC,EAAE,OAAO;YAC5C,iCAAiC,EAAE,OAAO;YAC1C,sCAAsC,EAAE,MAAM;YAC9C,+BAA+B,EAAE,OAAO;YACxC,qCAAqC,EAAE,OAAO;YAC9C,mCAAmC,EAAE,OAAO;SAC7C;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,YAAY,GAAoC;IACpD;QACE,OAAO,EAAE;YACP,WAAW,EAAE;gBACX,IAAI;gBACJ,KAAK;aACN;SACF;QACD,KAAK,EAAE;YACL,yCAAyC,EAAE,OAAO;YAClD,mCAAmC,EAAE,OAAO;YAC5C,iCAAiC,EAAE,OAAO;YAC1C,sCAAsC,EAAE,OAAO;YAC/C,+BAA+B,EAAE,OAAO;YACxC,qCAAqC,EAAE,OAAO;YAC9C,mCAAmC,EAAE,OAAO;SAC7C;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,GAAG;IACb,IAAI;IACJ,KAAK;IACL,OAAO,EAAE;QACP,WAAW,EAAE,iBAAiB;QAC9B,MAAM,EAAE,YAAY;KACrB;CACF,CAAC;AAEF,eAAe,MAAM,CAAC;AAEtB,qCAAqC;AACrC,OAAO;AACL,sBAAsB;AACtB,0BAA0B,EAC1B,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,EAChB,uBAAuB,EACvB,qBAAqB;AACrB,iCAAiC;AACjC,iBAAiB,EACjB,cAAc,GACf,CAAC"}

package/dist/rules/constraints/allowed-field-types.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Rule: constraints/allowed-field-types
+ *
+ * Validates that field types used in the Chain DSL are allowed by the
+ * project's constraint configuration.
+ *
+ * Works with: field.text(), field.number(), field.boolean(), field.enum(),
+ * field.dynamicEnum(), field.dynamicSchema(), field.array(), field.object()
+ */
+import { ESLintUtils } from "@typescript-eslint/utils";
+import { type FieldTypeConstraints } from "@formspec/constraints/browser";
+export type Options = [FieldTypeConstraints];
+export declare const allowedFieldTypes: ESLintUtils.RuleModule<"disallowedFieldType", Options, unknown, ESLintUtils.RuleListener> & {
+    name: string;
+};
+//# sourceMappingURL=allowed-field-types.d.ts.map

package/dist/rules/constraints/allowed-field-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allowed-field-types.d.ts","sourceRoot":"","sources":["../../../src/rules/constraints/allowed-field-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAkB,MAAM,0BAA0B,CAAC;AAEvE,OAAO,EAEL,KAAK,oBAAoB,EAE1B,MAAM,+BAA+B,CAAC;AAwCvC,MAAM,MAAM,OAAO,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAE7C,eAAO,MAAM,iBAAiB;;CAuF5B,CAAC"}

package/dist/rules/constraints/allowed-field-types.js

@@ -0,0 +1,132 @@
+/**
+ * Rule: constraints/allowed-field-types
+ *
+ * Validates that field types used in the Chain DSL are allowed by the
+ * project's constraint configuration.
+ *
+ * Works with: field.text(), field.number(), field.boolean(), field.enum(),
+ * field.dynamicEnum(), field.dynamicSchema(), field.array(), field.object()
+ */
+import { ESLintUtils, AST_NODE_TYPES } from "@typescript-eslint/utils";
+import { getFieldTypeSeverity, } from "@formspec/constraints/browser";
+const createRule = ESLintUtils.RuleCreator((name) => `https://formspec.dev/eslint-plugin/rules/${name}`);
+/**
+ * Maps DSL method names to constraint config keys.
+ */
+const METHOD_TO_CONSTRAINT = {
+    text: "text",
+    number: "number",
+    boolean: "boolean",
+    enum: "staticEnum",
+    dynamicEnum: "dynamicEnum",
+    dynamicSchema: "dynamicSchema",
+    array: "array",
+    arrayWithConfig: "array",
+    object: "object",
+    objectWithConfig: "object",
+};
+/**
+ * Human-readable names for field types.
+ */
+const FIELD_TYPE_NAMES = {
+    text: "text field",
+    number: "number field",
+    boolean: "boolean field",
+    enum: "static enum field",
+    dynamicEnum: "dynamic enum field",
+    dynamicSchema: "dynamic schema field",
+    array: "array field",
+    arrayWithConfig: "array field",
+    object: "object field",
+    objectWithConfig: "object field",
+};
+export const allowedFieldTypes = createRule({
+    name: "constraints-allowed-field-types",
+    meta: {
+        type: "problem",
+        docs: {
+            description: "Validates that field types are allowed by the project's constraints",
+        },
+        messages: {
+            disallowedFieldType: "{{fieldTypeName}} is not allowed in this project. Field: '{{fieldName}}'",
+        },
+        schema: [
+            {
+                type: "object",
+                properties: {
+                    text: { type: "string", enum: ["error", "warn", "off"] },
+                    number: { type: "string", enum: ["error", "warn", "off"] },
+                    boolean: { type: "string", enum: ["error", "warn", "off"] },
+                    staticEnum: { type: "string", enum: ["error", "warn", "off"] },
+                    dynamicEnum: { type: "string", enum: ["error", "warn", "off"] },
+                    dynamicSchema: { type: "string", enum: ["error", "warn", "off"] },
+                    array: { type: "string", enum: ["error", "warn", "off"] },
+                    object: { type: "string", enum: ["error", "warn", "off"] },
+                },
+                additionalProperties: false,
+            },
+        ],
+    },
+    defaultOptions: [{}],
+    create(context) {
+        const constraints = context.options[0] ?? {};
+        return {
+            CallExpression(node) {
+                // Check for field.xxx() pattern
+                if (node.callee.type !== AST_NODE_TYPES.MemberExpression ||
+                    node.callee.object.type !== AST_NODE_TYPES.Identifier ||
+                    node.callee.object.name !== "field" ||
+                    node.callee.property.type !== AST_NODE_TYPES.Identifier) {
+                    return;
+                }
+                const methodName = node.callee.property.name;
+                const constraintKey = METHOD_TO_CONSTRAINT[methodName];
+                if (!constraintKey) {
+                    return; // Not a recognized field method
+                }
+                // Map constraint key to internal field type for severity check
+                const fieldTypeMap = {
+                    text: "text",
+                    number: "number",
+                    boolean: "boolean",
+                    staticEnum: "enum",
+                    dynamicEnum: "dynamic_enum",
+                    dynamicSchema: "dynamic_schema",
+                    array: "array",
+                    object: "object",
+                };
+                const internalFieldType = fieldTypeMap[constraintKey];
+                const severity = getFieldTypeSeverity(internalFieldType, constraints);
+                if (severity === "off") {
+                    return; // Allowed
+                }
+                // Extract field name from first argument
+                const fieldName = extractFieldName(node.arguments[0]);
+                const fieldTypeName = FIELD_TYPE_NAMES[methodName] || `${methodName} field`;
+                context.report({
+                    node: node.callee.property,
+                    messageId: "disallowedFieldType",
+                    data: {
+                        fieldTypeName,
+                        fieldName,
+                    },
+                });
+            },
+        };
+    },
+});
+/**
+ * Extracts the field name from the first argument of a field.xxx() call.
+ */
+function extractFieldName(arg) {
+    if (!arg)
+        return "<unknown>";
+    if (arg.type === AST_NODE_TYPES.Literal && typeof arg.value === "string") {
+        return arg.value;
+    }
+    if (arg.type === AST_NODE_TYPES.TemplateLiteral && arg.quasis.length === 1) {
+        return arg.quasis[0]?.value.cooked ?? "<unknown>";
+    }
+    return "<dynamic>";
+}
+//# sourceMappingURL=allowed-field-types.js.map

package/dist/rules/constraints/allowed-field-types.js.map

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

package/dist/rules/constraints/allowed-layouts.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Rule: constraints/allowed-layouts
+ *
+ * Validates that layout constructs (group, when/conditionals) used in the
+ * Chain DSL are allowed by the project's constraint configuration.
+ *
+ * Works with: group(), when()
+ */
+import { ESLintUtils } from "@typescript-eslint/utils";
+import { type LayoutConstraints } from "@formspec/constraints/browser";
+type MessageIds = "disallowedGroup" | "disallowedConditional";
+export type Options = [LayoutConstraints];
+export declare const allowedLayouts: ESLintUtils.RuleModule<MessageIds, Options, unknown, ESLintUtils.RuleListener> & {
+    name: string;
+};
+export {};
+//# sourceMappingURL=allowed-layouts.d.ts.map

package/dist/rules/constraints/allowed-layouts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allowed-layouts.d.ts","sourceRoot":"","sources":["../../../src/rules/constraints/allowed-layouts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAkB,MAAM,0BAA0B,CAAC;AAEvE,OAAO,EAAuB,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAM5F,KAAK,UAAU,GAAG,iBAAiB,GAAG,uBAAuB,CAAC;AAE9D,MAAM,MAAM,OAAO,GAAG,CAAC,iBAAiB,CAAC,CAAC;AAE1C,eAAO,MAAM,cAAc;;CA6DzB,CAAC"}

package/dist/rules/constraints/allowed-layouts.js

@@ -0,0 +1,82 @@
+/**
+ * Rule: constraints/allowed-layouts
+ *
+ * Validates that layout constructs (group, when/conditionals) used in the
+ * Chain DSL are allowed by the project's constraint configuration.
+ *
+ * Works with: group(), when()
+ */
+import { ESLintUtils, AST_NODE_TYPES } from "@typescript-eslint/utils";
+import { isLayoutTypeAllowed } from "@formspec/constraints/browser";
+const createRule = ESLintUtils.RuleCreator((name) => `https://formspec.dev/eslint-plugin/rules/${name}`);
+export const allowedLayouts = createRule({
+    name: "constraints-allowed-layouts",
+    meta: {
+        type: "problem",
+        docs: {
+            description: "Validates that layout constructs (group, conditionals) are allowed by the project's constraints",
+        },
+        messages: {
+            disallowedGroup: "group() is not allowed - visual grouping is not supported in this project{{labelInfo}}",
+            disallowedConditional: "when() conditional visibility is not allowed in this project",
+        },
+        schema: [
+            {
+                type: "object",
+                properties: {
+                    group: { type: "string", enum: ["error", "warn", "off"] },
+                    conditionals: { type: "string", enum: ["error", "warn", "off"] },
+                    maxNestingDepth: { type: "number", minimum: 0 },
+                },
+                additionalProperties: false,
+            },
+        ],
+    },
+    defaultOptions: [{}],
+    create(context) {
+        const constraints = context.options[0] ?? {};
+        return {
+            CallExpression(node) {
+                // Check for group() or when() calls
+                if (node.callee.type !== AST_NODE_TYPES.Identifier) {
+                    return;
+                }
+                const functionName = node.callee.name;
+                if (functionName === "group") {
+                    if (!isLayoutTypeAllowed("group", constraints)) {
+                        const label = extractGroupLabel(node.arguments[0]);
+                        const labelInfo = label ? ` (label: "${label}")` : "";
+                        context.report({
+                            node: node.callee,
+                            messageId: "disallowedGroup",
+                            data: { labelInfo },
+                        });
+                    }
+                }
+                else if (functionName === "when") {
+                    if (!isLayoutTypeAllowed("conditional", constraints)) {
+                        context.report({
+                            node: node.callee,
+                            messageId: "disallowedConditional",
+                        });
+                    }
+                }
+            },
+        };
+    },
+});
+/**
+ * Extracts the group label from the first argument of a group() call.
+ */
+function extractGroupLabel(arg) {
+    if (!arg)
+        return null;
+    if (arg.type === AST_NODE_TYPES.Literal && typeof arg.value === "string") {
+        return arg.value;
+    }
+    if (arg.type === AST_NODE_TYPES.TemplateLiteral && arg.quasis.length === 1) {
+        return arg.quasis[0]?.value.cooked ?? null;
+    }
+    return null;
+}
+//# sourceMappingURL=allowed-layouts.js.map

package/dist/rules/constraints/allowed-layouts.js.map

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

package/dist/rules/constraints/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Constraint validation rules for FormSpec Chain DSL.
+ *
+ * These rules validate that FormSpec constructs are allowed by the
+ * project's constraint configuration (.formspec.yml).
+ */
+export { allowedFieldTypes } from "./allowed-field-types.js";
+export { allowedLayouts } from "./allowed-layouts.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/rules/constraints/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/rules/constraints/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/rules/constraints/index.js

@@ -0,0 +1,9 @@
+/**
+ * Constraint validation rules for FormSpec Chain DSL.
+ *
+ * These rules validate that FormSpec constructs are allowed by the
+ * project's constraint configuration (.formspec.yml).
+ */
+export { allowedFieldTypes } from "./allowed-field-types.js";
+export { allowedLayouts } from "./allowed-layouts.js";
+//# sourceMappingURL=index.js.map

package/dist/rules/constraints/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/rules/constraints/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formspec/eslint-plugin",
-  "version": "0.1.0-alpha.3",
+  "version": "0.1.0-alpha.7",
   "description": "ESLint rules for FormSpec decorator DSL type safety",
   "type": "module",
   "main": "./dist/index.js",
@@ -15,7 +15,8 @@
     "dist"
   ],
   "dependencies": {
-    "@typescript-eslint/utils": "^8.0.0"
+    "@typescript-eslint/utils": "^8.0.0",
+    "@formspec/constraints": "0.1.0-alpha.7"
   },
   "peerDependencies": {
     "eslint": "^9.0.0",