Playground runtime controls
commands ≠ state Ready Filesystem connecting Network unavailable
Buttons express requested commands. Status records express actual fenced runtime state.
Issue 102 · meaning before glyph
One semantic name, one shape, and a visible boundary.
Hara symbols identify navigation, commands, state, runtime capabilities, products and evidence. They stay monochrome by default, inherit current colour, and keep unfamiliar, destructive, capability and authority meaning supported by ordinary text.
01 · Geometry
Compact symbols are drawn for compact use.
The public contract supports 16, 20, 24 and 32 pixel optical sizes. Stroke weight changes slightly at each size while the shared 24 × 24 geometry, rounded joins and currentColor delivery remain stable.
One meaning across four optical sizes
16px20px24px32px
Large illustrations should compose symbols with labels and evidence rather than stretching a compact control glyph into a product logo.
02 · Semantic inventory
Each symbol has one recorded semantic role.
Every symbol has a stable family-prefixed identifier, label, usage boundary, and text rule. Select a specimen to inspect its public metadata; the application still decides whether a command, capability, or state exists.
Navigation and location
Movement, search, hierarchy and external destinations. Familiar navigation symbols may be icon-only when the control has an accessible name.
8 symbols Actions
Immediate commands and explicit mutations. Unfamiliar and destructive actions retain visible text; icon-only controls still require an accessible name.
14 symbols State
Runtime, evidence and lifecycle states expressed with words and non-colour cues. State symbols always accompany a visible state label.
14 symbols Runtime capabilities
Host and provider capabilities available to a running Hara environment. Capability symbols remain text-supported because availability and authority are product facts.
13 symbols Products
Labelled Hara product marks for navigation and adoption guidance. Product symbols never replace the product name.
8 symbols Authority and evidence
Source, revision, registry, observation, receipt and accountable ownership. Evidence symbols remain adjacent to exact authority and revision text.
8 symbols 03 · Route compositions
Symbols accompany route labels and state; they do not replace them.
These compositions use realistic Hara actions, capabilities, states, products and evidence. The visible words remain authoritative for the reader, while products continue to own commands, permissions, lifecycle, data and moderation.
Capability pane
provider authority Session Filesystem Canvas Audio 3D External provider
The glyph identifies the capability class. The host and evidence fence determine availability.
Specs and Packages lifecycle
text-supported consequence Deprecated Superseded by 0.9.0 Partial compatibility
Destructive and publication actions keep visible labels, consequence and authority context.
Products and accountable identity
labels stay visible WWW Docs Benchmarks Playground Specs Packages World Learn
@release-bot
Owned by @mina · present owner verified
Owned by @mina · present owner verified
@mina
Maintainer evidence: namespace std.work@af6273c
Maintainer evidence: namespace std.work@af6273c
Product and ownership symbols are never unexplained standalone pictograms.
Docs and Benchmarks evidence
exact facts adjacentSource
hara-lang/hara/runtime/haraExact revision
ce4139f1e7a7b0fdRuntime observation
session-01J… · generation 7Receipt
benchmark-receipt-0184The symbol points to a class of evidence; exact source, revision, session and receipt text carries the fact.
Missing and incomparable evidence
not zero · not failure Sample count missing Different methodology Observation stale 3 of 5 targets
Evidence gaps remain explicit and cannot collapse into successful zero values or generic errors.
04 · Accessible inventory
The table is the complete non-visual contract.
Decorative SVGs are hidden when adjacent text already carries meaning. Informative standalone symbols receive a concise label. Icon-only controls put the accessible name on the button or link, not on competing nested elements.
| Identifier | Label | Family | Text | Tone | Interactive | Usage boundary |
|---|---|---|---|---|---|---|
nav-home | Home | navigation | optional | current | Yes | Return to the product or catalogue home. |
nav-back | Back | navigation | optional | current | Yes | Move to the previous location or step. |
nav-forward | Forward | navigation | optional | current | Yes | Move to the next location or step. |
nav-menu | Menu | navigation | optional | current | Yes | Open a bounded navigation disclosure. |
nav-section | Section | navigation | optional | current | Yes | Identify a local section or outline destination. |
nav-external | External destination | navigation | required | current | Yes | Open a destination controlled outside the current product. |
nav-search | Search | navigation | optional | current | Yes | Find content or resources within the named scope. |
nav-breadcrumb | Breadcrumb context | navigation | required | current | No | Expose hierarchy and current location. |
action-run | Run | action | optional | signal | Yes | Start the selected program or work item. |
action-stop | Stop | action | required | current | Yes | Request an active operation to stop. |
action-restart | Restart | action | required | current | Yes | Replace or restart the current generation. |
action-evaluate | Evaluate | action | required | signal | Yes | Evaluate the selected Hara form. |
action-edit | Edit | action | optional | current | Yes | Enter an explicit editing mode. |
action-save | Save | action | optional | current | Yes | Persist the current author-owned change. |
action-copy | Copy | action | optional | current | Yes | Copy an exact value, source form or revision. |
action-inspect | Inspect | action | optional | current | Yes | Open evidence or properties for the selected value. |
action-attach | Attach | action | required | current | Yes | Attach an available capability or resource. |
action-detach | Detach | action | required | current | Yes | Detach a capability or resource without implying disposal. |
action-publish | Publish | action | required | signal | Yes | Submit author intent to the controlling publication authority. |
action-approve | Approve | action | required | success | Yes | Record an explicit positive review decision. |
action-reject | Reject | action | required | danger | Yes | Record an explicit negative review decision. |
action-revoke | Revoke | action | required | danger | Yes | Remove previously granted authority or availability. |
state-ready | Ready | state | required | success | No | Available and ready for the named operation. |
state-busy | Busy | state | required | signal | No | Actively processing and not yet terminal. |
state-connecting | Connecting | state | required | signal | No | Attempting to establish a named connection. |
state-connected | Connected | state | required | success | No | Connection established under the named capability fence. |
state-warning | Warning | state | required | warning | No | Attention is required but the path may remain usable. |
state-error | Error | state | required | danger | No | The named operation failed with evidence. |
state-unavailable | Unavailable | state | required | current | No | The capability or fact is not currently available; this is not automatically failure. |
state-disabled | Disabled | state | required | current | No | The action exists but cannot currently be invoked. |
state-stale | Stale | state | required | warning | No | The fact exists but its revision or observation window is no longer current. |
state-partial | Partial | state | required | warning | No | Only a named subset of the expected evidence or capability is present. |
state-missing | Missing | state | required | current | No | Required evidence is absent and must not become a zero value. |
state-incomparable | Incomparable | state | required | current | No | Values cannot be compared under the current method or evidence fence. |
state-deprecated | Deprecated | state | required | warning | No | Available for compatibility but scheduled for replacement. |
state-superseded | Superseded | state | required | current | No | Replaced by a named newer identity or revision. |
capability-session | Session | capability | required | current | No | An isolated or shared Hara evaluation session. |
capability-filesystem | Filesystem | capability | required | current | No | File and directory access under a named mount and authority. |
capability-network | Network | capability | required | current | No | Network access under explicit host policy. |
capability-process | Process | capability | required | current | No | Process execution or supervision under an execution host. |
capability-timer | Timer | capability | required | current | No | Clock, delay or scheduling capability. |
capability-message | Message | capability | required | current | No | Message, queue or mailbox delivery capability. |
capability-transaction | Transaction | capability | required | current | No | Atomic storage or effect boundary. |
capability-canvas | Canvas | capability | required | current | No | Two-dimensional visual output and interaction surface. |
capability-audio | Audio | capability | required | current | No | Audio graph, playback or analysis capability. |
capability-3d | 3D | capability | required | current | No | Three-dimensional scene or rendering capability. |
capability-camera | Camera | capability | required | current | No | Camera input under explicit device permission. |
capability-microphone | Microphone | capability | required | current | No | Microphone input under explicit device permission. |
capability-provider | External provider | capability | required | current | No | A capability implemented by a named external provider. |
product-www | WWW | product | required | current | No | Public Hara language and ecosystem site. |
product-docs | Docs | product | required | current | No | Guides, reference and executable documentation. |
product-benchmarks | Benchmarks | product | required | current | No | Reproducible performance evidence. |
product-playground | Playground | product | required | current | No | Runnable samples and live Hara workspaces. |
product-specs | Specs | product | required | current | No | Executable standards, checking and conformance. |
product-packages | Packages | product | required | current | No | Package discovery, namespace stewardship and publication. |
product-world | World | product | required | current | No | Community reading, feeds, discussion, presence and profiles. |
product-learn | Learn | product | required | current | No | Curriculum, lessons, practice and progress. |
evidence-source | Source | evidence | required | current | No | The source repository, file or content identity. |
evidence-revision | Exact revision | evidence | required | current | No | An immutable source, runtime, registry or fixture revision. |
evidence-registry | Registry | evidence | required | current | No | A registry-controlled identity or publication fact. |
evidence-observation | Runtime observation | evidence | required | current | No | A fact observed from a fenced runtime session and generation. |
evidence-receipt | Receipt | evidence | required | current | No | A durable result, publication or effect receipt. |
evidence-external-authority | External authority | evidence | required | current | No | A fact controlled outside the current product. |
evidence-owned-bot | User-owned bot | evidence | required | current | No | Automation visibly accountable to its present owner. |
evidence-maintainer | Verified maintainer | evidence | required | current | No | A maintainer identity supported by exact stewardship evidence. |
05 · Adoption
Pin the merged contract; keep product meaning downstream.
A downstream adoption uses public identifiers, preserves visible text and accessibility, and pins a merged Visual Language revision. It does not copy SVG paths, redefine protected tokens, or transfer command, capability, lifecycle, ownership or evidence authority into this package.
Shared package owns
visual contractSemantic identifiers, family classification, line geometry, optical sizes, currentColor, accessibility defaults, shared presentation and the deterministic reference inventory.
Public manifestMerged revision
Product owns
facts and behaviorCommands, capabilities, permissions, lifecycle, moderation, publication rules, product labels, identity, evidence, persistence and telemetry.
Provider availabilityRegistry authority