@objectstack/lint 10.2.0 → 10.3.0

package/dist/index.d.cts

@@ -67,7 +67,7 @@ interface WidgetBindingFinding {
     /** How to fix (or deliberately suppress) it. */
     hint: string;
 }
-type AnyRec$1 = Record<string, unknown>;
+type AnyRec$2 = Record<string, unknown>;
 /**
  * Validate every dashboard widget's dataset binding. Returns the list of
  * findings (empty = clean). Caller decides how to surface them: `error`
@@ -75,7 +75,7 @@ type AnyRec$1 = 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$1): WidgetBindingFinding[];
+declare function validateWidgetBindings(stack: AnyRec$2): WidgetBindingFinding[];
 
 interface ExprIssue {
     where: string;
@@ -88,11 +88,36 @@ interface ExprIssue {
      */
     severity?: 'error' | 'warning';
 }
-type AnyRec = Record<string, unknown>;
+type AnyRec$1 = 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): ExprIssue[];
+declare function validateStackExpressions(stack: AnyRec$1): ExprIssue[];
+
+type StyleSeverity = 'error' | 'warning';
+interface StyleFinding {
+    severity: StyleSeverity;
+    rule: string;
+    /** Human-readable location, e.g. `page "pricing" › node "plan_solo"`. */
+    where: string;
+    /** Config path, e.g. `pages[0].regions[0].components[1]`. */
+    path: string;
+    message: string;
+    hint: string;
+}
+declare const STYLE_NODE_MISSING_ID = "style-node-missing-id";
+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 = 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): StyleFinding[];
 
-export { CHART_CONFIG_MISSING, CHART_FIELD_UNKNOWN, type ExprIssue, MEASURE_AGGREGATE_INCOHERENT, TABLE_COUNT_ONLY, WIDGET_DATASET_UNKNOWN, WIDGET_DIMENSION_UNKNOWN, WIDGET_MEASURE_UNKNOWN, type WidgetBindingFinding, type WidgetBindingSeverity, validateStackExpressions, validateWidgetBindings };
+export { CHART_CONFIG_MISSING, CHART_FIELD_UNKNOWN, type ExprIssue, MEASURE_AGGREGATE_INCOHERENT, STYLE_CLASSNAME_TAILWIND, STYLE_NODE_MISSING_ID, STYLE_RESPONSIVE_NO_BASE, STYLE_UNKNOWN_CSS_PROPERTY, STYLE_UNKNOWN_TOKEN, type StyleFinding, type StyleSeverity, TABLE_COUNT_ONLY, WIDGET_DATASET_UNKNOWN, WIDGET_DIMENSION_UNKNOWN, WIDGET_MEASURE_UNKNOWN, type WidgetBindingFinding, type WidgetBindingSeverity, validateResponsiveStyles, validateStackExpressions, validateWidgetBindings };

package/dist/index.d.ts

@@ -67,7 +67,7 @@ interface WidgetBindingFinding {
     /** How to fix (or deliberately suppress) it. */
     hint: string;
 }
-type AnyRec$1 = Record<string, unknown>;
+type AnyRec$2 = Record<string, unknown>;
 /**
  * Validate every dashboard widget's dataset binding. Returns the list of
  * findings (empty = clean). Caller decides how to surface them: `error`
@@ -75,7 +75,7 @@ type AnyRec$1 = 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$1): WidgetBindingFinding[];
+declare function validateWidgetBindings(stack: AnyRec$2): WidgetBindingFinding[];
 
 interface ExprIssue {
     where: string;
@@ -88,11 +88,36 @@ interface ExprIssue {
      */
     severity?: 'error' | 'warning';
 }
-type AnyRec = Record<string, unknown>;
+type AnyRec$1 = 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): ExprIssue[];
+declare function validateStackExpressions(stack: AnyRec$1): ExprIssue[];
+
+type StyleSeverity = 'error' | 'warning';
+interface StyleFinding {
+    severity: StyleSeverity;
+    rule: string;
+    /** Human-readable location, e.g. `page "pricing" › node "plan_solo"`. */
+    where: string;
+    /** Config path, e.g. `pages[0].regions[0].components[1]`. */
+    path: string;
+    message: string;
+    hint: string;
+}
+declare const STYLE_NODE_MISSING_ID = "style-node-missing-id";
+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 = 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): StyleFinding[];
 
-export { CHART_CONFIG_MISSING, CHART_FIELD_UNKNOWN, type ExprIssue, MEASURE_AGGREGATE_INCOHERENT, TABLE_COUNT_ONLY, WIDGET_DATASET_UNKNOWN, WIDGET_DIMENSION_UNKNOWN, WIDGET_MEASURE_UNKNOWN, type WidgetBindingFinding, type WidgetBindingSeverity, validateStackExpressions, validateWidgetBindings };
+export { CHART_CONFIG_MISSING, CHART_FIELD_UNKNOWN, type ExprIssue, MEASURE_AGGREGATE_INCOHERENT, STYLE_CLASSNAME_TAILWIND, STYLE_NODE_MISSING_ID, STYLE_RESPONSIVE_NO_BASE, STYLE_UNKNOWN_CSS_PROPERTY, STYLE_UNKNOWN_TOKEN, type StyleFinding, type StyleSeverity, TABLE_COUNT_ONLY, WIDGET_DATASET_UNKNOWN, WIDGET_DIMENSION_UNKNOWN, WIDGET_MEASURE_UNKNOWN, type WidgetBindingFinding, type WidgetBindingSeverity, validateResponsiveStyles, validateStackExpressions, validateWidgetBindings };

package/dist/index.js

@@ -370,14 +370,331 @@ function validateStackExpressions(stack) {
   }
   return issues;
 }
+
+// src/validate-responsive-styles.ts
+var STYLE_NODE_MISSING_ID = "style-node-missing-id";
+var STYLE_CLASSNAME_TAILWIND = "style-classname-tailwind";
+var STYLE_RESPONSIVE_NO_BASE = "style-responsive-no-base";
+var STYLE_UNKNOWN_CSS_PROPERTY = "style-unknown-css-property";
+var STYLE_UNKNOWN_TOKEN = "style-unknown-token";
+var BREAKPOINTS = ["large", "medium", "small", "xsmall"];
+var KNOWN_TOKENS = /* @__PURE__ */ new Set([
+  // SDUI tokens
+  "space-1",
+  "space-2",
+  "space-3",
+  "space-4",
+  "space-5",
+  "space-6",
+  "space-8",
+  "space-10",
+  "space-12",
+  "radius",
+  "radius-sm",
+  "radius-md",
+  "radius-lg",
+  "radius-xl",
+  "shadow-sm",
+  "shadow-md",
+  "shadow-lg",
+  "surface",
+  "surface-sunken",
+  "text-strong",
+  "text-muted",
+  "brand",
+  "brand-foreground",
+  "hairline",
+  // Base theme tokens (shadcn) — usually wrapped as hsl(var(--x)).
+  "background",
+  "foreground",
+  "card",
+  "card-foreground",
+  "popover",
+  "popover-foreground",
+  "primary",
+  "primary-foreground",
+  "secondary",
+  "secondary-foreground",
+  "muted",
+  "muted-foreground",
+  "accent",
+  "accent-foreground",
+  "destructive",
+  "destructive-foreground",
+  "border",
+  "input",
+  "ring",
+  "success",
+  "success-foreground",
+  "warning",
+  "warning-foreground",
+  "chart-1",
+  "chart-2",
+  "chart-3",
+  "chart-4",
+  "chart-5"
+]);
+var KNOWN_CSS_PROPERTIES = /* @__PURE__ */ new Set([
+  "display",
+  "position",
+  "top",
+  "right",
+  "bottom",
+  "left",
+  "inset",
+  "zIndex",
+  "overflow",
+  "overflowX",
+  "overflowY",
+  "visibility",
+  "boxSizing",
+  "float",
+  "clear",
+  "width",
+  "height",
+  "minWidth",
+  "minHeight",
+  "maxWidth",
+  "maxHeight",
+  "aspectRatio",
+  "margin",
+  "marginTop",
+  "marginRight",
+  "marginBottom",
+  "marginLeft",
+  "marginInline",
+  "marginBlock",
+  "padding",
+  "paddingTop",
+  "paddingRight",
+  "paddingBottom",
+  "paddingLeft",
+  "paddingInline",
+  "paddingBlock",
+  "flex",
+  "flexDirection",
+  "flexWrap",
+  "flexGrow",
+  "flexShrink",
+  "flexBasis",
+  "alignItems",
+  "alignContent",
+  "alignSelf",
+  "justifyContent",
+  "justifyItems",
+  "justifySelf",
+  "gap",
+  "rowGap",
+  "columnGap",
+  "order",
+  "placeItems",
+  "placeContent",
+  "grid",
+  "gridTemplate",
+  "gridTemplateColumns",
+  "gridTemplateRows",
+  "gridTemplateAreas",
+  "gridColumn",
+  "gridRow",
+  "gridArea",
+  "gridAutoFlow",
+  "gridAutoColumns",
+  "gridAutoRows",
+  "color",
+  "backgroundColor",
+  "background",
+  "backgroundImage",
+  "backgroundSize",
+  "backgroundPosition",
+  "backgroundRepeat",
+  "backgroundClip",
+  "opacity",
+  "mixBlendMode",
+  "fontSize",
+  "fontWeight",
+  "fontFamily",
+  "fontStyle",
+  "lineHeight",
+  "letterSpacing",
+  "textAlign",
+  "textTransform",
+  "textDecoration",
+  "textOverflow",
+  "whiteSpace",
+  "wordBreak",
+  "overflowWrap",
+  "fontVariantNumeric",
+  "verticalAlign",
+  "textShadow",
+  "border",
+  "borderTop",
+  "borderRight",
+  "borderBottom",
+  "borderLeft",
+  "borderColor",
+  "borderWidth",
+  "borderStyle",
+  "borderRadius",
+  "borderTopLeftRadius",
+  "borderTopRightRadius",
+  "borderBottomLeftRadius",
+  "borderBottomRightRadius",
+  "outline",
+  "outlineOffset",
+  "boxShadow",
+  "transform",
+  "transformOrigin",
+  "transition",
+  "transitionProperty",
+  "transitionDuration",
+  "transitionTimingFunction",
+  "transitionDelay",
+  "animation",
+  "filter",
+  "backdropFilter",
+  "willChange",
+  "cursor",
+  "pointerEvents",
+  "userSelect",
+  "objectFit",
+  "objectPosition",
+  "content"
+]);
+var VAR_RE = /var\(\s*--([a-zA-Z0-9-]+)\s*[,)]/g;
+var TW_VARIANT = /^(sm|md|lg|xl|2xl|hover|focus|active|disabled|dark|group-hover|peer-[a-z]+|first|last|odd|even):/;
+var TW_STEM_VALUE = /^-?(p|m|px|py|pt|pb|pl|pr|mx|my|mt|mb|ml|mr|gap|gap-x|gap-y|space-x|space-y|w|h|min-w|max-w|min-h|max-h|size|text|leading|tracking|bg|border|rounded|shadow|ring|opacity|inset|top|bottom|left|right|z|order|col|row|grid-cols|grid-rows|basis)-(\d+(\.\d+)?|\d+\/\d+|px|full|auto|none|screen|min|max|fit|xs|sm|md|lg|xl|2xl|3xl|4xl|5xl|6xl)$/;
+var TW_BARE = /^(flex|grid|block|inline|inline-block|inline-flex|hidden|contents|table|flow-root|grow|shrink|truncate|italic|underline|uppercase|lowercase|capitalize|antialiased|absolute|relative|fixed|sticky|static|isolate|flex-col|flex-row|flex-wrap|flex-nowrap|items-center|items-start|items-end|items-stretch|justify-center|justify-between|justify-around|justify-start|justify-end|text-center|text-left|text-right|font-bold|font-semibold|font-medium|font-normal|tabular-nums)$/;
+function looksLikeTailwind(className) {
+  return className.split(/\s+/).some((tok) => {
+    if (!tok) return false;
+    if (TW_VARIANT.test(tok)) return true;
+    if (/\[[^\]]+\]/.test(tok)) return true;
+    if (TW_STEM_VALUE.test(tok)) return true;
+    if (TW_BARE.test(tok)) return true;
+    return false;
+  });
+}
+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 childrenOf(node) {
+  const props = node.properties ?? {};
+  const out = [];
+  for (const c of [node.children, props.children, node.body, props.body]) {
+    if (Array.isArray(c)) out.push(...c.filter((x) => x && typeof x === "object"));
+  }
+  return out;
+}
+function checkNode(node, pageName, path, findings) {
+  const id = typeof node.id === "string" ? node.id : void 0;
+  const type = typeof node.type === "string" ? node.type : "node";
+  const where = `page "${pageName}" \u203A ${id ? `node "${id}"` : `<${type}>`}`;
+  const rs = node.responsiveStyles;
+  const hasRs = !!rs && typeof rs === "object" && BREAKPOINTS.some((b) => rs[b]);
+  if (hasRs && !id) {
+    findings.push({
+      severity: "error",
+      rule: STYLE_NODE_MISSING_ID,
+      where,
+      path,
+      message: `Node has responsiveStyles but no \`id\`; scoped CSS cannot be generated and the styles are silently dropped.`,
+      hint: `Add a stable \`id\` to this node.`
+    });
+  }
+  if (hasRs && !rs.large && BREAKPOINTS.slice(1).some((b) => rs[b])) {
+    findings.push({
+      severity: "warning",
+      rule: STYLE_RESPONSIVE_NO_BASE,
+      where,
+      path,
+      message: `responsiveStyles sets a smaller breakpoint but no \`large\` base; the node is unstyled at desktop width.`,
+      hint: `Put the unconditional/base styles under \`responsiveStyles.large\` (desktop-first).`
+    });
+  }
+  if (typeof node.className === "string" && node.className.trim() && looksLikeTailwind(node.className)) {
+    findings.push({
+      severity: "warning",
+      rule: STYLE_CLASSNAME_TAILWIND,
+      where,
+      path,
+      message: `\`className\` contains Tailwind-looking utilities ("${node.className.trim().slice(0, 60)}"); these are not compiled from metadata and will silently do nothing.`,
+      hint: `Style this node with \`responsiveStyles\` + design tokens instead of \`className\` (ADR-0065).`
+    });
+  }
+  if (rs && typeof rs === "object") {
+    for (const bp of BREAKPOINTS) {
+      const map = rs[bp];
+      if (!map || typeof map !== "object") continue;
+      for (const [prop, value] of Object.entries(map)) {
+        if (!prop.startsWith("--") && !KNOWN_CSS_PROPERTIES.has(prop)) {
+          findings.push({
+            severity: "warning",
+            rule: STYLE_UNKNOWN_CSS_PROPERTY,
+            where,
+            path: `${path}.responsiveStyles.${bp}`,
+            message: `Unknown CSS property "${prop}" (typo?); if unintended it will not apply.`,
+            hint: `Use a camelCase CSS property name (e.g. \`flexDirection\`, \`backgroundColor\`).`
+          });
+        }
+        if (typeof value === "string") {
+          let m;
+          VAR_RE.lastIndex = 0;
+          while (m = VAR_RE.exec(value)) {
+            const token = m[1];
+            if (!KNOWN_TOKENS.has(token) && !token.startsWith("tw-")) {
+              findings.push({
+                severity: "warning",
+                rule: STYLE_UNKNOWN_TOKEN,
+                where,
+                path: `${path}.responsiveStyles.${bp}.${prop}`,
+                message: `References unknown design token \`var(--${token})\` (typo?); it will not resolve.`,
+                hint: `Use a token from the ADR-0065 palette (e.g. \`var(--space-6)\`, \`var(--surface)\`, \`hsl(var(--primary))\`).`
+              });
+            }
+          }
+        }
+      }
+    }
+  }
+  const kids = childrenOf(node);
+  for (let i = 0; i < kids.length; i++) {
+    checkNode(kids[i], pageName, `${path}.children[${i}]`, findings);
+  }
+}
+function validateResponsiveStyles(stack) {
+  const findings = [];
+  const pages = asArray3(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);
+    for (let r = 0; r < regions.length; r++) {
+      const components = asArray3(regions[r].components);
+      for (let c = 0; c < components.length; c++) {
+        checkNode(components[c], pageName, `pages[${p}].regions[${r}].components[${c}]`, findings);
+      }
+    }
+  }
+  return findings;
+}
 export {
   CHART_CONFIG_MISSING,
   CHART_FIELD_UNKNOWN,
   MEASURE_AGGREGATE_INCOHERENT,
+  STYLE_CLASSNAME_TAILWIND,
+  STYLE_NODE_MISSING_ID,
+  STYLE_RESPONSIVE_NO_BASE,
+  STYLE_UNKNOWN_CSS_PROPERTY,
+  STYLE_UNKNOWN_TOKEN,
   TABLE_COUNT_ONLY,
   WIDGET_DATASET_UNKNOWN,
   WIDGET_DIMENSION_UNKNOWN,
   WIDGET_MEASURE_UNKNOWN,
+  validateResponsiveStyles,
   validateStackExpressions,
   validateWidgetBindings
 };