refactor: extract @hyperframes/lint from core (#1756)

* refactor: extract @hyperframes/lint package from core Moves all lint rules, hyperframeLinter, lintProject, and related types from packages/core/src/lint/ into a new standalone packages/lint package. Core keeps a thin re-export stub at @hyperframes/core/lint for backward compatibility. Consumer imports (cli lint command, producer hyperframeLint) are updated to import from @hyperframes/lint directly. Depends on @hyperframes/parsers (PR #1755). * fix: restore postcss-selector-parser in core (sourceMutation.ts still uses it) * fix(ci): add parsers+lint to Dockerfile and build before preview tests * chore: update bun.lock after restoring postcss-selector-parser dep * test(cli): update lintProject test for string-dir signature from @hyperframes/lint * refactor(core): single-source the lint engine in @hyperframes/lint Delete core's byte-identical copy of the lint rule engine and re-point staticGuard at @hyperframes/lint, so the render-time render-gate and the studio preview share one rule engine instead of two copies that could silently diverge. Back-compat preserved via the @hyperframes/core/lint stub. Addresses review feedback on the dual-copy footgun.
2026-09-12 07:09:59 +00:00 · 2026-06-27 01:16:40 -04:00
parent cdf9c817e1
commit 98d0bdd73c
53 changed files with 745 additions and 656 deletions
@@ -0,0 +1,66 @@
+import type { HyperframeLintFinding, HyperframeLinterOptions } from "./types";
+import {
+  extractBlocks,
+  extractOpenTags,
+  findRootTag,
+  collectCompositionIds,
+  readAttr,
+  stripHtmlComments,
+  STYLE_BLOCK_PATTERN,
+  SCRIPT_BLOCK_PATTERN,
+} from "./utils";
+import type { OpenTag, ExtractedBlock } from "./utils";
+
+export type { OpenTag, ExtractedBlock };
+
+export type LintContext = {
+  source: string;
+  rawSource: string;
+  tags: OpenTag[];
+  styles: ExtractedBlock[];
+  scripts: ExtractedBlock[];
+  compositionIds: Set<string>;
+  rootTag: OpenTag | null;
+  rootCompositionId: string | null;
+  options: HyperframeLinterOptions;
+};
+
+// Re-export for convenience so rule modules only need one import for the finding type
+export type { HyperframeLintFinding };
+
+export function buildLintContext(html: string, options: HyperframeLinterOptions = {}): LintContext {
+  const rawSource = html || "";
+  // Strip HTML comments before scanning so a commented-out <template> or tag can't
+  // hijack the boundary match below. Linear + fixpoint (see stripHtmlComments) to
+  // stay ReDoS-free and catch markers that re-form when a comment is removed.
+  let source = stripHtmlComments(rawSource);
+  const templateMatch = source.match(/<template[^>]*>([\s\S]*)<\/template>/i);
+  if (templateMatch?.[1]) source = templateMatch[1];
+
+  const tags = extractOpenTags(source);
+  const styles = [
+    ...extractBlocks(source, STYLE_BLOCK_PATTERN),
+    ...(options.externalStyles ?? []).map((style) => ({
+      attrs: `href="${style.href}"`,
+      content: style.content,
+      raw: style.content,
+      index: -1,
+    })),
+  ];
+  const scripts = extractBlocks(source, SCRIPT_BLOCK_PATTERN);
+  const compositionIds = collectCompositionIds(tags);
+  const rootTag = findRootTag(source);
+  const rootCompositionId = readAttr(rootTag?.raw || "", "data-composition-id");
+
+  return {
+    source,
+    rawSource,
+    tags,
+    styles,
+    scripts,
+    compositionIds,
+    rootTag,
+    rootCompositionId,
+    options,
+  };
+}