Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
168 commits
Select commit Hold shift + click to select a range
cfb4b65
feat(packages): add cloudflare stream media (#2168)
luwes Aug 15, 2026
8993ab1
feat(packages): add spotify audio media (#2169)
luwes Aug 15, 2026
7ff13b4
feat(packages): add tiktok video media (#2170)
luwes Aug 15, 2026
cde01ce
feat(packages): add twitch video media (#2171)
luwes Aug 15, 2026
12656e0
refactor(packages)!: normalize time slider chapters (#2204)
mihar-22 Aug 16, 2026
42f934e
fix(packages): improve ui motion (#2208)
sampotts Aug 17, 2026
e520ed9
test(packages): add automated accessibility checks (#2209)
sampotts Aug 17, 2026
15e3ba6
fix(packages): menu keyboard navigation (#2214)
sampotts Aug 17, 2026
87636f0
refactor(icons): svg animation tweaks (#2216)
sampotts Aug 17, 2026
c3cbc13
fix(media): announce a cleared source on every embed host (#2217)
luwes Aug 17, 2026
390a449
chore: release main (#1916)
luwes Aug 17, 2026
2948580
fix(ci): unblock the changelog prose bot, and lead with breaking chan…
decepulis Aug 17, 2026
f567712
docs(site): add changelog prose for 10.0.0-beta.27 (#2224)
github-actions[bot] Aug 17, 2026
79e6420
docs(site): publish the Video.js 8 migration guide (#2165)
decepulis Aug 17, 2026
b1ec996
docs(site): publish the Mux Player migration guide (#2163)
decepulis Aug 17, 2026
9aa8ea1
docs(site): publish the Plyr migration guide (#2166)
decepulis Aug 17, 2026
ce93287
docs(site): publish the Media Chrome migration guide (#2167)
decepulis Aug 17, 2026
1e8cc17
fix(skin): misc style fixes (#2232)
sampotts Aug 18, 2026
ba258ed
refactor(react): reduce use client directives (#2231)
sampotts Aug 18, 2026
0b193a5
fix(packages): restore menu trigger keyboard interaction (#2235)
sampotts Aug 18, 2026
163d37d
fix(core): improve Bengali translations (#2236)
sampotts Aug 18, 2026
414513f
feat(media): add maxAutoResolution cap to hls.js sources (#2061)
R-Delfino95 Aug 18, 2026
2fc058f
feat(ci): add pkg.pr.new preview releases (#2225)
luwes Aug 18, 2026
828bca0
docs(site): document mute availability (#2239)
sampotts Aug 18, 2026
8f2eb78
feat(core): prefer locale-matched captions on toggle (#2237)
sampotts Aug 18, 2026
8eebaef
fix(core): include menu triggers in tab order (#2238)
sampotts Aug 18, 2026
e5dd81a
feat(media): cap hls.js renditions to the player size (#2243)
R-Delfino95 Aug 18, 2026
19b017b
feat(ci): publish the sandbox as a stackblitz preview template (#2229)
luwes Aug 18, 2026
0882e1a
fix(packages): make the TikTok embed answer the player's controls (#2…
luwes Aug 18, 2026
6999a35
fix(html): ship a cdn bundle for every media element (#2252)
luwes Aug 19, 2026
2cc8249
fix(skin): use finite radius value (#2253)
sampotts Aug 19, 2026
965ef4a
feat(cd): add manual dispatch to the deployment workflow (#2254)
luwes Aug 19, 2026
f83659d
chore: release main (#2221)
luwes Aug 19, 2026
ae1ca50
fix(skin): style fixes (#2257)
sampotts Aug 19, 2026
58db042
fix(skin): align canonical poster and default controls (#2181)
mihar-22 Aug 19, 2026
4055cd5
feat(skin): add canonical buffering indicator (#2189)
mihar-22 Aug 19, 2026
fdfa869
feat(skin): add canonical error dialog (#2190)
mihar-22 Aug 19, 2026
6a6d8a6
feat(skin): add canonical captions button (#2191)
mihar-22 Aug 19, 2026
ec0572d
feat(skin): add canonical remote playback controls (#2192)
mihar-22 Aug 19, 2026
549f65c
feat(skin): add canonical input indicators (#2193)
mihar-22 Aug 19, 2026
6fd0684
feat(skin): complete canonical volume popover (#2194)
mihar-22 Aug 19, 2026
44ba4e9
feat(skin): add canonical time slider chapters (#2195)
mihar-22 Aug 19, 2026
db7e1c3
feat(skin): add canonical video settings menu (#2196)
mihar-22 Aug 19, 2026
885eb82
feat(skin): add canonical video input bindings (#2197)
mihar-22 Aug 19, 2026
941a6bf
feat(skin): complete canonical default video skin (#2198)
mihar-22 Aug 19, 2026
87b2eb3
feat(skin): add canonical minimal video skin (#2199)
mihar-22 Aug 19, 2026
8982d8d
feat(skin): add canonical styling and registry output (#2202)
mihar-22 Aug 19, 2026
9b109ba
feat(skin): share settings menu composition (#2203)
mihar-22 Aug 19, 2026
b50ed87
refactor(skin): simplify canonical projections and styling (#2206)
mihar-22 Aug 19, 2026
3d22856
refactor(skin): migrate styling to compiler (#2207)
mihar-22 Aug 19, 2026
3f6ac78
refactor(skin): use compiler catalog emission (#2213)
mihar-22 Aug 19, 2026
afb62fe
refactor(compiler): add declarative component registries (#2234)
mihar-22 Aug 19, 2026
45177fe
fix(ci): cancel stale workflow runs (#2263)
mihar-22 Aug 19, 2026
e20e542
fix(skin): preserve slider preview behavior (#2259)
sampotts Aug 19, 2026
20c1464
feat(spf)!: cap renditions to the screen and surface unplayable sourc…
cjpillsbury Aug 19, 2026
34b5712
fix(compiler): add version to vjsc package (#2272)
luwes Aug 19, 2026
8e2f0db
feat(ci): forward-port changelog prose to site/v10 (#2228)
decepulis Aug 19, 2026
7940b2c
feat(packages): make Mux and Vimeo content-data donors (#1998)
decepulis Aug 19, 2026
969cf56
feat(packages)!: name the resolved title `title`, and take it from co…
decepulis Aug 19, 2026
7a902db
feat(packages)!: resolve the poster in the store, and set src on img …
decepulis Aug 19, 2026
b4b6661
docs(site): add changelog prose for 10.0.0-beta.28 (#2256)
github-actions[bot] Aug 19, 2026
61f4083
chore: release main (#2258)
luwes Aug 19, 2026
c5895ec
feat(packages): add shaka player media (#2276)
luwes Aug 19, 2026
0841131
feat(packages): add title component (#1997)
decepulis Aug 20, 2026
e7de7a7
refactor(packages)!: remove built-in poster placeholders (#2063)
decepulis Aug 20, 2026
191538e
fix(skin): stabilize menu sizing and motion (#2283)
sampotts Aug 20, 2026
57b8148
fix(spf): report a verdict when the background ladder is undecodable …
cjpillsbury Aug 20, 2026
d9e92af
feat(media): bring the shaka media to parity with the hls.js media (#…
cjpillsbury Aug 20, 2026
459fddb
fix(packages): load posters and storyboard thumbnails in cross-origin…
luwes Aug 20, 2026
8bc1568
feat(site): document metadata feature (#2000)
decepulis Aug 20, 2026
e8829a2
feat(packages)!: configure orientation lock through providers (#1999)
decepulis Aug 20, 2026
357c3a4
feat(spf): Cap Rendition to Player Size (#2242)
spuppo-mux Aug 20, 2026
a02ebf4
docs(site): add changelog prose for 10.0.0-beta.29 (#2277)
github-actions[bot] Aug 20, 2026
2970a4e
chore: release main (#2278)
luwes Aug 20, 2026
7b0824a
docs(site): reconcile metadata docs with the rest of the merged stack…
decepulis Aug 20, 2026
ddfd482
docs(site): add changelog prose for 10.0.0-beta.30 (#2296)
github-actions[bot] Aug 20, 2026
44a398c
feat(packages): add live presets to installation and skin tools (#1919)
decepulis Aug 20, 2026
caf179b
feat(packages): add right-to-left player support (#2281)
sampotts Aug 20, 2026
d398aaf
docs(site): document the embed providers and Shaka, and generate engi…
decepulis Aug 21, 2026
a6fd00c
chore: release main (#2297)
luwes Aug 21, 2026
7d2ac58
docs(site): document thumbnail CORS inheritance (#2298)
luwes Aug 21, 2026
331eb67
docs(site): add changelog prose for 10.0.0-beta.31 (#2299)
github-actions[bot] Aug 21, 2026
188e28b
refactor(vjsc): migrate from ts to oxc + rolldown (#2287)
mihar-22 Aug 21, 2026
599007f
perf(packages): enable native MagicString (#2311)
mihar-22 Aug 21, 2026
fd4e8bd
fix(site): version CDN examples (#2335)
decepulis Aug 22, 2026
61cc868
docs(site): clarify plyr and media-chrome migration guides (#2329)
decepulis Aug 22, 2026
d278ef2
docs(site): add background video guide (#2339)
decepulis Aug 22, 2026
c146e27
refactor(i18n): use Intl.NumberFormat and Intl.ListFormat instead of …
sampotts Aug 22, 2026
6cda193
ci(ci): migrate agent workflows to codex (#2312)
mihar-22 Aug 23, 2026
c6307e9
fix(i18n): preserve registered translation overrides (#2354)
sampotts Aug 23, 2026
5664043
fix(sandbox): use fixed ports for sandbox and skins dev (#2353)
sampotts Aug 23, 2026
76fa285
refactor(html)!: replace ContainerMixin with ContainerElement (#2280)
mihar-22 Aug 24, 2026
a55c539
feat(spf): keep track selection within the initial codec family (#2289)
cjpillsbury Aug 24, 2026
edd75b6
docs(site): correct Mux Player migration guidance (#2328)
decepulis Aug 24, 2026
a2cd98f
docs(site): tiny docs chores (#2332)
decepulis Aug 24, 2026
f60eee6
docs(site): add vue and svelte integration guides (#2333)
decepulis Aug 24, 2026
f2c6fe7
docs(site): clarify player layout ownership (#2334)
decepulis Aug 24, 2026
761dcf3
refactor(html)!: rename MediaElement to UIElement (#2245)
mihar-22 Aug 24, 2026
66df078
docs(site): add dialog API references (#2375)
mihar-22 Aug 24, 2026
ac1c6f6
docs(site): explain skin customization model (#2315)
decepulis Aug 24, 2026
358cfbb
docs(site): clarify live migration behavior (#2326)
decepulis Aug 24, 2026
0c85dc1
docs(site): refine Vue and Svelte integration examples (#2374)
decepulis Aug 24, 2026
819ec7c
docs(site): document browser and tooling compatibility (#2330)
decepulis Aug 24, 2026
df2c07c
docs(site): document non-interactive cli use (#2338)
decepulis Aug 24, 2026
2e9c1e2
fix(packages): restore minimal volume controls (#2386)
sampotts Aug 25, 2026
a59ef08
build(root): migrate toolchain to vite plus (#2035)
mihar-22 Aug 25, 2026
60b754f
style(root): improve source code flow (#2350)
mihar-22 Aug 25, 2026
3d7f41d
refactor(core): simplify component file names (#2064)
mihar-22 Aug 25, 2026
aaa499c
fix: set oxlint path in vscode settings (#2390)
sampotts Aug 25, 2026
9b6e33e
style(root): enable jsdoc formatting (#2393)
mihar-22 Aug 25, 2026
584107d
style(root): group declarations with guard clauses (#2394)
mihar-22 Aug 25, 2026
9ca9626
docs(site): correct v10 guides after merge (#2385)
decepulis Aug 25, 2026
07d409c
refactor(site): replace api docs compiler with oxc (#2392)
mihar-22 Aug 25, 2026
81bb99a
feat(packages): add backdrop component parts (#2343)
mihar-22 Aug 25, 2026
b303dc7
refactor(packages): separate menu popup and content (#2347)
mihar-22 Aug 25, 2026
9c76a99
fix(html): handle detached popup roots (#2348)
mihar-22 Aug 25, 2026
8da1f84
fix(packages): harden vjsc vite workflow (#2355)
mihar-22 Aug 25, 2026
d157a63
fix(packages): restore vjsc skin visual parity (#2344)
mihar-22 Aug 25, 2026
fa515b6
feat(packages): add vjsc style diagnostics (#2345)
mihar-22 Aug 25, 2026
7240b15
docs(site): update menu and slider references (#2240)
sampotts Aug 25, 2026
30065dd
feat(packages): expose container controls state (#2376)
mihar-22 Aug 25, 2026
a23fdd9
feat(packages): add volume popover compound (#2378)
mihar-22 Aug 25, 2026
bc9fd5f
fix(packages): add audio playback rate tooltips (#2389)
sampotts Aug 25, 2026
d1c428e
refactor(packages): reuse tooltip styles for audio previews (#2388)
sampotts Aug 25, 2026
b030c91
fix(core): preserve anchored popovers while scrolling (#2387)
sampotts Aug 25, 2026
33f4de1
fix(packages): make html entries server importable (#2428)
mihar-22 Aug 25, 2026
38cd16c
fix(media): make engine entries server importable (#2429)
mihar-22 Aug 25, 2026
405bd2a
fix(test): restore e2e test coverage (#2401)
mihar-22 Aug 25, 2026
8b96602
fix(element): preserve props across late registration (#2400)
mihar-22 Aug 25, 2026
8c66aab
refactor(skin): prefix all internal css custom properties (#2391)
sampotts Aug 25, 2026
108b8fd
feat(packages): add dialog component (#2379)
mihar-22 Aug 26, 2026
2007d18
refactor(html)!: return PlayerElement from createPlayer (#2180)
mihar-22 Aug 26, 2026
0065e9f
feat(packages)!: separate dialog popup and backdrop surfaces (#2435)
mihar-22 Aug 26, 2026
7a6ccb0
feat(packages)!: separate controls content and backdrop surfaces (#2436)
mihar-22 Aug 26, 2026
2fe8b79
refactor(html)!: make preset and UI registration explicit (#2247)
mihar-22 Aug 26, 2026
14863eb
fix(site): thin compact table of contents rail (#2402)
decepulis Aug 26, 2026
1fec07c
feat(site): generate component event references (#2404)
decepulis Aug 26, 2026
7d823ee
docs(site): add Hotkey reference (#2405)
decepulis Aug 26, 2026
d97df91
docs(site): add Gesture reference (#2406)
decepulis Aug 26, 2026
6beb7a6
docs(site): correct player container references (#2407)
decepulis Aug 26, 2026
d888839
docs(site): clarify TimeSlider chapter ranges (#2408)
decepulis Aug 26, 2026
d67b399
docs(site): explain container popup coordination (#2409)
decepulis Aug 26, 2026
83c4580
docs(site): document Menu data-item hook (#2410)
decepulis Aug 26, 2026
9d522f8
docs(site): correct Tooltip accessibility guidance (#2411)
decepulis Aug 26, 2026
038b379
docs(site): add installation next steps (#2412)
decepulis Aug 26, 2026
ae52e0c
docs(site): refresh Media Chrome migration gaps (#2413)
decepulis Aug 26, 2026
f762202
docs(site): link contributor guide in sidebar (#2414)
decepulis Aug 26, 2026
d490a13
docs(site): remove redundant page openings (#2415)
decepulis Aug 26, 2026
f2d8964
docs(site): add SeekIndicator reference (#2416)
decepulis Aug 26, 2026
508e045
docs(site): add StatusAnnouncer reference (#2417)
decepulis Aug 26, 2026
0104e5f
docs(site): add StatusIndicator reference (#2418)
decepulis Aug 26, 2026
51e8594
docs(site): add VolumeIndicator reference (#2419)
decepulis Aug 26, 2026
56ebb64
docs(site): add native Video and Audio references (#2420)
decepulis Aug 26, 2026
033f750
docs(site): add useContainer reference (#2421)
decepulis Aug 26, 2026
4934e45
docs(site): add missing utility references (#2422)
decepulis Aug 26, 2026
28f1f39
docs(site): clarify HTML player contexts (#2423)
decepulis Aug 26, 2026
2f3516a
docs(site): explain custom element lifecycle (#2424)
decepulis Aug 26, 2026
adff361
docs(packages): improve high-traffic API JSDoc (#2425)
decepulis Aug 26, 2026
88a5b26
refactor(site): complete TypeScript migration (#2426)
decepulis Aug 26, 2026
9b35588
docs(site): standardize component reference imports (#2430)
decepulis Aug 26, 2026
1736ec3
docs: add how-to guides for player capabilities (#1945)
dylanjha Aug 26, 2026
bbcd861
refactor(packages): separate backdrops from content surfaces (#2437)
sampotts Aug 26, 2026
0d90572
fix(packages): improve menu behavior and sizing (#2440)
sampotts Aug 26, 2026
cfb4bae
chore: release main (#2323)
luwes Aug 26, 2026
d083950
docs(site): restore the 10.0.0-beta.32 raw changelog (#2442)
decepulis Aug 26, 2026
30d3001
Merge branch 'main' into mmcc/moq
mmcc Aug 26, 2026
dd5b316
Merge branch 'mmcc/moq' into mmcc/moq-publisher
mmcc Aug 26, 2026
5622191
fix(skin): drop the dead error-hiding variant from the publisher cont…
mmcc Aug 27, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
The diff you're trying to view is too large. We only load the first 3000 changed files.
35 changes: 0 additions & 35 deletions .agents/plans/eject-prototype-migration.md

This file was deleted.

47 changes: 47 additions & 0 deletions .agents/skills/configure-vite-plus/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
---
name: configure-vite-plus
description: Configure Vite+. Use for tasks, cache, migration, or CI.
---

# Configure Vite+ workflows

Inspect the installed `vite-plus` version, root and owning-package manifests and `vite.config.ts` files, `build/pack.ts`, relevant CI workflows, and the command's current clean-run behavior before editing. Use `pnpm exec vp <command> --help` and installed types when they differ from online documentation.

Read [references/official-guide.md](references/official-guide.md) only for the sections that match the work: task graphs, cache diagnosis, GitHub Actions cache, Pack, or migration.

## Workflow

1. Classify each operation: `vp build` for applications, `vp pack` for libraries, and `vp run` for orchestration and caching. Invoke a script or configured task as `vp run <name>`; bare `vp <name>` selects a built-in command.
2. Preserve build boundaries. Keep historically separate packaging workflows in separate Vite+ configs unless they are genuinely variants of one build. A named `pack` array supports `vp pack --filter <name>` within one workflow; a nested `vite.config.ts` supports an independent workflow via `vp -C <dir> pack`.
3. Define ordering in `run.tasks`, not in serial shell pipelines. Every configured task needs `command` and cannot duplicate a same-named `package.json` script. Use `{ task: 'build', from: ['dependencies', 'devDependencies'] }` for declared direct workspace edges and `package#task` for synthetic edges such as generated CDN assets. `-r` selects workspace tasks; it does not replace missing task dependencies.
4. Let the graph expose independent work to Vite+'s scheduler. Do not lower concurrency to repair missing edges. Reserve `--parallel`, which ignores dependencies, for independent persistent tasks such as development servers.
5. Keep root scripts as thin selectors. Put package-specific commands, inputs, outputs, environment, and dependencies in the owning package's config.
6. Prove local cache stability before configuring cross-run cache. Only `vp run` uses Vite Task caching. Run the exact task twice and require the second run to hit. Prefer automatic tracking, then add `input`, `output`, `env`, or `untrackedEnv` only from observed misses. Avoid generators that rewrite unchanged inputs.
7. In GitHub Actions, install first, restore `node_modules/.vite/task-cache`, run the same `vp run` tasks used locally, and save only after success. Keep source and lockfile hashes out of the Actions cache key because Vite Task fingerprints task inputs.

## Repository gotchas

- Reuse packaging defaults from `build/pack.ts`; keep package entries, platform, and exceptional plugins local.
- Top-level Vite `resolve.alias` and Pack's `pack.alias` serve different consumers. Do not assume one configures the other; share alias constants when both commands need identical mappings and test both paths.
- Vite+ loads a package config before it can schedule that package's dependencies. Config-time imports from private workspace packages must be available without relying on their built output.
- `vp pack` uses file-system cache tracking rather than `vp build`'s cooperative Vite metadata. Diagnose its observed reads and writes before adding manual globs.

## Example

Input: The sandbox build consumes normal workspace packages and generated HTML CDN files.

Output: A configured build task with declared workspace and generated-artifact dependencies.

```ts
build: {
command: 'vp build',
dependsOn: [
{ task: 'build', from: ['dependencies', 'devDependencies'] },
'@videojs/html#build:cdn',
],
}
```

## Validation

Run the narrow target from a clean output state, inspect `vp run -v` ordering, and run it immediately again to verify cache hits and restored outputs. Then run the affected package tests/build, `pnpm typecheck` when types or configs changed, and `pnpm check:workspace`. For CI changes, verify restore occurs after install, save uses the restore step's primary key, and logs show both an Actions cache restore and Vite Task cache hits.
32 changes: 32 additions & 0 deletions .agents/skills/configure-vite-plus/references/official-guide.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
# Official Vite+ reading map

Use the smallest relevant section. The repository's installed version, CLI help, and types remain the executable source of truth when the evolving documentation differs.

## Run task definitions and workspace ordering

Read the [Run guide](https://viteplus.dev/guide/run) and [Run configuration](https://viteplus.dev/config/run) before adding or changing tasks. Read the [monorepo guide](https://viteplus.dev/guide/monorepo) when package selection or workspace topology changes.

Verify these details against the installed version:

- A task name may be defined in `vite.config.ts` or `package.json`, not both.
- `package#task` names an exact cross-package edge. The object `dependsOn` form expands a task over the declaring package's chosen dependency fields.
- Recursive and transitive selection derive ordering from normal workspace `dependencies`; selection flags do not infer exceptional artifact relationships.
- Normal execution preserves dependency ordering and runs independent work concurrently. `--parallel` deliberately ignores task dependencies.

## Local caching and unstable tracking

Read [Task Caching](https://viteplus.dev/guide/cache), [Automatic Data Tracking](https://viteplus.dev/guide/automatic-data-tracking), and the `input`, `output`, `env`, and `untrackedEnv` sections of [Run configuration](https://viteplus.dev/config/run).

Start with automatic tracking. Add `{ auto: true }` plus exclusions when a generated output was incorrectly observed as an input. Use workspace-based pattern objects for files outside the task's package. Replace automatic inputs with explicit globs only when the complete input set is known. Remember that only `vp build` currently supplies cooperative Vite metadata; other commands rely on file-system observations unless configured manually.

## GitHub Actions cache

Read the experimental [GitHub Actions cache guide](https://viteplus.dev/guide/github-actions-cache) before changing a workflow.

The documented order is install, restore, `vp run` tasks, then save on success. The cache directory is `node_modules/.vite/task-cache`. Use an immutable primary key containing OS, architecture, run ID, and attempt, with an OS/architecture restore prefix. Do not add source hashes to the Actions key. Confirm an immediate local second run hits before expecting a restored CI cache to hit, and measure whether transfer overhead is worthwhile.

## Pack and migrations

Read [Pack](https://viteplus.dev/guide/pack) and [Pack configuration](https://viteplus.dev/config/pack) before changing a library build. Consult the linked tsdown documentation for Pack-only options. Read [Migrate to Vite+](https://viteplus.dev/guide/migrate) and [Migration Rules](https://viteplus.dev/guide/migrate-rules) when replacing another tool rather than maintaining the resulting setup.

`vp pack` reads its tsdown settings from the active `vite.config.ts` `pack` block. Use a `name` plus `--filter` for related configs loaded together. Use the global `-C <dir>` option when a deliberately separate config lives in its own directory.
4 changes: 2 additions & 2 deletions .agents/skills/create-html-component/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,14 +11,14 @@ Read the relevant core contract, nearest HTML element and tests, definition entr

1. Classify the request as a reusable primitive or app/skin composition before defining its contract. Then define the state owner, semantics, APIs, optional parts, styling contract, and opt-outs.
2. Put runtime-neutral state and actions in `packages/core/src/core/ui/`; put reusable DOM interaction in `packages/core/src/dom/ui/`; keep the element an adapter.
3. Match the nearest `MediaElement` or `MediaButtonElement` pattern. Send properties down and semantic events up; use controllers or context only across a real ownership boundary.
3. Match the nearest `UIElement` or `MediaButtonElement` pattern. Send properties down and semantic events up; use controllers or context only across a real ownership boundary.
4. Let `ReactiveElement` own rendered DOM updates: derive changes from reactive properties and controller state, then apply them through its update lifecycle. Avoid out-of-band mutations so scheduling, `updateComplete`, tests, and integrations remain authoritative.
5. Add markup for semantics, focus, content, or parts consumers must place, omit, or replace. Leave purely visual structure to skins, CSS, or pseudo-elements. If the API starts coordinating independent behavior, extract another element or controller instead of adding modes and options.
6. Expose discrete state through mapped `data-*` attributes and dynamic layout values through stable CSS custom properties. Define each token's owner, units, and fallback. Treat descendant selectors, `:has()`, and other complex selectors introduced by composition as a likely sign that the primitive boundary or styling hooks need improvement.
7. Keep the element class free of registration side effects. Register it with `safeDefine` under `packages/html/src/define/ui/`, update `HTMLElementTagNameMap`, and preserve narrow import and `sideEffects` boundaries.
8. Clean up subscriptions, observers, listeners, locks, and async work across disconnect and destroy. Add focused core and HTML tests; verify interaction in a browser when semantics, focus, or pointer behavior changes.

Check `packages/html/package.json` and `packages/html/tsdown.config.ts` when adding an entrypoint or registration module. Run the narrow package tests and build; build changed exported types before repository typechecking.
Check `packages/html/package.json` and `packages/html/vite.config.ts` when adding an entrypoint or registration module. Run the narrow package tests and build; build changed exported types before repository typechecking.

## Example

Expand Down
4 changes: 2 additions & 2 deletions .agents/skills/create-react-component/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,9 +16,9 @@ Read the relevant core contract, nearest React component and tests, public expor
5. Add a compound part only for a semantic, focusable, placeable, omittable, or replaceable node. Keep context values narrow and scoped to the owning root; do not mirror derived state through effects. If the API starts coordinating independent behavior, extract another component or hook instead of adding modes and options.
6. Expose discrete state through mapped `data-*` attributes and dynamic layout values through stable CSS custom properties. Leave visual defaults to skins and CSS. Treat descendant selectors, `:has()`, and other complex selectors introduced by composition as a likely sign that the primitive boundary or styling hooks need improvement.
7. Preserve the default semantic element while allowing deliberate replacement through `render`. Ensure omitted parts and unsupported features do not leave hidden behavior or required markup behind.
8. Export compound APIs as tree-shakeable ESM namespaces with `export * as Name from './index.parts'`; keep parts as direct re-exports and do not assemble a runtime namespace object. Avoid pulling optional dependencies into unrelated imports. Add focused tests for rendered behavior, ref/prop composition, context boundaries, and customization.
8. Export compound APIs as tree-shakeable ESM namespaces with `export * as Name from './index.parts'`; keep parts as direct re-exports and do not assemble a runtime namespace object. When a compound specializes another compound, re-export unchanged base parts under the specialized namespace and create a specialized part only when its behavior or defaults differ. Avoid pulling optional dependencies into unrelated imports. Add focused tests for rendered behavior, ref/prop composition, context boundaries, and customization.

Use `packages/react/src/ui/create-media-button.tsx`, `packages/react/src/utils/use-render.tsx`, and `packages/react/src/ui/slider/index.parts.ts` as implementation anchors. Check `packages/react/package.json` and `packages/react/tsdown.config.ts` when the public or bundle boundary changes.
Use `packages/react/src/ui/create-media-button.tsx`, `packages/react/src/utils/use-render.tsx`, and `packages/react/src/ui/slider/index.parts.ts` as implementation anchors. Check `packages/react/package.json` and `packages/react/vite.config.ts` when the public or bundle boundary changes.

## Example

Expand Down
Loading
Loading