Source and runtime reference

Run an exact Hara source revision in a named session.

A session is one identifiable runtime context with a generation, requested and actual backend, source revision, capabilities, events, diagnostics, and result records. The Playground keeps those facts beside the editor rather than treating execution as an unlabelled preview.

Open the ribbon-field example View available samples Read the embed contract

docs.live-example@2.1.0 learn.exercise@2.0.0 learn.project@2.0.0

Samples and repository source

Choose a sample or load exact repository coordinates.

A sample record names its source revision, backend, required capabilities, and current availability. Experienced users and agents may enter repository coordinates directly.

01RunOpen the documented sample without creating an account or focusing the editor. 02EditOpen source beside its result, diagnostics, and session facts. 03BrowseCompare samples by language concept, runtime, and required capabilities.

Canvas exampleavailable

Ribbon signal field

Run a Canvas sample, change trail width, and inspect the exact mutation receipt.

evalcancelcanvasobservations

Runtime event exampleavailable

Session event microscope

Follow monotonic lifecycle and value observations across restart and replacement.

evalrestartobservationsdiagnostics

WebGL exampleavailable

Material and shader study

Edit source beside a progressive WebGL preview with a labelled static fallback.

evalcanvaswebglfallback

Work algebra examplebackend unavailable

Durable work receipt

Model replayable work and checkpointed steps, then inspect the resulting receipt.

filesworkreceipts

Recent sessionsBrowser-local until saved

12 minutes ago
Yesterday
3 days ago

Coding workspace

Source, result, diagnostics, and session facts share one workspace.

Dense and comfortable modes change spacing only. The control pane is optional and dismissible; runtime identity and capability facts remain available.

Primary surface · unified live session

One studio, five operational modes.

The editor stays primary while project navigation, controlled front matter, canvas output, and observations remain attached to the same session envelope.

Ready session:pg-7a91 gen 4 rev 9f3c2ab7 seq 148

Repositoryhara-lang/hara-playground

Exact source

Repository: hara-lang/hara-playground
Branch: main
Path: samples/supersonic-live/main.hara
Revision: 9f3c2ab7

Changing branch, path, or revision requests a replacement session. It never mutates the current fenced session in place.

main.hara

HaraUTF-8Ln 1, Col 1

latest · seq 148

Signal field ready 12 ribbons · 4 anchors · 0 dropped observations

{:status :ready
 :backend :interpreter
 :frames 2814
 :receipt "runtime:exec-2048"}

143lifecycleevaluation acceptedsource 9f3c2ab7
144canvas.framefirst frame presented16.8 ms
145canvas.framesteady state59.8 fps
146runtime.value:ribbon-count 12structured
147runtime.receiptexec-2048 committeddurable
148lifecyclereadygeneration 4

warning · schema-argument-mismatchmain.hara:18:7

:trail-width expects a number between 0 and 1; the current value is clamped for preview.

Stack trace

at ribbon/options       main.hara:18:7
at scene/build          scene.hara:42:3
at playground/evaluate runtime:pg-7a91

Environment

Live controls

4 groups

Restart advances generation. Replacement creates a newly fenced session. Disposal is terminal and idempotent.

hara.lock runtime-owned dependency lock controlled read only

Writable source files are distinct from runtime-owned lock and receipt material.

Capability unavailable

No 3D provider in this session.

The interpreter session did not advertise three-d.scene, three-d.camera, or three-d.selection. The studio does not manufacture disabled controls that imply support.

Console / observationsmonotonic sequence

146runtime.value:ribbon-count 12generation 4
147runtime.receiptexec-2048 committedsource 9f3c2ab7
148lifecyclereadyinterpreter

Density is presentation state. Session, source, backend, capability, diagnostic, and receipt facts remain unchanged.

Documentation and product embeds

The same live-example contract at two useful scales.

Inline examples keep the document primary. Expanded embeds can reveal files and sessions, but Canvas and 3D remain absent unless the exact example advertises them.

docs.live-example Transform one value documentation-sized · editable

Open in Playground ↗

(defn ribbon-field
  [{:keys [count width decay]
    :or   {count 12 width 0.42 decay 0.18}}]
  (canvas/field
    {:ribbons count
     :trail-width width
     :signal-decay decay
     :palette :hara/signal}))

Idle

{:status :idle
 :result nil}

session:embed-inline generation:1 source:9f3c2ab7 backend:interpreter

Capabilities unavailable

Run remains useful without a fabricated control pane.

This documentation example advertises evaluation, cancellation, and structured values. It does not advertise Canvas, 3D, filesystem mutation, or package publication.

eval.form: available
session.cancel: available
canvas.controls: unavailable
three-d.scene: unavailable

Expanded embed

Editable project example with optional live controls.

Open in Playground

example.haraeditable · source revision 9f3c2ab7

Resultready

{:status :ready
 :value {:ribbons 12}
 :receipt "runtime:embed-0037"}

The document owns surrounding explanation. Playground owns editor composition. Runtime owns lifecycle facts and receipts.

Sharing and embedding

Links include repository, branch, path, revision, requested backend, and editability. Runtime receipts remain references to runtime-owned facts.

Generated integration code

<hara-live-example
  content-id="hara:docs:live-example:ribbon-field"
  repo="hara-lang/hara-playground"
  branch="main"
  path="samples/supersonic-live/main.hara"
  revision="9f3c2ab7"
  backend="interpreter"
  editable
  controls="sessions,files">
</hara-live-example>

The host may request controls and editability. The runtime response determines the actual backend, capabilities, source fence, and receipt.

Portable Hara publication form

{:schema hara.docs/live-example
 :schema-version "2.1.0"
 :content-id "hara:docs:live-example:ribbon-field"
 :source {:repo "hara-lang/hara-playground"
          :branch "main"
          :path "samples/supersonic-live/main.hara"
          :revision "9f3c2ab7"}
 :runtime {:backend :interpreter
           :capabilities [:eval :cancel :canvas :observations]}}

Mobile and touch

Run first. Edit only when requested.

The initial Run action keeps the software keyboard closed. Text input focus is granted only by the explicit Edit control.

‹

Ribbon fieldinterpreter · ready

main.hararev 9f3c2ab7gen 4

(defn ribbon-field
  [{:keys [count width decay]
    :or   {count 12 width 0.42 decay 0.18}}]
  (canvas/field
    {:ribbons count
     :trail-width width
     :signal-decay decay
     :palette :hara/signal}))

Read-only until Edit

ResultReady

{:ribbons 12
 :frames 2814
 :status :ready}

1 diagnostic · inspect without page overflow

main.hara:18:7 Trail width was clamped to the supported preview range.

Initial action

Run does not focus the editor.

Execution updates the result and status region while preserving the current viewport and closed keyboard.

Explicit input

Edit unlocks and focuses source.

The focus transition is intentional, user-triggered, and reversible by leaving edit mode.

Collapse order

Optional Canvas and 3D controls disappear first.
Files and Sessions move into a bottom sheet.
Result follows the editor in document order.
Diagnostics remain scrollable inside their own region.

Touch contract

Transport remains one-thumb operable.

Run, Cancel, Edit, and disclosure controls retain at least 44px touch height without forcing horizontal page overflow.

Ownership and adoption

The interface presents runtime state; it does not author runtime facts.

Visual Language

Workbench geometry, tabs, controls, responsive yielding, status presentation, focus treatment, and capability-aware slot composition.

Public Playground

Repository loading, project navigation, editor state, saved sessions, account behaviour, sharing policy, and application commands.

Docs embed

Surrounding explanation, live-example placement, read-only or editable request, expansion control, and open-in-Playground handoff.

Runtime

Session identity, generation, source revision, backend, capabilities, monotonic events, replacement, cancellation, disposal, observations, and receipts.

See the front-matter contract, the workbench reference, and V2-PLAYGROUND.md for the implementation boundary.

Browse the visual language

Run an exact Hara source revision in a named session.

Choose a sample or load exact repository coordinates.

Ribbon signal field

Session event microscope

Material and shader study

Durable work receipt

Source, result, diagnostics, and session facts share one workspace.

One studio, five operational modes.

Author intent beside controlled runtime facts.

The same live-example contract at two useful scales.

Run remains useful without a fabricated control pane.

Editable project example with optional live controls.

Run first. Edit only when requested.

Run does not focus the editor.

Edit unlocks and focuses source.

Transport remains one-thumb operable.

The interface presents runtime state; it does not author runtime facts.

Run an exact Hara source revision in a named session.

Ribbon signal field

Session event microscope

Material and shader study

Durable work receipt

Author intent beside controlled runtime facts.

Run remains useful without a fabricated control pane.

This project has no public route.

Revision 72aa901 is no longer current.

Run does not focus the editor.

Edit unlocks and focuses source.

Transport remains one-thumb operable.