feat(lint): add rules for missing data-start, template wrapper, and DOCTYPE

Three new lint rules that catch structural issues causing compositions
to fail silently in preview:

- root_composition_missing_data_start: Root composition needs data-start="0"
  for the runtime to begin playback
- standalone_composition_wrapped_in_template: index.html should not be
  wrapped in <template> (only sub-compositions use that)
- root_composition_missing_html_wrapper: index.html needs <!DOCTYPE html>
  and <html> wrapper for the bundler

Also adds rawSource to LintContext so rules can inspect pre-template-stripped
HTML, and isSubComposition to linter options so rules can distinguish root
from sub-composition files.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Vance Ingalls
2026-04-08 20:45:25 -07:00
co-authored by Claude Opus 4.6
parent b33bbfa0f9
commit fc973ee2e8
4 changed files with 66 additions and 2 deletions
+4 -1
View File
@@ -14,6 +14,7 @@ export type { OpenTag, ExtractedBlock };
export type LintContext = {
source: string;
rawSource: string;
tags: OpenTag[];
styles: ExtractedBlock[];
scripts: ExtractedBlock[];
@@ -27,7 +28,8 @@ export type LintContext = {
export type { HyperframeLintFinding };
export function buildLintContext(html: string, options: HyperframeLinterOptions = {}): LintContext {
let source = html || "";
const rawSource = html || "";
let source = rawSource;
const templateMatch = source.match(/<template[^>]*>([\s\S]*)<\/template>/i);
if (templateMatch?.[1]) source = templateMatch[1];
@@ -40,6 +42,7 @@ export function buildLintContext(html: string, options: HyperframeLinterOptions
return {
source,
rawSource,
tags,
styles,
scripts,