@objectstack/lint 11.9.0 → 12.0.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 };