hyperframes

273 Commits 856 Branches 404 Tags

2 Commits

Include renames

Author	SHA1	Message	Date
Vance IngallsandClaude Opus 4.6	fc973ee2e8	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>	2026-04-08 20:45:25 -07:00
Miguel Ángel	5421c23fff	refactor(lint): break 1,314-line monolith into focused rule modules with plugin system (#170 ) ## Summary - Breaks `hyperframeLinter.ts` from 1,314 lines (one massive function) into a plugin system of focused rule modules - Introduces `LintContext` — HTML is parsed once and shared across all rules - Adds `LintRule<TContext>` type as the formal contract for rules - Public API unchanged: `lintHyperframeHtml`, `lintMediaUrls`, `lintScriptUrls` signatures identical ## New file structure ``` src/lint/ utils.ts — shared types (OpenTag, ExtractedBlock), regex constants, helpers context.ts — LintContext type + buildLintContext() factory rules/ core.ts — structural rules (root attrs, timeline registry, script syntax) media.ts — media element rules (duplicate ids, video pitfalls, placeholder URLs, etc.) gsap.ts — GSAP rules + GSAP-specific parsing utils captions.ts — caption rules composition.ts — timed element, deprecated attrs, template literal selector, external scripts adapters.ts — Lottie + Three.js missing-script rules (from PR #149) hyperframeLinter.ts — orchestrator only (~200 lines, down from 1,314) ``` ## Adding a new adapter rule going forward 1. Create `src/lint/rules/my-adapter.ts` exporting `myAdapterRules: LintRule[]` 2. Import and spread into `ALL_RULES` in `hyperframeLinter.ts` ## Test plan - [x] All 402 core tests pass unchanged - [x] Full workspace build clean (`pnpm build`) - [x] TypeScript strict mode clean (`pnpm tsc --noEmit`)	2026-04-01 00:50:13 +02:00

Author

SHA1

Message

Date

Vance IngallsandClaude Opus 4.6

fc973ee2e8

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>

2026-04-08 20:45:25 -07:00

Miguel Ángel

5421c23fff

refactor(lint): break 1,314-line monolith into focused rule modules with plugin system (#170 )

## Summary

- Breaks `hyperframeLinter.ts` from 1,314 lines (one massive function) into a plugin system of focused rule modules
- Introduces `LintContext` — HTML is parsed once and shared across all rules
- Adds `LintRule<TContext>` type as the formal contract for rules
- Public API unchanged: `lintHyperframeHtml`, `lintMediaUrls`, `lintScriptUrls` signatures identical

## New file structure

```
src/lint/
  utils.ts          — shared types (OpenTag, ExtractedBlock), regex constants, helpers
  context.ts        — LintContext type + buildLintContext() factory
  rules/
    core.ts         — structural rules (root attrs, timeline registry, script syntax)
    media.ts        — media element rules (duplicate ids, video pitfalls, placeholder URLs, etc.)
    gsap.ts         — GSAP rules + GSAP-specific parsing utils
    captions.ts     — caption rules
    composition.ts  — timed element, deprecated attrs, template literal selector, external scripts
    adapters.ts     — Lottie + Three.js missing-script rules (from PR #149)
  hyperframeLinter.ts — orchestrator only (~200 lines, down from 1,314)
```

## Adding a new adapter rule going forward

1. Create `src/lint/rules/my-adapter.ts` exporting `myAdapterRules: LintRule[]`
2. Import and spread into `ALL_RULES` in `hyperframeLinter.ts`

## Test plan

- [x] All 402 core tests pass unchanged
- [x] Full workspace build clean (`pnpm build`)
- [x] TypeScript strict mode clean (`pnpm tsc --noEmit`)

2026-04-01 00:50:13 +02:00