Reference

Source map

Where the reusable mechanisms described in these docs live in the Mora repository, and how the systems are layered.

On this page

Framework entry points
System layers
Examples

This map helps a technical reader locate the reusable mechanisms described in these docs within the Mora repository.

Framework entry points

Paths are repository-relative.

Subject	Entry points	Read with
Temporal values and queries	`src/core/time.lisp`, `src/core/event.lisp`, `src/core/pattern.lisp`, `src/core/combinators.lisp`	Patterns and time, Common Lisp and CLOS
Runtime and scheduling	`src/runtime/transport.lisp`, `src/runtime/channel.lisp`, `src/runtime/api.lisp`, `src/runtime/backend.lisp`	Channels, tempo, and transport
DSL and metrical composition	`src/mini/`, particularly literals, notation, transforms, harmony, metrical and step operations	Pattern literals, Mini notation, Authored meter and pacing
Audio descriptions and output	`src/audio/`, `src/backends/superdirt/`, `supercollider/SuperDirtMora/`	From pattern to audio, SuperDirtMora companion
Sample discovery and general library workflows	`src/samples/`, `src/samples-import/`, `src/stems/import.lisp`, `src/mini/loop-library.lisp`, `src/mini/stem.lisp`	Samples and slicing, Stems and sample libraries
Stem lanes, families, and source selection	`src/mini/stem-stack.lisp`, `src/mini/stem-stack-runtime.lisp`, `src/mini/loop-families.lisp`, `src/mini/loop-session.lisp`, `src/mini/loop-tag-filter.lisp`	Stems and sample libraries
Tempo and key matching policy	`src/mini/loop-match.lisp`, `src/mini/loop-target-policy.lisp`	Tempo and key matching
Samples pane: model, insertion, and rendering	`src/samples-studio/sample-browser.lisp`, `src/samples-studio/insertion.lisp`, `src/samples-studio/sample-waveform.lisp`, `src/studio/commands-sample-browser.lisp`, `src/studio/render-sample-browser.lisp`	Samples inspector
Learned retrieval and pairing	`scripts/audio-analysis/`, `src/mini/stem-embeddings.lisp`	Learned search, PHALAR stem pairing
PHALAR mix requests and inline editor recommendations	`src/mini/stem-context.lisp`, `src/analysis/mixture-context.lisp`, `src/samples-studio/stem-suggestions.lisp`, `src/studio/stem-suggestions-inline.lisp`	PHALAR stem pairing
Generic visual composition	`src/visual/emitter.lisp`, `src/visual/post-model.lisp`, `src/visual/post-backend.lisp`	Shader composition, Ordered post-processing
Measured signal integration	`src/analysis/`, `src/runtime/orbit-taps.lisp`	Machine listening
Studio model and assistance	`src/studio/` buffer, syntax, keymap, eval, documentation, inspector, and control modules	Studio overview
Build and dependency declarations	`mora.asd`, `qlfile`, `Makefile`	Installation and setup

A file or directory reference identifies where to investigate a mechanism; it is a pointer, not a list of what a release contains.

System layers

The systems are deliberately layered:

Text

mora/core          temporal values, events, retained pattern protocol
  mora/runtime     transport, channels, scheduling, backend protocol
    mora/mini       terse livecoding language
    mora            user facade

optional clients and adapters
  mora/superdirt    timestamped sound output
  mora/audio       prepared audio/control descriptions
  mora/samples*    discovery, cache, control, import, audition, Studio glue
  mora/visual      visual operators and native GL renderers
  mora/analysis    cl-mltk integration
  mora/link        Link integration
  mora/studio-core editor, evaluation, assistance, inspection; no GL
  mora/studio      native window, GL rendering, application lifecycle

The separation between Studio’s model (mora/studio-core) and its GL renderer (mora/studio) allows substantial work from a plain Lisp REPL. See System architecture.

Examples

examples/mora-framework-intro.mora contains small generic examples for patterns, transformations, layers, inspection, shader construction, and ordered image processing. Evaluate forms individually and respect the documented sound and renderer prerequisites. Framework examples walks through the file.

Source references

Repository-relative paths in the Mora source where these mechanisms are implemented.

src/core/time.lisp
src/core/event.lisp
src/core/pattern.lisp
src/core/combinators.lisp
src/runtime/transport.lisp
src/runtime/channel.lisp
src/runtime/api.lisp
src/runtime/backend.lisp
src/mini/
src/audio/
src/backends/superdirt/
supercollider/SuperDirtMora/
src/samples/
src/samples-import/
src/stems/import.lisp
src/mini/loop-library.lisp
src/mini/stem.lisp
src/mini/stem-stack.lisp
src/mini/stem-stack-runtime.lisp
src/mini/loop-families.lisp
src/mini/loop-session.lisp
src/mini/loop-tag-filter.lisp
src/mini/loop-match.lisp
src/mini/loop-target-policy.lisp
scripts/audio-analysis/
src/mini/stem-embeddings.lisp
src/mini/stem-context.lisp
src/analysis/mixture-context.lisp
src/samples-studio/stem-suggestions.lisp
src/studio/stem-suggestions-inline.lisp
src/samples-studio/sample-browser.lisp
src/samples-studio/insertion.lisp
src/samples-studio/sample-waveform.lisp
src/studio/commands-sample-browser.lisp
src/studio/render-sample-browser.lisp
src/visual/emitter.lisp
src/visual/post-model.lisp
src/visual/post-backend.lisp
src/analysis/
src/runtime/orbit-taps.lisp
src/studio/
mora.asd
qlfile
Makefile
examples/mora-framework-intro.mora