Try a lesson

Identity

Use when

• The Academy page. Why: Trying one lesson shows how the Academy teaches with the system's own rules.

Do not use when

• To certify anyone. Why: Certificates come from the Academy in the reader's repository, not this sample.

Anatomy

Made of: showcase-frame, code-block, control, caption.

Used in: pages directly.

Variants

States

Tokens

Layout

Spacing and rhythm

Motion

Runtime and reuse

1. stylesheet: /css/site.css. Built Site tokens, core and registered element CSS; preserve modes, focus and responsive rules.

2. stylesheet: /css/demos.css. Existing legacy demo styles where the rendered specimen uses them.

3. font: /fonts/. Self-hosted files referenced by Site @font-face, with licences; Japanese locale overrides remain applicable.

4. Static fallback: Original build-time specimen remains readable before loading and after chunk/initialization failure; enhancement controls retain authored hidden state.

5. Configured initializer: scripts/site/academy/try-lesson.client.ts#init. The host owns transactional static-markup restoration and runtime state.

6. Consumer module (imports relative to the configured source root):
   import { createRuntimeHost } from "./src/workflows/runtime-host";
   import { SITE_RUNTIMES } from "./apps/showcase/site/runtime-registry";
   const definition = SITE_RUNTIMES.find(entry => entry.binding.id === "academy-lesson");
   if (!definition || definition.binding.lifecycle.kind !== "managed") throw new Error("Managed runtime binding unavailable");
   const host = createRuntimeHost([definition]);
   export function mountRuntime(container: ParentNode) { return host.mountAll(container); }

7. After inserting the rendered markup, call mountRuntime(container) for the container holding [data-demo="academy-lesson"]. Retain the returned disposal function and call it before removing, replacing or remounting, including every Storybook args render. The configured host restores captured static markup/attributes on disposal or caught load/initialization failure; retry starts a fresh managed remount.

Accessibility passport

Content

Good: “Not yet: primitives skip the role. Use --semantic-text so a theme change reaches this text.”

Bad: “Wrong!”

Japanese: The lesson is English; the Academy page says so in Japanese.

Icons and illustrations

None: this element uses no icon or illustration of its own.

Decisions and exceptions

• D-SITE-008: One ShowcaseFrame for every self-playing element

Usage

27 uses across the built pages (measured by npm run site:system).

Tests

Figma

not-yet: The Loom Site Figma library is the last stage of the plan; this element is not mapped yet.

Open in Storybook