Internal fixture · /dev/ui

Ara visual foundation

Quiet Confidence translated into tokens, motion, accessibility, workspace resize, and Document/Compare experience grammars.

Kernel V0Grammars R001Fixture

Paper & Graphite R002 tokens

--ara-canvas
--ara-surface
--ara-surface-subtle
--ara-surface-raised
--ara-ink
--ara-ink-muted
--ara-border-subtle
--ara-control-border
--ara-attention
--ara-proven
--ara-danger
--ara-intelligence
--ara-fact
--ara-recommendation
--ara-authority
--ara-evidence
--ara-proof
--ara-needs-you
--ara-freshness
--ara-provenance
--ara-repository-health
--ara-blocked
--ara-execution

Semantic separation (label + icon — not color alone)

Advisory next stepRecommendation only — not a command or authority grant.P2 Locally ProvenProof claim — not progress percent.Declared evidenceEvidence marker — not proof and not authority.Projection freshFreshness of projected state.FixtureFixture — not live repository truth.OBSERVEDObserved only — not success, not LIVE_VERIFIED, not authority.LIVE_VERIFIEDLive-verified against repository truth — still not authority.UNKNOWNProvenance unknown — do not treat as success.STALEStale projection — freshness warning, not success.Needs YouHuman attention required — not a social notification.Notifications (not implemented)Utility placeholder only. Not Needs You. Not authority.
Owner gate required

Display does not grant authority. Ready ≠ executed. Recommendation ≠ command.

Repository healthPaper & Graphite R002 foundation — dark theme remains opt-in
RecommendationAuthorityProofEvidenceFreshnessProvenanceRepository healthNeeds YouSafe continuationBlockedOBSERVEDLIVE_VERIFIEDUNKNOWNSTALE

Paper surfaces

Flat

Shell, rows, and normal sections.

Lifted

Main composer or Needs You sheet.

Overlay

Peek, Command, and Focus.

Graphite edge

One clipped, static treatment for a principal sheet.

Typography + motion

Metadata / mono labels

Compact enterprise clarity

Long-form Research and Spec content is set at a relaxed line height and bounded to approximately sixty-eight characters.

sha256:24b4d0aa818d469c89bd42963fe966ec7113c77f

Motion: 160ms · 220ms · 320ms

Reduced motion is centralized through tokens and `araMotion`.

Controls

A deterministic fixture value.
A digest must be immutable.

Observed evidence.

Overlays

    Feedback

    Fact observed
    The fixture is local and deterministic.
    Owner decision required
    No authority is inferred.
    Foundation proof72%
    Loading evidence fixture
    No evidence yetEvidence appears here after a bounded run.
    SavedWorkspace revision 5
    Save failedDraft remains available.
    Revision 6 is available
    You are still reviewing revision 5.

    R004 object and collaboration specimens

    Make review fast enough for a broker to trust
    Work 028 · Revision 5
    Needs judgment
    Broker review specimenEvidence · Revision 5
    Can you look at the exception order?
    Design specimen · no shared persistenceMaya Chen18mRequests your inputWork 028Work
    unread
    Theo Park10:48humanDesign specimen · no shared persistence
    Keep the source assumption beside each exception.
    Contribution unavailable

    Addressed collaboration is not implemented.

    Workspace foundation

    Foundation candidateFixturePrivate workspace

    Primary canvas

    Long-form work remains calm and readable.

    Neutral resize fixture. Structural slots only — no product navigation, Document/Compare grammar, Identity, or Commons.

    Canonical tokensImplemented
    Inspector resizeAccessible
    Global navigationOpen decision

    Secondary canvas

    neutral-pane-fixtureEvidence distinct
    Inspector
    Candidatepref ara.workspace.inspector.width.v1Drag or keyboard-resize the separator. Preference is local UI convenience only; temporary viewport clamps do not rewrite it.

    Document Workspace grammar

    Fixture state
    Neutral long-form fixtureGrammarNon-authoritative

    Overview

    Neutral document fixture. Structural grammar only — not Research, Spec, Contract, or Review product semantics.

    Context

    Long-form content lives in the primary canvas. Section navigation is document-local and is not global application navigation.

    Constraints

    • No authority mutation in this fixture.
    • Inspector provides generic supporting context.
    • Responsive projection reuses WorkspaceFrame resize.

    Evidence

    Supporting references appear in the inspector slot. This lane does not define evidence domain objects.

    Open Questions

    How later product slices bind domain objects into these slots remains a later lane concern.

    Next Steps

    First product validation target after this grammar settles: Contract Read-Only Review Experience R001.

    Supporting context
    Context slotinspector ≠ evidence domain

    Supporting context only. No provenance, membership, or approval semantics.

    Compare Workspace grammar — 2 candidates

    Neutral two-option fixtureGrammarNon-authoritative
    UI selection only
    Selected for inspection
    Short baseline summary for side-by-side layout.

    Neutral candidate body A. Selection is presentation state only — not a human decision record.

    fixture-a
    Emphasized
    Alternate summary with slightly longer tradeoff text.

    Neutral candidate body B with unequal length versus A.

    Extra paragraph to exercise independent column scrolling without sync scroll (SYNC_SCROLL = DEFERRED).

    Still more content for overflow proof.

    fixture-b

    Tradeoffs slot

    Generic tradeoff notes. Not Decide authority.

    Two-candidate detail
    Detail slotSelected: option-a

    Compare Workspace grammar — 3 candidates

    Neutral A/B/C fixtureGrammar
    Short baseline summary for side-by-side layout.

    Neutral candidate body A. Selection is presentation state only — not a human decision record.

    fixture-a
    EmphasizedSelected for inspection
    Alternate summary with slightly longer tradeoff text.

    Neutral candidate body B with unequal length versus A.

    Extra paragraph to exercise independent column scrolling without sync scroll (SYNC_SCROLL = DEFERRED).

    Still more content for overflow proof.

    fixture-b
    Third bounded candidate.

    Neutral candidate body C. Grammar max is three candidates.

    fixture-c
    Optional evidence slot — non-domain.
    Three-candidate detail
    Selected: option-b

    Compact view uses segmented candidate switching.