feat: publish researched offline HTML presentation skill
This commit is contained in:
commit
50eab114ae
35 files changed
+1201
No files matched your search
@@ -0,0 +1,23 @@
|
||||
# Established examples and lawful reuse catalog
|
||||
|
||||
Inspected 2026-10-21. “Established” identifies official showcase material or a widely known talk, not a measured popularity ranking. External pages are inspiration references, not runtime dependencies. **No branded artwork, logo paths, video, photos or talk slides are redistributed.** The bundled deck contains original compositions authored for this package.
|
||||
|
||||
| Source / author | Exact inspected source | Lesson | Reuse decision / bundled counterpart |
|
||||
|---|---|---|---|
|
||||
| Reveal.js official demo / Hakim El Hattab and contributors | [live demo](https://revealjs.com/demo/), [6.0.2 source](https://github.com/hakimel/reveal.js/blob/6.0.2/demo.html) | Progressive disclosure, strong typographic hierarchy, navigation | Repository code MIT; embedded media rights may differ. Original title, narrative and conclusion in starter slides 1, 2, 6; no copied talk content. |
|
||||
| Reveal Auto-Animate / Hakim El Hattab | [official documentation and examples](https://revealjs.com/auto-animate/) | Preserve object continuity rather than add spectacle | Linked only; no copied website assets. Starter chooses no slide transition and content-local motion. |
|
||||
| Anime.js advanced grid staggering / Julian Garnier | [v4.5.0 example](https://github.com/juliangarnier/anime/tree/v4.5.0/examples/advanced-grid-staggering) | Stagger exposes spatial or temporal order | MIT repository code; source inspected, not redistributed. Original six-mark stagger, slide 5. |
|
||||
| Anime.js SVG line drawing / Julian Garnier | [v4.5.0 example](https://github.com/juliangarnier/anime/tree/v4.5.0/examples/svg-line-drawing) | Keep vector geometry editable; motion can explain connection | MIT code. Original hub/spoke SVG on slide 3; static edges intentionally avoid gratuitous redraw. |
|
||||
| Anime.js v4 logo animation / Julian Garnier | [v4.5.0 example](https://github.com/juliangarnier/anime/tree/v4.5.0/examples/animejs-v4-logo-animation) | Timeline orchestration produces staged hierarchy | MIT code does not imply trademark endorsement. Logo not copied. Original three-step process timeline, slide 4. |
|
||||
| Inventing on Principle / Bret Victor | [author link](https://worrydream.com/InventingOnPrinciple/) redirected to [Vimeo](https://vimeo.com/906418692) | Reference candidate for direct manipulation and explaining ideas through working demonstrations | No reuse license established; link only, no video or slide copying. Only redirect/page availability was verified here, not a new full-video review. Not claimed as a Reveal/Anime implementation. |
|
||||
|
||||
## Original reusable examples in assets
|
||||
|
||||
`assets/starter.html` and `assets/app.js` are MIT original code, not reproductions of showcase layouts:
|
||||
|
||||
1. Editorial title / decision framing (slides 1 and 6).
|
||||
2. Narrative structure and bounded three-stage timeline (slides 2 and 4).
|
||||
3. Accessible editable six-spoke decision diagram with real details (slide 3; generated labels in `scripts/build.py`).
|
||||
4. One-shot six-mark stagger with reduced-motion final state (slide 5).
|
||||
|
||||
Use the entire source package or extract these patterns with their supporting CSS and lifecycle handlers. Do not extract the visible effect and omit keyboard, motion-reduction or print behavior. Vendored runtime licenses are in `assets/vendor`; original package code is covered by root `LICENSE`.
|
||||
@@ -0,0 +1,23 @@
|
||||
# Exact-artifact acceptance contract
|
||||
|
||||
Before test execution freeze the delivered file path and hash, expected slide IDs/titles, expected interactive-node inventory and browser scope. The included test is a six-slide/six-node example contract. When adapting it, change those expectations to the real deck; `DECK_PATH` alone does not make the demo-specific assertions a generic validator.
|
||||
|
||||
## Automated checks
|
||||
|
||||
- Build from source; load that exact `file://` artifact with context offline before navigation.
|
||||
- Collect all HTTP(S) request attempts (failed attempts also fail), page errors and console errors.
|
||||
- Wait for ready and local font loading. Verify computed palette as well as font availability.
|
||||
- Visit every slide, wait for motion to settle, check text bounds and capture each slide separately.
|
||||
- Enumerate all interactive nodes and test click, Enter and Space; verify state and real visible effect. Production decks with 46 nodes must test all 46, not a sample.
|
||||
- Verify arrows, overview, visible fullscreen entry/exit and F entry/exit using actual browser fullscreen state.
|
||||
- Wait for hash publication before reload. Test storage denial if the delivery environment restricts it.
|
||||
- Repeat in reduced motion; settle on runtime preference change, print and early slide departure.
|
||||
- Assert controls disappear in print. For PDF requests, export and inspect every PDF page separately; do not infer pagination quality from this check.
|
||||
|
||||
## Visual review
|
||||
|
||||
Inspect every exact-final screenshot at readable size. Check: clipped text, dense labels, low contrast, ghost transitions, connector endpoints, box-centered labels, visual hierarchy, visible focus, consistent spacing, and narrative continuity. Native text is not proof of legibility. Avoid thumbnail-only review. If requested, deliver each preview separately in order rather than a contact sheet.
|
||||
|
||||
## Evidence and limitations
|
||||
|
||||
`evidence/test-report.json` binds the exact generated hash to two actual Chromium runs. `evidence/slide-*.png` are final normal-motion screenshots. `evidence/visual-review.md` records self-review and fixes. Headless Chromium success is not Safari/Firefox/mobile, screen-reader or projector proof. An independent reviewer was not available in the delegated environment; do not label self-review independent.
|
||||
@@ -0,0 +1,37 @@
|
||||
# Research and API decisions
|
||||
|
||||
Research date: **2026-10-21 UTC**. HTTP audit timestamps, redirects, failures and response hashes are retained in `source-audit.json`; package versions are locked in `package-lock.json`. Latest npm metadata and official GitHub releases both reported Reveal.js 6.0.2 and Anime.js 4.5.0 at research time. These are dated observations, not evergreen “latest” promises.
|
||||
|
||||
## Official Reveal.js findings
|
||||
|
||||
- [Initialization](https://revealjs.com/initialization/): `Reveal.initialize()` resolves when ready. Official documentation explicitly identifies the UMD bundle as suitable for filesystem use; use it for a portable single file.
|
||||
- [API](https://revealjs.com/api/): navigate using the framework API, not ad hoc visibility hacks. Query current slide and indices for deterministic tests.
|
||||
- [Keyboard](https://revealjs.com/keyboard/): numeric key bindings can override or disable defaults; preserve accessibility and avoid double fullscreen handling.
|
||||
- [Auto-Animate](https://revealjs.com/auto-animate/): object continuity across slides can be useful, but do not combine two animation systems on one property. Our starter deliberately disables it and uses bounded Anime motion inside slides.
|
||||
- [PDF export](https://revealjs.com/pdf-export/): `?print-pdf` invokes dedicated pagination; ordinary print CSS alone is not equivalent to a validated PDF. Test the actual exported PDF if required.
|
||||
- [Official demo](https://revealjs.com/demo/): nested navigation, fragments and progressive disclosure demonstrate capability; copying every feature creates cognitive load. Adopt only what supports the story.
|
||||
- [Release 6.0.2](https://github.com/hakimel/reveal.js/releases/tag/6.0.2): exact runtime chosen for this package.
|
||||
|
||||
## Official Anime.js findings
|
||||
|
||||
The main animejs.com site and several documentation paths timed out or became unreachable from this environment; one guessed migration URL redirected to the homepage. Those were NOT treated as verified documentation. Research continued through the author's official GitHub release, package README, migration wiki and exact-tag example sources.
|
||||
|
||||
- [Release v4.5.0](https://github.com/juliangarnier/anime/releases/tag/v4.5.0), source commit `2c9cf8ea00329f6768c7d7902252ed977d75ce42`.
|
||||
- [Official migration guide](https://github.com/juliangarnier/anime/wiki/Migrating-from-v3-to-v4), read directly from the official wiki raw endpoint. A response hash is in `upstream-sources.json`; the wiki URL is mutable, not a claimed commit pin.
|
||||
- [Official package README](https://github.com/juliangarnier/anime/tree/v4.5.0): named imports (`animate`, `stagger`); this deck uses equivalent properties from the UMD `anime` namespace.
|
||||
- V3 `anime({targets, easing:'easeOutCubic'})` becomes v4 `animate(targets,{ease:'outCubic'})`.
|
||||
- V3 `anime.timeline` becomes `createTimeline`; inherited child options go under `defaults`.
|
||||
- V3 callbacks become `onBegin`, `onUpdate`, `onComplete`; `finished` becomes `.then()`.
|
||||
- V4 `loop:1` means one repeat (two iterations), unlike v3. Avoid loops in explanatory deck motion.
|
||||
- V3 path helpers become the `svg` module's `createMotionPath` and `createDrawable`; do not rename blindly without validating geometry.
|
||||
- V4 `reverse()` plays backwards; it does not just toggle direction. Use lifecycle completion/cancellation deliberately.
|
||||
|
||||
## Production choices derived from research
|
||||
|
||||
Use Reveal only for slide navigation and sizing; use Anime only for bounded content motion. Content is visible by default and motion is enhancement. No external imagery is needed for the bundled original examples. Each interactive SVG group has a real detail action, accessible name, state and keyboard behavior. Native text remains editable and searchable.
|
||||
|
||||
The approved prior channel deck supplied preferences, not reusable proprietary content: editable diagrams, calm motion, Work Sans, visible fullscreen, offline packaging, exhaustive node testing. Neither its fifteen slides nor its 46-node acceptance scope is imposed on future decks. The historical artifact's embedded Anime bundle identifies itself as 3.2.1 despite prior context describing 3.2.2; the new package does not reuse that bundle.
|
||||
|
||||
## Failed candidates and limits
|
||||
|
||||
`revealjs.com/examples/` and `slides.com/news/introducing-auto-animate` returned 404; neither is cited as a successful source. Browser Use could not start its isolated daemon; local Playwright Chromium was used for real rendering and interaction QA instead. Anime site availability is an explicit research caveat, not hidden by invented page summaries.
|
||||
@@ -0,0 +1,125 @@
|
||||
[
|
||||
{
|
||||
"url": "https://revealjs.com/",
|
||||
"final_url": "https://revealjs.com/",
|
||||
"status": 200,
|
||||
"bytes": 37980,
|
||||
"sha256": "13ad6c3f8e5e142f9a1519348cbee2baaded12b19cce712bdf2c75875fa65a3b",
|
||||
"retrieved": "2026-10-21T20:07:31.107105+00:00",
|
||||
"excerpt": ""
|
||||
},
|
||||
{
|
||||
"url": "https://revealjs.com/initialization/",
|
||||
"final_url": "https://revealjs.com/initialization/",
|
||||
"status": 200,
|
||||
"bytes": 32519,
|
||||
"sha256": "265abafda18126cc6b2fc2fec50ccbbee70f9a459119a5674d438ba1e2ed094d",
|
||||
"retrieved": "2026-10-21T20:07:31.096642+00:00",
|
||||
"excerpt": ""
|
||||
},
|
||||
{
|
||||
"url": "https://revealjs.com/api/",
|
||||
"final_url": "https://revealjs.com/api/",
|
||||
"status": 200,
|
||||
"bytes": 37890,
|
||||
"sha256": "5e0dc568a85316bc6495a0890703a0afcf1897716089d8341fea83c88755df25",
|
||||
"retrieved": "2026-10-21T20:07:31.152241+00:00",
|
||||
"excerpt": ""
|
||||
},
|
||||
{
|
||||
"url": "https://revealjs.com/keyboard/",
|
||||
"final_url": "https://revealjs.com/keyboard/",
|
||||
"status": 200,
|
||||
"bytes": 26999,
|
||||
"sha256": "9107ab26a2796c27358b9b48b559d05931ab74c3f2aef34d3d8d707336655dd8",
|
||||
"retrieved": "2026-10-21T20:07:31.131452+00:00",
|
||||
"excerpt": ""
|
||||
},
|
||||
{
|
||||
"url": "https://revealjs.com/auto-animate/",
|
||||
"final_url": "https://revealjs.com/auto-animate/",
|
||||
"status": 200,
|
||||
"bytes": 53371,
|
||||
"sha256": "52fc9a48a1b41785669fc86f2551a800ad7eabadb841a37487bad3a9f48a614c",
|
||||
"retrieved": "2026-10-21T20:07:31.128147+00:00",
|
||||
"excerpt": ""
|
||||
},
|
||||
{
|
||||
"url": "https://revealjs.com/pdf-export/",
|
||||
"final_url": "https://revealjs.com/pdf-export/",
|
||||
"status": 200,
|
||||
"bytes": 25670,
|
||||
"sha256": "241557b9553877b9cf09629635385f09cca6ba9dad1aefc38cc8daf04789da59",
|
||||
"retrieved": "2026-10-21T20:07:31.056258+00:00",
|
||||
"excerpt": ""
|
||||
},
|
||||
{
|
||||
"url": "https://revealjs.com/demo/",
|
||||
"final_url": "https://revealjs.com/demo/",
|
||||
"status": 200,
|
||||
"bytes": 16825,
|
||||
"sha256": "1fcb4a0ad40896d2d55090fd0be8ddca8854db033b0f6b24931f259e63620dff",
|
||||
"retrieved": "2026-10-21T20:07:30.965910+00:00",
|
||||
"excerpt": ""
|
||||
},
|
||||
{
|
||||
"url": "https://revealjs.com/examples/",
|
||||
"error": "HTTP Error 404: Not Found"
|
||||
},
|
||||
{
|
||||
"url": "https://animejs.com/",
|
||||
"error": "The read operation timed out"
|
||||
},
|
||||
{
|
||||
"url": "https://animejs.com/documentation/animation/",
|
||||
"error": "The read operation timed out"
|
||||
},
|
||||
{
|
||||
"url": "https://animejs.com/documentation/timeline/",
|
||||
"error": "The read operation timed out"
|
||||
},
|
||||
{
|
||||
"url": "https://animejs.com/documentation/scope/",
|
||||
"error": "The read operation timed out"
|
||||
},
|
||||
{
|
||||
"url": "https://animejs.com/documentation/getting-started/migration-guide/",
|
||||
"final_url": "https://animejs.com/",
|
||||
"status": 200,
|
||||
"bytes": 45925,
|
||||
"sha256": "33347970c72aed36cf6166115fa93a0242fc573f70fc211febd0f4d030d06c48",
|
||||
"retrieved": "2026-10-21T20:08:46.572624+00:00",
|
||||
"excerpt": ""
|
||||
},
|
||||
{
|
||||
"url": "https://api.github.com/repos/hakimel/reveal.js/releases/latest",
|
||||
"final_url": "https://api.github.com/repos/hakimel/reveal.js/releases/latest",
|
||||
"status": 200,
|
||||
"bytes": 2727,
|
||||
"sha256": "3e3ca1de3def1937575fbd675be49a851aea8ab2b85d86a01becb57405f297c9",
|
||||
"retrieved": "2026-10-21T20:07:31.375546+00:00",
|
||||
"excerpt": "{\"url\":\"https://api.github.com/repos/hakimel/reveal.js/releases/386414926\",\"assets_url\":\"https://api.github.com/repos/hakimel/reveal.js/releases/386414926/assets\",\"upload_url\":\"https://uploads.github.com/repos/hakimel/reveal.js/releases/386414926/assets{?name,label}\",\"html_url\":\"https://github.com/hakimel/reveal.js/releases/tag/6.0.2\",\"id\":386414926,\"author\":{\"login\":\"hakimel\",\"id\":629429,\"node_id\":\"MDQ6VXNlcjYyOTQyOQ==\",\"avatar_url\":\"https://avatars.githubusercontent.com/u/629429?v=4\",\"gravatar_id\":\"\",\"url\":\"https://api.github.com/users/hakimel\",\"html_url\":\"https://github.com/hakimel\",\"followers_url\":\"https://api.github.com/users/hakimel/followers\",\"following_url\":\"https://api.github.com/users/hakimel/following{/other_user}\",\"gists_url\":\"https://api.github.com/users/hakimel/gists{/gist_id}\",\"starred_url\":\"https://api.github.com/users/hakimel/starred{/owner}{/repo}\",\"subscriptions_url\":\"https://api.github.com/users/hakimel/subscriptions\",\"organizations_url\":\"https://api.github.com/users/hakimel/orgs\",\"repos_url\":\"https://api.github.com/users/hakimel/repos\",\"events_url\":\"https://api.github.com/users/hakimel/events{/privacy}\",\"received_events_url\":\"https://api.github.com/users/hakimel/received_events\",\"type\":\"User\",\"user_view_type\":\"public\",\"site_admin\":false},\"node_id\":\"RE_kwDOABxnUs4XCDlO\",\"tag_name\":\"6.0.2\",\"target_commitish\":\"master\",\"name\":\"6.0.2\",\"draft\":false,\"immutable\":false,\"prerelease\":false,\"created_at\":\"2026-09-10T15:08:21Z\",\"updated_at\":\"2026-09-10T15:41:21Z\",\"pub"
|
||||
},
|
||||
{
|
||||
"url": "https://api.github.com/repos/juliangarnier/anime/releases/latest",
|
||||
"final_url": "https://api.github.com/repos/juliangarnier/anime/releases/latest",
|
||||
"status": 200,
|
||||
"bytes": 5227,
|
||||
"sha256": "d98aaa46da832ce755bf0d519c497ff34133e818e7c2febddeb85c898f461b94",
|
||||
"retrieved": "2026-10-21T20:07:31.382151+00:00",
|
||||
"excerpt": "{\"url\":\"https://api.github.com/repos/juliangarnier/anime/releases/342978131\",\"assets_url\":\"https://api.github.com/repos/juliangarnier/anime/releases/342978131/assets\",\"upload_url\":\"https://uploads.github.com/repos/juliangarnier/anime/releases/342978131/assets{?name,label}\",\"html_url\":\"https://github.com/juliangarnier/anime/releases/tag/v4.5.0\",\"id\":342978131,\"author\":{\"login\":\"juliangarnier\",\"id\":1268691,\"node_id\":\"MDQ6VXNlcjEyNjg2OTE=\",\"avatar_url\":\"https://avatars.githubusercontent.com/u/1268691?v=4\",\"gravatar_id\":\"\",\"url\":\"https://api.github.com/users/juliangarnier\",\"html_url\":\"https://github.com/juliangarnier\",\"followers_url\":\"https://api.github.com/users/juliangarnier/followers\",\"following_url\":\"https://api.github.com/users/juliangarnier/following{/other_user}\",\"gists_url\":\"https://api.github.com/users/juliangarnier/gists{/gist_id}\",\"starred_url\":\"https://api.github.com/users/juliangarnier/starred{/owner}{/repo}\",\"subscriptions_url\":\"https://api.github.com/users/juliangarnier/subscriptions\",\"organizations_url\":\"https://api.github.com/users/juliangarnier/orgs\",\"repos_url\":\"https://api.github.com/users/juliangarnier/repos\",\"events_url\":\"https://api.github.com/users/juliangarnier/events{/privacy}\",\"received_events_url\":\"https://api.github.com/users/juliangarnier/received_events\",\"type\":\"User\",\"user_view_type\":\"public\",\"site_admin\":false},\"node_id\":\"RE_kwDOAzUPws4UcW5T\",\"tag_name\":\"v4.5.0\",\"target_commitish\":\"master\",\"name\":\"v4.5.0\",\"draft\":false,\"immutable\":false,\"prereleas"
|
||||
},
|
||||
{
|
||||
"url": "https://slides.com/news/introducing-auto-animate",
|
||||
"error": "HTTP Error 404: Not Found"
|
||||
},
|
||||
{
|
||||
"url": "https://worrydream.com/InventingOnPrinciple/",
|
||||
"final_url": "https://vimeo.com/906418692",
|
||||
"status": 200,
|
||||
"bytes": 12348,
|
||||
"sha256": "a293ee7be369e923ff94eaef5561e3bfb576b115c050e7f75fe8554be98bbbae",
|
||||
"retrieved": "2026-10-21T20:07:32.275437+00:00",
|
||||
"excerpt": ""
|
||||
}
|
||||
]
|
||||
@@ -0,0 +1,53 @@
|
||||
[
|
||||
{
|
||||
"name": "anime-migration",
|
||||
"url": "https://raw.githubusercontent.com/wiki/juliangarnier/anime/Migrating-from-v3-to-v4.md",
|
||||
"bytes": 8213,
|
||||
"sha256": "9ddc9256b288552fb8df27b11cf78f823daa361dcd0805ec40adaf5311300df4"
|
||||
},
|
||||
{
|
||||
"name": "anime-svg",
|
||||
"url": "https://raw.githubusercontent.com/juliangarnier/anime/v4.5.0/examples/svg-line-drawing/index.html",
|
||||
"bytes": 677,
|
||||
"sha256": "55a40b49c677c04204b7ce7528bf3a37e877d4062f7f9fcd50ad6e4167b8d62b"
|
||||
},
|
||||
{
|
||||
"name": "anime-stagger",
|
||||
"url": "https://raw.githubusercontent.com/juliangarnier/anime/v4.5.0/examples/advanced-grid-staggering/index.html",
|
||||
"bytes": 1243,
|
||||
"sha256": "2fb23417e232712aa5ef85e466bb81a4f73ef35e0c671bba0b659ab28f755d2a"
|
||||
},
|
||||
{
|
||||
"name": "anime-logo",
|
||||
"url": "https://raw.githubusercontent.com/juliangarnier/anime/v4.5.0/examples/animejs-v4-logo-animation/index.html",
|
||||
"bytes": 37316,
|
||||
"sha256": "ed989abfde04ecad6df3a0b2c3e74103ee750b1d82f23278b5aa35b1211a80ce"
|
||||
},
|
||||
{
|
||||
"name": "reveal-demo",
|
||||
"url": "https://raw.githubusercontent.com/hakimel/reveal.js/6.0.2/demo.html",
|
||||
"bytes": 22161,
|
||||
"sha256": "50cecf01b7ea14cf25af6849a67b3be0e69f91b693093059adb06305344b4631"
|
||||
},
|
||||
{
|
||||
"name": "svg-line-drawing-js",
|
||||
"url": "https://raw.githubusercontent.com/juliangarnier/anime/2c9cf8ea00329f6768c7d7902252ed977d75ce42/examples/svg-line-drawing/index.js",
|
||||
"bytes": 2353,
|
||||
"sha256": "3bccbd209bff397b5249444e9a313d9f9e482e565bf767c8eb6d1b5d4302e135",
|
||||
"retrieved": "2026-10-21T20:27:02.800745+00:00"
|
||||
},
|
||||
{
|
||||
"name": "advanced-grid-staggering-js",
|
||||
"url": "https://raw.githubusercontent.com/juliangarnier/anime/2c9cf8ea00329f6768c7d7902252ed977d75ce42/examples/advanced-grid-staggering/index.js",
|
||||
"bytes": 2032,
|
||||
"sha256": "7fcf5db00732c9dd2946beb46ccb7f0fbf6f10d62504a42e1e033924cad74e5c",
|
||||
"retrieved": "2026-10-21T20:27:03.439072+00:00"
|
||||
},
|
||||
{
|
||||
"name": "animejs-v4-logo-animation-js",
|
||||
"url": "https://raw.githubusercontent.com/juliangarnier/anime/2c9cf8ea00329f6768c7d7902252ed977d75ce42/examples/animejs-v4-logo-animation/index.js",
|
||||
"bytes": 7471,
|
||||
"sha256": "9e1f69157103ed354222def57ad3dc5a4d6cee606080e0d0064b317a26096191",
|
||||
"retrieved": "2026-10-21T20:27:03.743445+00:00"
|
||||
}
|
||||
]
|
||||
Reference in new issue
Block a user