Reference · System library

Motion explains state, or it is removed.

Thirty-three governed interaction mechanics used across Brittek surfaces — each with an intent, a production use and a reduced-motion end state.

33 primitives · 6 groups · autoplay off · reduced-motion parity

Functional library

Thirty-three mechanics, shown as working specimens.

Navigation

04 specimens

Underlay navigation

move · transform + opacity · physical

No. 01360 ms--motion-revealorientationRM · Immediate surface displacement.

StudioCapabilitiesSystems

Surface

The page moves. The menu stays.

Cover index

cover · none · native dialog

No. 02No travelno easingRM · Dialog opens in final state.

*

Command palette

cover · none · selection swaps

No. 21No travelno easingRM · Palette opens in final state.

ESC
ARROWS / MOVE · ENTER / SELECT · ESC / CLEAR

Disclosure

07 specimens

Plus morph

inline · rotate · state

No. 03140 ms--motion-navinterfaceRM · Glyph changes without travel.

Text morph

inline · translateY · state

No. 04140 ms--motion-navinterfaceRM · Label swaps immediately.

Dot field

bounded · transform + opacity · proximity

No. 05No travellinear interpolationRM · Loop never starts under reduced motion; decorative aria-hidden field.

Transform + opacity via one scalar. Loop on pointer only; settles ~640ms. Touch inert. Decorative.

Measured disclosure

inline · height · physical

No. 16360 msorientationRM · Panel snaps to final height.

Height is measured from real content, animated once, then released back to auto. The panel never guesses a maximum height.

Accordion

inline · content clip + opacity · enter

No. 22360 ms--motion-revealorientationRM · Layout settles immediately.

Observed · deterministic · inferred · reviewed · recommended.

Inspector panel

float · opacity + transform · enter

No. 23140 ms--motion-navorientationRM · Panel appears immediately.

A float-class inspector leaves the surrounding surface readable. It does not take modal ownership.

Tooltip

float · opacity + transform · hover

No. 24120 ms--motion-disclosureinterfaceRM · Tooltip appears without travel.

0–100 · deterministic

State

08 specimens

Surface switch

bounded · colour + transform · state

No. 06120 ms--motion-disclosureinterfaceRM · Surface switches immediately.

Paired runtime state

inline · none · state text swaps

No. 07No travelno easingRM · Text state changes only.

Dual-layer rollover

inline · translateY + skew reset · hover

No. 15120 ms--motion-disclosureorientationRM · Static label remains.

Measured sliding tabs

bounded · width + transform · state

No. 17140 ms--motion-navinterfaceRM · Selected tab changes immediately.

Architecture and system structure.

Execution sequencer

bounded · none · direct state selection

No. 20No travelno easingRM · Direct deterministic selection.

RESTSTATE 01 / IDLE

Filter chips

bounded · none · result set swaps

No. 25No travelno easingRM · Result set changes immediately.

001 · Brittek Surface
002 · Machine Surface Inspector
003 · Brittek Identity
3 records

Table sort

bounded · indicator rotate · state

No. 26140 ms--motion-navinterfaceRM · Rows reorder immediately.

Agent Infrastructure2024
Brittek Surface2026
Motion Framework2025

Progression

06 specimens

Step sequence

bounded · indicator transform · state

No. 09140 ms--motion-navinterfaceRM · Active step changes immediately.

Live build record

bounded · wave assembly · enter

No. 10360 ms--motion-revealorientationRM · Resolved field remains visible.

Progress carousel

bounded · translateX + progress · enter

No. 18360 ms--motion-revealorientationRM · Manual step change only.

01 / Evidence

Show the reason before the claim.

Skeleton to content

bounded · opacity · enter

No. 30360 ms--motion-revealorientationRM · Loaded content replaces placeholder.

Brittek Surface · governed routes · machine-readable outputs.

Counter reel

bounded · numeric count · enter

No. 31360 ms--motion-revealease-out cubicRM · Final value renders directly.

Assembly sequence

bounded · transform + opacity · physical · 900ms / 42ms stagger

No. 33900 msease-out cubicRM · Jumps to resolved under reduced motion; scrub remains the source of truth.

One scalar · 900ms physical · 42ms stagger · not a preloader.

Transition

05 specimens

Masked reveal

bounded · clip-path + transform · enter

No. 11360 ms--motion-revealorientationRM · Content stays visible.

Systems, not disconnected deliverables.

Typographic drift

bounded · opacity + translateX · cinema

No. 12720 ms2 × --motion-revealorientationRM · Complete phrase rendered.

Synthesis&Reduction.

Arrival

bounded · opacity + translateY · enter

No. 13720 ms2 × --motion-revealorientationRM · Identity is present immediately.

Bounded curtain

bounded · clip-path + transform · state

No. 14480 msROUTE_CURTAINGSAP power4.inOutRM · Target view switches directly.

Specimen / bounded public-shell curtain
ROUTE

Cross-dissolve

bounded · opacity · state

No. 32360 ms--motion-revealinterfaceRM · View swaps immediately.

Paper
Instrument

Feedback

03 specimens

Notice

float · opacity + translateY · enter/state

No. 27360 ms--motion-revealorientationRM · Notice appears/disappears directly.

Field registered. Evidence surface updated.

Copy confirmation

inline · none · status label swaps

No. 28No travelno easingRM · Confirmation text changes only.

https://brittek.net/llms.txt

Validation

inline · clip-path + opacity · state

No. 29140 ms--motion-navorientationRM · Error is visible immediately.

Inventory · tokens · rules

Specification

Full inventory33 primitives · 6 groups

Navigation

04 primitives

Underlay navigation, measured local navigation and command-style indexes.

No.PrimitiveDurationEasingReduced motionProduction use
01Underlay navigationtransform + opacity · physical360 ms--motion-revealorientationImmediate surface displacement.Primary site navigation.
02Cover indexnone · native dialogNo travelnative dialog; opens in final state—Dialog opens in final state.Command and reference overlays only.
19Measured nav shellheight · physical360 msmeasured heightorientationMenu snaps open/closed.Secondary local navigation.
21Command palettenone · selection swapsNo travelselection moves without travel—Palette opens in final state.Reference and internal operating surfaces.

Disclosure

07 primitives

Plus/text morphs, proximity fields, measured short panels, accordions, inspectors and tooltips.

No.PrimitiveDurationEasingReduced motionProduction use
03Plus morphrotate · state140 ms--motion-navinterfaceGlyph changes without travel.Compact disclosure controls.
04Text morphtranslateY · state140 ms--motion-navinterfaceLabel swaps immediately.Paired open/close controls.
05Dot fieldtransform + opacity · proximityNo travelpointer-driven; per-frame lerp 0.22linear interpolationLoop never starts; grid at rest.Pointer-proximity matrix specimens; bounded fields — not ambient page chrome.
16Measured disclosureheight · physical360 msmeasured height, then released to autoorientationPanel snaps to final height.Short isolated disclosure shells.
22Accordioncontent clip + opacity · enter360 ms--motion-revealicon 140ms; layout settles firstorientationLayout settles immediately.Nested evidence/reference material.
23Inspector panelopacity + transform · enter140 ms--motion-navorientationPanel appears immediately.Bounded inspection detail.
24Tooltipopacity + transform · hover120 ms--motion-disclosureinterfaceTooltip appears without travel.Short technical definitions.

State

08 primitives

Surface roles, runtime notation, ledger feedback, tabs, filters and sorting.

No.PrimitiveDurationEasingReduced motionProduction use
06Surface switchcolour + transform · state120 ms--motion-disclosureinterfaceSurface switches immediately.Editorial/instrument comparisons.
07Paired runtime statenone · state text swapsNo travelstate text swaps—Text state changes only.Machine state notation.
08Ledger rowtranslateX · hover120 ms--motion-disclosureinterfaceStatic focus treatment.Records and system indexes.
15Dual-layer rollovertranslateY + skew reset · hover120 ms--motion-disclosureorientationStatic label remains.Primary and secondary controls.
17Measured sliding tabswidth + transform · state140 ms--motion-navinterfaceSelected tab changes immediately.Mode and surface selectors.
20Execution sequencernone · direct state selectionNo travelrange input selects state directly—Direct deterministic selection.Runtime/state demonstrations.
25Filter chipsnone · result set swapsNo travelresult set swaps—Result set changes immediately.Archive and evidence filters.
26Table sortindicator rotate · state140 ms--motion-navinterfaceRows reorder immediately.Technical tables.

Progression

06 primitives

Step sequences, the live build record, carousels, sequencers, loading, finite counters and assembly.

No.PrimitiveDurationEasingReduced motionProduction use
09Step sequenceindicator transform · state140 ms--motion-navinterfaceActive step changes immediately.Process and diagnostic sequences.
10Live build recordwave assembly · enter360 ms--motion-reveal+ 42ms stagger per columnorientationResolved field remains visible.Live build records.
18Progress carouseltranslateX + progress · enter360 ms--motion-revealprogress bar 140ms linearorientationManual step change only.Bounded editorial sequences; autoplay opt-in.
30Skeleton to contentopacity · enter360 ms--motion-revealorientationLoaded content replaces placeholder.Bounded loading states; the MarkLoader (No. 13 Arrival, brtk.) appears only after a genuine 300ms wait; no shimmer loops.
31Counter reelnumeric count · enter360 ms--motion-revealfinite count, requestAnimationFrameease-out cubicFinal value renders directly.Finite measured score/state changes.
33Assembly sequencetransform + opacity · physical · 900ms / 42ms stagger900 ms+ 42ms stagger · 12 nodesease-out cubicJumps to resolved; scrub still works.Authored specimens / finite figure resolve — never route preloaders.

Transition

05 primitives

Masked reveals, typographic continuity, arrivals, bounded curtains and same-box dissolves.

No.PrimitiveDurationEasingReduced motionProduction use
11Masked revealclip-path + transform · enter360 ms--motion-revealorientationContent stays visible.Selected editorial arrivals.
12Typographic driftopacity + translateX · cinema720 ms2 × --motion-reveal+ 60ms stagger per wordorientationComplete phrase rendered.Short authored display moments.
13Arrivalopacity + translateY · enter720 ms2 × --motion-reveal360ms identity, then 360ms registerorientationIdentity is present immediately.Bounded identity/runtime specimen; the MarkLoader (components/motion/Arrival) after a genuine 300ms wait, once, no loop.
14Bounded curtainclip-path + transform · state480 msROUTE_CURTAIN220ms enter + 260ms exitGSAP power4.inOutTarget view switches directly.Specimen only since APPEARANCE-03A (2026-10-18): a paper-panel wipe documented at 220ms enter + 260ms exit. Route changes no longer use it; they fade the committed route in over --motion-nav.
32Cross-dissolveopacity · state360 ms--motion-revealinterfaceView swaps immediately.Same-box representation changes.

Feedback

03 primitives

Notices, copy confirmation and deterministic validation.

No.PrimitiveDurationEasingReduced motionProduction use
27Noticeopacity + translateY · enter/state360 ms--motion-revealorientationNotice appears/disappears directly.Completion and system feedback.
28Copy confirmationnone · status label swapsNo travellabel swaps; clears after 1600ms—Confirmation text changes only.Machine-resource copy controls.
29Validationclip-path + opacity · state140 ms--motion-navorientationError is visible immediately.Forms and instrument inputs.

Timing tokens

TokenValueRole
--motion-hover60msHover colour and underline changes.
--motion-press70msPressed state.
--motion-focus80msFocus ring arrival.
--motion-disclosure120msSmall state changes: switches, ledger rows, tooltips.
--motion-nav140msIndicators, icons and short panels.
--motion-reveal360msContent arrival and measured height; the production ceiling.
--ease-interfacecubic-bezier(0.2, 0, 0, 1)State changes on controls.
--ease-orientationcubic-bezier(0.22, 1, 0.36, 1)Arrivals and spatial orientation.

Operating rules

  1. State before spectacle. Explain state, hierarchy, orientation, progress, feedback or completion.

  2. Static first. Server-rendered content is complete before enhancement; motion never hides it.

  3. Local causality. A control animates the surface it changes; routes use one curtain.

  4. Bounded duration. Production uses role tokens; long motion stays in authored specimens.

  5. Reduced-motion parity. Same information and end state, without travel, loops or forced timing.

  6. No ambient loops. No marquees, shimmer, cursor theatre or competing decorative motion.

Operational motion

The live build record is the system-state example.

Architecture stays readable at rest. When execution is invoked, one route carries activity and resolves to a stable state — the existing production field renderer, not a second implementation.

Existing renderer · bounded route state · reduced-motion parity
Live adoption

The reference is already connected to production surfaces.

Selected mechanics only where they improve state legibility, orientation, evidence handling or operational feedback.

01

Flagship live build record and user-invoked Human/Machine Surface Switch only; commercial content stays static.

02

Counter reel on progress and scores; Human/Machine switch; validation and evidence disclosures.

03

Live build record scroll-trigger that resolves at rest; operational field choreography.

04

Sliding practice selection, bounded execution fields and state-led practice switching.

05

Filter-chip state, evidence disclosure, ledger hover/focus and copy confirmation.

06

Evidence navigation into the governed interaction registry.

07
Bounded route curtain

Public-shell route changes; specification in primitive 14.