@objectstack/lint 11.10.0 → 12.1.0

package/dist/index.d.cts

@@ -69,7 +69,7 @@ interface WidgetBindingFinding {
     /** How to fix (or deliberately suppress) it. */
     hint: string;
 }
-type AnyRec$8 = Record<string, unknown>;
+type AnyRec$a = Record<string, unknown>;
 /**
  * Validate every dashboard widget's dataset binding. Returns the list of
  * findings (empty = clean). Caller decides how to surface them: `error`
@@ -77,7 +77,7 @@ type AnyRec$8 = Record<string, unknown>;
  * should fail validate/build; `warning` findings are advisory and must
  * never fail the build on their own.
  */
-declare function validateWidgetBindings(stack: AnyRec$8): WidgetBindingFinding[];
+declare function validateWidgetBindings(stack: AnyRec$a): WidgetBindingFinding[];
 
 interface ExprIssue {
     where: string;
@@ -90,12 +90,35 @@ interface ExprIssue {
      */
     severity?: 'error' | 'warning';
 }
-type AnyRec$7 = Record<string, unknown>;
+type AnyRec$9 = Record<string, unknown>;
 /**
  * Validate every predicate in the stack. Returns the list of issues (empty =
  * clean). Caller decides how to surface / whether to fail the build.
  */
-declare function validateStackExpressions(stack: AnyRec$7): ExprIssue[];
+declare function validateStackExpressions(stack: AnyRec$9): ExprIssue[];
+
+type ListViewModeSeverity = 'error' | 'warning';
+interface ListViewModeFinding {
+    severity: ListViewModeSeverity;
+    rule: string;
+    /** Human-readable location, e.g. `object "task" › listViews.my_pending`. */
+    where: string;
+    /** Config path, e.g. `objects[0].listViews.my_pending.userFilters`. */
+    path: string;
+    message: string;
+    hint: string;
+}
+declare const LIST_VIEW_FILTERS_IN_VIEWS_MODE = "list-view-filters-in-views-mode";
+type AnyRec$8 = Record<string, unknown>;
+/**
+ * Flag ADR-0053 "views" mode violations: `userFilters` / `quickFilters` on an
+ * object's built-in named views or a `defineView` default `list` / named
+ * `listViews`. Returns the list of findings (empty = clean). Caller decides how
+ * to surface / whether to fail the build.
+ *
+ * Feed the PRE-parse stack (normalizeStackInput output) — see file header.
+ */
+declare function validateListViewMode(stack: AnyRec$8): ListViewModeFinding[];
 
 type StyleSeverity = 'error' | 'warning';
 interface StyleFinding {
@@ -113,14 +136,14 @@ declare const STYLE_CLASSNAME_TAILWIND = "style-classname-tailwind";
 declare const STYLE_RESPONSIVE_NO_BASE = "style-responsive-no-base";
 declare const STYLE_UNKNOWN_CSS_PROPERTY = "style-unknown-css-property";
 declare const STYLE_UNKNOWN_TOKEN = "style-unknown-token";
-type AnyRec$6 = Record<string, unknown>;
+type AnyRec$7 = Record<string, unknown>;
 /**
  * Validate every page's component tree for SDUI styling correctness (ADR-0065).
  * Returns findings (empty = clean). `error` findings describe styles that are
  * silently dropped and should fail validate/build; `warning` findings are
  * advisory (typos, drift, footguns).
  */
-declare function validateResponsiveStyles(stack: AnyRec$6): StyleFinding[];
+declare function validateResponsiveStyles(stack: AnyRec$7): StyleFinding[];
 
 type JsxPageSeverity = 'error' | 'warning';
 interface JsxPageFinding {
@@ -133,8 +156,8 @@ interface JsxPageFinding {
     message: string;
     hint: string;
 }
-type AnyRec$5 = Record<string, unknown>;
-declare function validateJsxPages(stack: AnyRec$5, opts?: {
+type AnyRec$6 = Record<string, unknown>;
+declare function validateJsxPages(stack: AnyRec$6, opts?: {
     manifest?: Manifest;
 }): JsxPageFinding[];
 
@@ -147,8 +170,8 @@ interface ReactPageFinding {
     message: string;
     hint: string;
 }
-type AnyRec$4 = Record<string, unknown>;
-declare function validateReactPages(stack: AnyRec$4): ReactPageFinding[];
+type AnyRec$5 = Record<string, unknown>;
+declare function validateReactPages(stack: AnyRec$5): ReactPageFinding[];
 
 type ReactPropSeverity = 'error' | 'warning';
 interface ReactPropFinding {
@@ -159,8 +182,8 @@ interface ReactPropFinding {
     message: string;
     hint: string;
 }
-type AnyRec$3 = Record<string, unknown>;
-declare function validateReactPageProps(stack: AnyRec$3): ReactPropFinding[];
+type AnyRec$4 = Record<string, unknown>;
+declare function validateReactPageProps(stack: AnyRec$4): ReactPropFinding[];
 
 type SourceStyleSeverity = 'error' | 'warning';
 interface SourceStyleFinding {
@@ -172,8 +195,8 @@ interface SourceStyleFinding {
     hint: string;
 }
 declare const PAGE_SOURCE_CLASSNAME = "page-source-className-tailwind";
-type AnyRec$2 = Record<string, unknown>;
-declare function validatePageSourceStyling(stack: AnyRec$2): SourceStyleFinding[];
+type AnyRec$3 = Record<string, unknown>;
+declare function validatePageSourceStyling(stack: AnyRec$3): SourceStyleFinding[];
 
 /**
  * Build-time record-title diagnostics (ADR-0079).
@@ -217,14 +240,14 @@ interface RecordTitleFinding {
     /** How to fix it. */
     hint: string;
 }
-type AnyRec$1 = Record<string, unknown>;
+type AnyRec$2 = Record<string, unknown>;
 /**
  * Validate every object's record-title declaration. Returns the list of
  * findings (empty = clean). Both rules are advisory (`warning`): the caller
  * must never fail the build on them alone — auto-provision + the `Record #<id>`
  * floor guarantee a resolvable title at runtime.
  */
-declare function validateRecordTitle(stack: AnyRec$1): RecordTitleFinding[];
+declare function validateRecordTitle(stack: AnyRec$2): RecordTitleFinding[];
 
 /**
  * Build-time semantic-role diagnostics (ADR-0085).
@@ -261,12 +284,60 @@ interface SemanticRoleFinding {
     /** How to fix it. */
     hint: string;
 }
-type AnyRec = Record<string, unknown>;
+type AnyRec$1 = Record<string, unknown>;
 /**
  * Validate every object's semantic-role pointers. Returns the list of
  * findings (empty = clean). Advisory only — the caller must never fail the
  * build on these alone.
  */
-declare function validateSemanticRoles(stack: AnyRec): SemanticRoleFinding[];
+declare function validateSemanticRoles(stack: AnyRec$1): SemanticRoleFinding[];
+
+/**
+ * Build-time form-layout diagnostics (#2578).
+ *
+ * Authored form views carry field references and column-layout hints that are
+ * Zod-valid but can be silently wrong at render time — the "parsed, unmarked,
+ * silently inert" shape ADR-0078 prohibits. This lint catches the two that
+ * matter for multi-column, AI-authored forms, uniformly for `os build` /
+ * `os validate`, MCP authoring and hand authors (ADR-0019).
+ *
+ * Both rules are warnings, not errors — nothing is fully broken (an unknown
+ * field name is skipped; an over-wide colSpan is clamped) — but each is almost
+ * certainly an authoring mistake worth surfacing at author time:
+ *
+ * - `form-field-unknown` — a section references a field that is not on the
+ *   form's bound object, so the field silently does not render.
+ * - `absolute-colspan-discouraged` — a field uses the absolute `colSpan`. Under
+ *   a per-surface DERIVED column count (mobile 1 / modal 2 / page 3-4) a fixed
+ *   span only lines up at the one width the author imagined; the renderer
+ *   clamps it. The robust primitive is the relative `span: 'full'`.
+ *
+ * Scope: top-level form `views` (a `sections` array). Forms embedded inside
+ * page component trees are a follow-up — the walker deliberately stays shallow
+ * so it never guesses at an arbitrary component's object binding.
+ */
+declare const FORM_FIELD_UNKNOWN = "form-field-unknown";
+declare const FORM_COLSPAN_ABSOLUTE = "absolute-colspan-discouraged";
+type FormLayoutSeverity = 'error' | 'warning';
+interface FormLayoutFinding {
+    /** Always `warning` today — both rules are advisory (see module note). */
+    severity: FormLayoutSeverity;
+    /** Diagnostic rule id, e.g. `form-field-unknown`. */
+    rule: string;
+    /** Human-readable location, e.g. `view "contract_form"`. */
+    where: string;
+    /** Config path, e.g. `views[2].sections[0].fields[3]`. */
+    path: string;
+    /** What is wrong. */
+    message: string;
+    /** How to fix it. */
+    hint: string;
+}
+type AnyRec = Record<string, unknown>;
+/**
+ * Validate authored form-view layout. Returns findings (empty = clean).
+ * Advisory only — the caller must never fail the build on these alone.
+ */
+declare function validateFormLayout(stack: AnyRec): FormLayoutFinding[];
 
-export { CHART_CONFIG_MISSING, CHART_FIELD_UNKNOWN, type ExprIssue, FIELD_GROUP_EMPTY, FIELD_GROUP_UNDECLARED, type JsxPageFinding, type JsxPageSeverity, MEASURE_AGGREGATE_INCOHERENT, PAGE_SOURCE_CLASSNAME, type ReactPageFinding, type ReactPageSeverity, type ReactPropFinding, type ReactPropSeverity, type RecordTitleFinding, type RecordTitleSeverity, SEMANTIC_ROLE_FIELD_UNKNOWN, STYLE_CLASSNAME_TAILWIND, STYLE_NODE_MISSING_ID, STYLE_RESPONSIVE_NO_BASE, STYLE_UNKNOWN_CSS_PROPERTY, STYLE_UNKNOWN_TOKEN, type SemanticRoleFinding, type SemanticRoleSeverity, type SourceStyleFinding, type SourceStyleSeverity, type StyleFinding, type StyleSeverity, TABLE_COUNT_ONLY, TITLE_FORMAT_RETIRED, TITLE_UNRESOLVABLE, WIDGET_DATASET_UNKNOWN, WIDGET_DIMENSION_UNKNOWN, WIDGET_MEASURE_UNKNOWN, type WidgetBindingFinding, type WidgetBindingSeverity, validateJsxPages, validatePageSourceStyling, validateReactPageProps, validateReactPages, validateRecordTitle, validateResponsiveStyles, validateSemanticRoles, validateStackExpressions, validateWidgetBindings };
+export { CHART_CONFIG_MISSING, CHART_FIELD_UNKNOWN, type ExprIssue, FIELD_GROUP_EMPTY, FIELD_GROUP_UNDECLARED, FORM_COLSPAN_ABSOLUTE, FORM_FIELD_UNKNOWN, type FormLayoutFinding, type FormLayoutSeverity, type JsxPageFinding, type JsxPageSeverity, LIST_VIEW_FILTERS_IN_VIEWS_MODE, type ListViewModeFinding, type ListViewModeSeverity, MEASURE_AGGREGATE_INCOHERENT, PAGE_SOURCE_CLASSNAME, type ReactPageFinding, type ReactPageSeverity, type ReactPropFinding, type ReactPropSeverity, type RecordTitleFinding, type RecordTitleSeverity, SEMANTIC_ROLE_FIELD_UNKNOWN, STYLE_CLASSNAME_TAILWIND, STYLE_NODE_MISSING_ID, STYLE_RESPONSIVE_NO_BASE, STYLE_UNKNOWN_CSS_PROPERTY, STYLE_UNKNOWN_TOKEN, type SemanticRoleFinding, type SemanticRoleSeverity, type SourceStyleFinding, type SourceStyleSeverity, type StyleFinding, type StyleSeverity, TABLE_COUNT_ONLY, TITLE_FORMAT_RETIRED, TITLE_UNRESOLVABLE, WIDGET_DATASET_UNKNOWN, WIDGET_DIMENSION_UNKNOWN, WIDGET_MEASURE_UNKNOWN, type WidgetBindingFinding, type WidgetBindingSeverity, validateFormLayout, validateJsxPages, validateListViewMode, validatePageSourceStyling, validateReactPageProps, validateReactPages, validateRecordTitle, validateResponsiveStyles, validateSemanticRoles, validateStackExpressions, validateWidgetBindings };

package/dist/index.d.ts

@@ -69,7 +69,7 @@ interface WidgetBindingFinding {
     /** How to fix (or deliberately suppress) it. */
     hint: string;
 }
-type AnyRec$8 = Record<string, unknown>;
+type AnyRec$a = Record<string, unknown>;
 /**
  * Validate every dashboard widget's dataset binding. Returns the list of
  * findings (empty = clean). Caller decides how to surface them: `error`
@@ -77,7 +77,7 @@ type AnyRec$8 = Record<string, unknown>;
  * should fail validate/build; `warning` findings are advisory and must
  * never fail the build on their own.
  */
-declare function validateWidgetBindings(stack: AnyRec$8): WidgetBindingFinding[];
+declare function validateWidgetBindings(stack: AnyRec$a): WidgetBindingFinding[];
 
 interface ExprIssue {
     where: string;
@@ -90,12 +90,35 @@ interface ExprIssue {
      */
     severity?: 'error' | 'warning';
 }
-type AnyRec$7 = Record<string, unknown>;
+type AnyRec$9 = Record<string, unknown>;
 /**
  * Validate every predicate in the stack. Returns the list of issues (empty =
  * clean). Caller decides how to surface / whether to fail the build.
  */
-declare function validateStackExpressions(stack: AnyRec$7): ExprIssue[];
+declare function validateStackExpressions(stack: AnyRec$9): ExprIssue[];
+
+type ListViewModeSeverity = 'error' | 'warning';
+interface ListViewModeFinding {
+    severity: ListViewModeSeverity;
+    rule: string;
+    /** Human-readable location, e.g. `object "task" › listViews.my_pending`. */
+    where: string;
+    /** Config path, e.g. `objects[0].listViews.my_pending.userFilters`. */
+    path: string;
+    message: string;
+    hint: string;
+}
+declare const LIST_VIEW_FILTERS_IN_VIEWS_MODE = "list-view-filters-in-views-mode";
+type AnyRec$8 = Record<string, unknown>;
+/**
+ * Flag ADR-0053 "views" mode violations: `userFilters` / `quickFilters` on an
+ * object's built-in named views or a `defineView` default `list` / named
+ * `listViews`. Returns the list of findings (empty = clean). Caller decides how
+ * to surface / whether to fail the build.
+ *
+ * Feed the PRE-parse stack (normalizeStackInput output) — see file header.
+ */
+declare function validateListViewMode(stack: AnyRec$8): ListViewModeFinding[];
 
 type StyleSeverity = 'error' | 'warning';
 interface StyleFinding {
@@ -113,14 +136,14 @@ declare const STYLE_CLASSNAME_TAILWIND = "style-classname-tailwind";
 declare const STYLE_RESPONSIVE_NO_BASE = "style-responsive-no-base";
 declare const STYLE_UNKNOWN_CSS_PROPERTY = "style-unknown-css-property";
 declare const STYLE_UNKNOWN_TOKEN = "style-unknown-token";
-type AnyRec$6 = Record<string, unknown>;
+type AnyRec$7 = Record<string, unknown>;
 /**
  * Validate every page's component tree for SDUI styling correctness (ADR-0065).
  * Returns findings (empty = clean). `error` findings describe styles that are
  * silently dropped and should fail validate/build; `warning` findings are
  * advisory (typos, drift, footguns).
  */
-declare function validateResponsiveStyles(stack: AnyRec$6): StyleFinding[];
+declare function validateResponsiveStyles(stack: AnyRec$7): StyleFinding[];
 
 type JsxPageSeverity = 'error' | 'warning';
 interface JsxPageFinding {
@@ -133,8 +156,8 @@ interface JsxPageFinding {
     message: string;
     hint: string;
 }
-type AnyRec$5 = Record<string, unknown>;
-declare function validateJsxPages(stack: AnyRec$5, opts?: {
+type AnyRec$6 = Record<string, unknown>;
+declare function validateJsxPages(stack: AnyRec$6, opts?: {
     manifest?: Manifest;
 }): JsxPageFinding[];
 
@@ -147,8 +170,8 @@ interface ReactPageFinding {
     message: string;
     hint: string;
 }
-type AnyRec$4 = Record<string, unknown>;
-declare function validateReactPages(stack: AnyRec$4): ReactPageFinding[];
+type AnyRec$5 = Record<string, unknown>;
+declare function validateReactPages(stack: AnyRec$5): ReactPageFinding[];
 
 type ReactPropSeverity = 'error' | 'warning';
 interface ReactPropFinding {
@@ -159,8 +182,8 @@ interface ReactPropFinding {
     message: string;
     hint: string;
 }
-type AnyRec$3 = Record<string, unknown>;
-declare function validateReactPageProps(stack: AnyRec$3): ReactPropFinding[];
+type AnyRec$4 = Record<string, unknown>;
+declare function validateReactPageProps(stack: AnyRec$4): ReactPropFinding[];
 
 type SourceStyleSeverity = 'error' | 'warning';
 interface SourceStyleFinding {
@@ -172,8 +195,8 @@ interface SourceStyleFinding {
     hint: string;
 }
 declare const PAGE_SOURCE_CLASSNAME = "page-source-className-tailwind";
-type AnyRec$2 = Record<string, unknown>;
-declare function validatePageSourceStyling(stack: AnyRec$2): SourceStyleFinding[];
+type AnyRec$3 = Record<string, unknown>;
+declare function validatePageSourceStyling(stack: AnyRec$3): SourceStyleFinding[];
 
 /**
  * Build-time record-title diagnostics (ADR-0079).
@@ -217,14 +240,14 @@ interface RecordTitleFinding {
     /** How to fix it. */
     hint: string;
 }
-type AnyRec$1 = Record<string, unknown>;
+type AnyRec$2 = Record<string, unknown>;
 /**
  * Validate every object's record-title declaration. Returns the list of
  * findings (empty = clean). Both rules are advisory (`warning`): the caller
  * must never fail the build on them alone — auto-provision + the `Record #<id>`
  * floor guarantee a resolvable title at runtime.
  */
-declare function validateRecordTitle(stack: AnyRec$1): RecordTitleFinding[];
+declare function validateRecordTitle(stack: AnyRec$2): RecordTitleFinding[];
 
 /**
  * Build-time semantic-role diagnostics (ADR-0085).
@@ -261,12 +284,60 @@ interface SemanticRoleFinding {
     /** How to fix it. */
     hint: string;
 }
-type AnyRec = Record<string, unknown>;
+type AnyRec$1 = Record<string, unknown>;
 /**
  * Validate every object's semantic-role pointers. Returns the list of
  * findings (empty = clean). Advisory only — the caller must never fail the
  * build on these alone.
  */
-declare function validateSemanticRoles(stack: AnyRec): SemanticRoleFinding[];
+declare function validateSemanticRoles(stack: AnyRec$1): SemanticRoleFinding[];
+
+/**
+ * Build-time form-layout diagnostics (#2578).
+ *
+ * Authored form views carry field references and column-layout hints that are
+ * Zod-valid but can be silently wrong at render time — the "parsed, unmarked,
+ * silently inert" shape ADR-0078 prohibits. This lint catches the two that
+ * matter for multi-column, AI-authored forms, uniformly for `os build` /
+ * `os validate`, MCP authoring and hand authors (ADR-0019).
+ *
+ * Both rules are warnings, not errors — nothing is fully broken (an unknown
+ * field name is skipped; an over-wide colSpan is clamped) — but each is almost
+ * certainly an authoring mistake worth surfacing at author time:
+ *
+ * - `form-field-unknown` — a section references a field that is not on the
+ *   form's bound object, so the field silently does not render.
+ * - `absolute-colspan-discouraged` — a field uses the absolute `colSpan`. Under
+ *   a per-surface DERIVED column count (mobile 1 / modal 2 / page 3-4) a fixed
+ *   span only lines up at the one width the author imagined; the renderer
+ *   clamps it. The robust primitive is the relative `span: 'full'`.
+ *
+ * Scope: top-level form `views` (a `sections` array). Forms embedded inside
+ * page component trees are a follow-up — the walker deliberately stays shallow
+ * so it never guesses at an arbitrary component's object binding.
+ */
+declare const FORM_FIELD_UNKNOWN = "form-field-unknown";
+declare const FORM_COLSPAN_ABSOLUTE = "absolute-colspan-discouraged";
+type FormLayoutSeverity = 'error' | 'warning';
+interface FormLayoutFinding {
+    /** Always `warning` today — both rules are advisory (see module note). */
+    severity: FormLayoutSeverity;
+    /** Diagnostic rule id, e.g. `form-field-unknown`. */
+    rule: string;
+    /** Human-readable location, e.g. `view "contract_form"`. */
+    where: string;
+    /** Config path, e.g. `views[2].sections[0].fields[3]`. */
+    path: string;
+    /** What is wrong. */
+    message: string;
+    /** How to fix it. */
+    hint: string;
+}
+type AnyRec = Record<string, unknown>;
+/**
+ * Validate authored form-view layout. Returns findings (empty = clean).
+ * Advisory only — the caller must never fail the build on these alone.
+ */
+declare function validateFormLayout(stack: AnyRec): FormLayoutFinding[];
 
-export { CHART_CONFIG_MISSING, CHART_FIELD_UNKNOWN, type ExprIssue, FIELD_GROUP_EMPTY, FIELD_GROUP_UNDECLARED, type JsxPageFinding, type JsxPageSeverity, MEASURE_AGGREGATE_INCOHERENT, PAGE_SOURCE_CLASSNAME, type ReactPageFinding, type ReactPageSeverity, type ReactPropFinding, type ReactPropSeverity, type RecordTitleFinding, type RecordTitleSeverity, SEMANTIC_ROLE_FIELD_UNKNOWN, STYLE_CLASSNAME_TAILWIND, STYLE_NODE_MISSING_ID, STYLE_RESPONSIVE_NO_BASE, STYLE_UNKNOWN_CSS_PROPERTY, STYLE_UNKNOWN_TOKEN, type SemanticRoleFinding, type SemanticRoleSeverity, type SourceStyleFinding, type SourceStyleSeverity, type StyleFinding, type StyleSeverity, TABLE_COUNT_ONLY, TITLE_FORMAT_RETIRED, TITLE_UNRESOLVABLE, WIDGET_DATASET_UNKNOWN, WIDGET_DIMENSION_UNKNOWN, WIDGET_MEASURE_UNKNOWN, type WidgetBindingFinding, type WidgetBindingSeverity, validateJsxPages, validatePageSourceStyling, validateReactPageProps, validateReactPages, validateRecordTitle, validateResponsiveStyles, validateSemanticRoles, validateStackExpressions, validateWidgetBindings };
+export { CHART_CONFIG_MISSING, CHART_FIELD_UNKNOWN, type ExprIssue, FIELD_GROUP_EMPTY, FIELD_GROUP_UNDECLARED, FORM_COLSPAN_ABSOLUTE, FORM_FIELD_UNKNOWN, type FormLayoutFinding, type FormLayoutSeverity, type JsxPageFinding, type JsxPageSeverity, LIST_VIEW_FILTERS_IN_VIEWS_MODE, type ListViewModeFinding, type ListViewModeSeverity, MEASURE_AGGREGATE_INCOHERENT, PAGE_SOURCE_CLASSNAME, type ReactPageFinding, type ReactPageSeverity, type ReactPropFinding, type ReactPropSeverity, type RecordTitleFinding, type RecordTitleSeverity, SEMANTIC_ROLE_FIELD_UNKNOWN, STYLE_CLASSNAME_TAILWIND, STYLE_NODE_MISSING_ID, STYLE_RESPONSIVE_NO_BASE, STYLE_UNKNOWN_CSS_PROPERTY, STYLE_UNKNOWN_TOKEN, type SemanticRoleFinding, type SemanticRoleSeverity, type SourceStyleFinding, type SourceStyleSeverity, type StyleFinding, type StyleSeverity, TABLE_COUNT_ONLY, TITLE_FORMAT_RETIRED, TITLE_UNRESOLVABLE, WIDGET_DATASET_UNKNOWN, WIDGET_DIMENSION_UNKNOWN, WIDGET_MEASURE_UNKNOWN, type WidgetBindingFinding, type WidgetBindingSeverity, validateFormLayout, validateJsxPages, validateListViewMode, validatePageSourceStyling, validateReactPageProps, validateReactPages, validateRecordTitle, validateResponsiveStyles, validateSemanticRoles, validateStackExpressions, validateWidgetBindings };

package/dist/index.js

@@ -371,6 +371,60 @@ function validateStackExpressions(stack) {
   return issues;
 }
 
+// src/validate-list-view-mode.ts
+var LIST_VIEW_FILTERS_IN_VIEWS_MODE = "list-view-filters-in-views-mode";
+var FORBIDDEN_FIELDS = ["userFilters", "quickFilters"];
+function asArray3(v) {
+  if (Array.isArray(v)) return v;
+  if (v && typeof v === "object") {
+    return Object.entries(v).map(([name, def]) => ({
+      name,
+      ...def
+    }));
+  }
+  return [];
+}
+function scanView(view, where, path, out) {
+  if (!view || typeof view !== "object") return;
+  const rec = view;
+  for (const field of FORBIDDEN_FIELDS) {
+    if (rec[field] == null) continue;
+    out.push({
+      severity: "error",
+      rule: LIST_VIEW_FILTERS_IN_VIEWS_MODE,
+      where,
+      path: `${path}.${field}`,
+      message: `\`${field}\` is a page filters-mode control and is ignored on an object list view ("views" mode) \u2014 the ViewTabBar is the only nav control here.`,
+      hint: `Move \`${field}\` to a page list (InterfaceListPage, "filters" mode), or remove it. See ADR-0053.`
+    });
+  }
+}
+function scanListViews(listViews, wherePrefix, pathPrefix, out) {
+  if (!listViews || typeof listViews !== "object") return;
+  for (const [name, view] of Object.entries(listViews)) {
+    scanView(
+      view,
+      `${wherePrefix} \u203A listViews.${name}`,
+      `${pathPrefix}.listViews.${name}`,
+      out
+    );
+  }
+}
+function validateListViewMode(stack) {
+  const out = [];
+  asArray3(stack.objects).forEach((obj, i) => {
+    const label = typeof obj.name === "string" ? `object "${obj.name}"` : `objects[${i}]`;
+    scanListViews(obj.listViews, label, `objects[${i}]`, out);
+  });
+  asArray3(stack.views).forEach((view, i) => {
+    const named = typeof view.objectName === "string" ? view.objectName : typeof view.name === "string" ? view.name : void 0;
+    const label = named ? `view "${named}"` : `views[${i}]`;
+    scanView(view.list, `${label} \u203A list`, `views[${i}].list`, out);
+    scanListViews(view.listViews, label, `views[${i}]`, out);
+  });
+  return out;
+}
+
 // src/validate-responsive-styles.ts
 var STYLE_NODE_MISSING_ID = "style-node-missing-id";
 var STYLE_CLASSNAME_TAILWIND = "style-classname-tailwind";
@@ -574,7 +628,7 @@ function looksLikeTailwind(className) {
     return false;
   });
 }
-function asArray3(v) {
+function asArray4(v) {
   if (Array.isArray(v)) return v;
   if (v && typeof v === "object") {
     return Object.entries(v).map(([name, def]) => ({ name, ...def }));
@@ -667,13 +721,13 @@ function checkNode(node, pageName, path, findings) {
 }
 function validateResponsiveStyles(stack) {
   const findings = [];
-  const pages = asArray3(stack.pages);
+  const pages = asArray4(stack.pages);
   for (let p = 0; p < pages.length; p++) {
     const page = pages[p];
     const pageName = typeof page.name === "string" ? page.name : `pages[${p}]`;
-    const regions = asArray3(page.regions);
+    const regions = asArray4(page.regions);
     for (let r = 0; r < regions.length; r++) {
-      const components = asArray3(regions[r].components);
+      const components = asArray4(regions[r].components);
       for (let c = 0; c < components.length; c++) {
         checkNode(components[c], pageName, `pages[${p}].regions[${r}].components[${c}]`, findings);
       }
@@ -684,10 +738,10 @@ function validateResponsiveStyles(stack) {
 
 // src/validate-jsx-pages.ts
 import { parseJsx, compile } from "@objectstack/sdui-parser";
-var asArray4 = (v) => Array.isArray(v) ? v : [];
+var asArray5 = (v) => Array.isArray(v) ? v : [];
 function validateJsxPages(stack, opts = {}) {
   const findings = [];
-  const pages = asArray4(stack.pages);
+  const pages = asArray5(stack.pages);
   for (let p = 0; p < pages.length; p++) {
     const page = pages[p];
     if (!page || page.kind !== "html" && page.kind !== "jsx") continue;
@@ -734,10 +788,10 @@ function loadSucraseTransform() {
   }
   return cachedTransform;
 }
-var asArray5 = (v) => Array.isArray(v) ? v : [];
+var asArray6 = (v) => Array.isArray(v) ? v : [];
 function validateReactPages(stack) {
   const findings = [];
-  const pages = asArray5(stack.pages);
+  const pages = asArray6(stack.pages);
   for (let p = 0; p < pages.length; p++) {
     const page = pages[p];
     if (!page || page.kind !== "react") continue;
@@ -788,7 +842,7 @@ function loadTypeScript() {
   }
   return cachedTs;
 }
-var asArray6 = (v) => Array.isArray(v) ? v : [];
+var asArray7 = (v) => Array.isArray(v) ? v : [];
 var BLOCKS = new Map(
   REACT_BLOCKS.map((b) => [
     b.tag,
@@ -827,7 +881,7 @@ function nearestKnown(prop, known) {
 }
 function validateReactPageProps(stack) {
   const findings = [];
-  const pages = asArray6(stack.pages);
+  const pages = asArray7(stack.pages);
   for (let p = 0; p < pages.length; p++) {
     const page = pages[p];
     if (!page || page.kind !== "react") continue;
@@ -895,11 +949,11 @@ function validateReactPageProps(stack) {
 
 // src/validate-page-source-styling.ts
 var PAGE_SOURCE_CLASSNAME = "page-source-className-tailwind";
-var asArray7 = (v) => Array.isArray(v) ? v : [];
+var asArray8 = (v) => Array.isArray(v) ? v : [];
 var CLASSNAME_ATTR = /\bclassName\s*=\s*["'{]/g;
 function validatePageSourceStyling(stack) {
   const findings = [];
-  const pages = asArray7(stack.pages);
+  const pages = asArray8(stack.pages);
   for (let p = 0; p < pages.length; p++) {
     const page = pages[p];
     if (!page) continue;
@@ -928,7 +982,7 @@ function validatePageSourceStyling(stack) {
 import { objectTitleCompleteness } from "@objectstack/spec/data";
 var TITLE_FORMAT_RETIRED = "title-format-retired";
 var TITLE_UNRESOLVABLE = "title-unresolvable";
-function asArray8(v) {
+function asArray9(v) {
   if (Array.isArray(v)) return v;
   if (v && typeof v === "object") {
     return Object.entries(v).map(([name, def]) => ({ name, ...def }));
@@ -937,7 +991,7 @@ function asArray8(v) {
 }
 function validateRecordTitle(stack) {
   const findings = [];
-  const objects = asArray8(stack.objects);
+  const objects = asArray9(stack.objects);
   for (let i = 0; i < objects.length; i++) {
     const obj = objects[i];
     const objName = typeof obj.name === "string" ? obj.name : `(object ${i})`;
@@ -972,7 +1026,7 @@ function validateRecordTitle(stack) {
 var FIELD_GROUP_UNDECLARED = "field-group-undeclared";
 var FIELD_GROUP_EMPTY = "field-group-empty";
 var SEMANTIC_ROLE_FIELD_UNKNOWN = "semantic-role-field-unknown";
-function asArray9(v) {
+function asArray10(v) {
   if (Array.isArray(v)) return v;
   if (v && typeof v === "object") {
     return Object.entries(v).map(([name, def]) => ({ name, ...def }));
@@ -981,7 +1035,7 @@ function asArray9(v) {
 }
 function validateSemanticRoles(stack) {
   const findings = [];
-  const objects = asArray9(stack.objects);
+  const objects = asArray10(stack.objects);
   for (let i = 0; i < objects.length; i++) {
     const obj = objects[i];
     if (!obj || typeof obj !== "object") continue;
@@ -1047,11 +1101,93 @@ function validateSemanticRoles(stack) {
   }
   return findings;
 }
+
+// src/validate-form-layout.ts
+var FORM_FIELD_UNKNOWN = "form-field-unknown";
+var FORM_COLSPAN_ABSOLUTE = "absolute-colspan-discouraged";
+function asArray11(v) {
+  if (Array.isArray(v)) return v;
+  if (v && typeof v === "object") {
+    return Object.entries(v).map(([name, def]) => ({ name, ...def }));
+  }
+  return [];
+}
+function fieldNameOf(entry) {
+  if (typeof entry === "string") return entry.length > 0 ? entry : null;
+  if (entry && typeof entry === "object" && !Array.isArray(entry)) {
+    const f = entry.field;
+    return typeof f === "string" && f.length > 0 ? f : null;
+  }
+  return null;
+}
+function boundObject(view) {
+  const data = view.data;
+  if (data && typeof data === "object" && typeof data.object === "string") {
+    return data.object;
+  }
+  return typeof view.objectName === "string" ? view.objectName : void 0;
+}
+function validateFormLayout(stack) {
+  const findings = [];
+  const objectFields = /* @__PURE__ */ new Map();
+  for (const obj of asArray11(stack.objects)) {
+    const name = typeof obj.name === "string" ? obj.name : void 0;
+    if (!name) continue;
+    const fields = obj.fields && typeof obj.fields === "object" && !Array.isArray(obj.fields) ? Object.keys(obj.fields) : [];
+    objectFields.set(name, new Set(fields));
+  }
+  const views = asArray11(stack.views);
+  for (let i = 0; i < views.length; i++) {
+    const view = views[i];
+    if (!view || typeof view !== "object") continue;
+    const sections = Array.isArray(view.sections) ? view.sections : null;
+    if (!sections) continue;
+    const viewName = typeof view.name === "string" ? view.name : `(view ${i})`;
+    const objName = boundObject(view);
+    const known = objName ? objectFields.get(objName) : void 0;
+    const where = `view "${viewName}"`;
+    const base = `views[${i}]`;
+    for (let s = 0; s < sections.length; s++) {
+      const sec = sections[s];
+      const secFields = sec && typeof sec === "object" && Array.isArray(sec.fields) ? sec.fields : [];
+      for (let f = 0; f < secFields.length; f++) {
+        const entry = secFields[f];
+        const fname = fieldNameOf(entry);
+        const fpath = `${base}.sections[${s}].fields[${f}]`;
+        if (fname && known && !known.has(fname)) {
+          findings.push({
+            severity: "warning",
+            rule: FORM_FIELD_UNKNOWN,
+            where,
+            path: fpath,
+            message: `${viewName}: field "${fname}" is not a field on object "${objName}" \u2014 it is silently skipped and never renders on the form`,
+            hint: `Fix the field name, or add "${fname}" to ${objName}. Section field references must match the object's field names exactly.`
+          });
+        }
+        const colSpan = entry && typeof entry === "object" && !Array.isArray(entry) ? entry.colSpan : void 0;
+        if (colSpan != null) {
+          findings.push({
+            severity: "warning",
+            rule: FORM_COLSPAN_ABSOLUTE,
+            where,
+            path: `${fpath}.colSpan`,
+            message: `${viewName}: field "${fname ?? "?"}" sets absolute colSpan ${String(colSpan)} \u2014 the form's column count is derived per surface (mobile 1 / modal 2 / page 3-4), so a fixed span only aligns at one width`,
+            hint: `Prefer span: 'full' (whole row at any column count), or omit for auto width. The renderer clamps colSpan to the current column count.`
+          });
+        }
+      }
+    }
+  }
+  return findings;
+}
 export {
   CHART_CONFIG_MISSING,
   CHART_FIELD_UNKNOWN,
   FIELD_GROUP_EMPTY,
   FIELD_GROUP_UNDECLARED,
+  FORM_COLSPAN_ABSOLUTE,
+  FORM_FIELD_UNKNOWN,
+  LIST_VIEW_FILTERS_IN_VIEWS_MODE,
   MEASURE_AGGREGATE_INCOHERENT,
   PAGE_SOURCE_CLASSNAME,
   SEMANTIC_ROLE_FIELD_UNKNOWN,
@@ -1066,7 +1202,9 @@ export {
   WIDGET_DATASET_UNKNOWN,
   WIDGET_DIMENSION_UNKNOWN,
   WIDGET_MEASURE_UNKNOWN,
+  validateFormLayout,
   validateJsxPages,
+  validateListViewMode,
   validatePageSourceStyling,
   validateReactPageProps,
   validateReactPages,