Glossary
One word per concept, used the same way in the specification, the code, these docs and the diagnostics. Generated from spec/glossary.yaml.
Terms
| Term | Means | Avoid | Seen by |
|---|---|---|---|
| page | A file in pages/ that becomes a route; markup, script block and style. | screen file, view, template | user |
| screen | The running instance of a page on a device. | page (at runtime) | user |
| component | A reusable file with markup, used by name inside a page. | widget | user |
| behaviour | An exported function in a .behaviour.duo or .behaviour.ts file that makes state, derived values or effects, called at the top of any file's script, which owns what it makes (decision 0152). | hook, composable, mixin, behavior | user |
| pack | A folder that owns one topic, such as styling, with rules (each saying what to do, why, and the codes or check that find a break of it), a skill agents follow and references they read when needed. Duolith has one for each topic of the language; an app's own, in packs/ or an installed package, builds on Duolith's of the same topic (decision 0160). | plugin, preset, ruleset | user |
| element | A built-in tag such as view, text or list. | node, tag | user |
| part | A built-in kit component such as sheet or tabs. | widget, control | user |
| piece | A named, overridable section of a part, such as a sheet's handle. | slot | user |
| overlay | Content shown above the screen, such as a dialog, sheet, menu or tooltip, written with the overlay element. | modal (for every kind), portal, popup | user |
| anchor | The element an overlay belongs to and is placed next to, such as the button that opens a menu. | reference, target | user |
| detent | A height a sheet rests at, medium or large. | snap point, stop | user |
| toast | A short message at the screen's edge that goes by itself, shown with toast(). | snackbar, notification (for this) | user |
| look | The starting visual style of the kit, default or platform. | skin, mode | user |
| variant | A declared alternative of a component or part, such as primary. | flavour, kind | user |
| token | A named design value in the theme. | variable | user |
| theme | A complete set of token values. | palette | user |
| utility | A short class that applies tokens, such as p-4. | helper class | user |
| prefix | A condition on a utility, such as pressed or wide. | modifier | user |
| state | A reactive value, which may hold a value or load one. | store, signal, resource | user |
| loaded state | State that loads, declared with state.load(key, loader), cached by key and kept fresh; it is loading, ready or failed (decisions 0020 and 0098). | resource, query, fetcher | user |
| shared state | State declared with state(initial, { shared: "name" }), one value for every screen that declares that name, for as long as the app runs (decision 0033). | global state, store, context | user |
| route | The path a page serves, from its file name in pages/ ([id] a parameter, [...rest] the rest); route() gives a screen its path, params and query (decision 0031). | url pattern, path pattern | user |
| layout | A _layout.duo file that wraps every screen in its folder and the folders below, showing the screen where it writes <slot />; it stays mounted while the screens inside it change (decision 0031). | frame, wrapper, shell | user |
| guard | A check a page or layout makes with guard(...) before its screen is shown and while it is in front; a string redirects, a falsy value shows not-found (decision 0033). | middleware, protector, gate | user |
| action | An asynchronous write with pending, error, retry and refresh. | mutation, command | user |
| stream | State fed continuously by a live source. | subscription, feed | user |
| binding | A link from state to a view property. | user | |
| boundary | A part of a screen that shows a skeleton until its state is ready. | suspense | user |
| skeleton | The placeholder drawn at a boundary while it loads. | shimmer, placeholder | user |
| island | A unit of a screen that loads, updates and fails on its own. | user | |
| motion | Automatic or preset movement of an element. | animation | user |
| morph | An element carried from one screen to another. | shared element | user |
| transition | Movement between screens. | user | |
| interaction | A module bundling a gesture, its state, motion and haptic. | gesture handler | user |
| module | Anything installed with add, whether script, effect-using or component. | extension, plugin | user |
| effect | An operating-system feature implemented once per platform, such as haptics. | native module, capability | user |
| target | An output of the build, one of web, ios or android. | platform | user |
| rung | A level of the execution ladder, 0 to 3. | tier, level | user |
| diagnostic | An error, warning or hint with a stable code. | user | |
| edition | A version of the language that a project opts into. | user | |
| Screen IR | The analysed, target-neutral description of a screen that both emitters consume. | AST | internal |
| style table | The build-time table of resolved style combinations that views refer to by number. | stylesheet | internal |
| engine adapter | The anti-corruption layer that is the only code allowed to talk to Lynx. | bridge | internal |
| contract | A versioned file in the repository that two contexts agree on. | interface (for these files) | internal |
| brief | The document that is an implementer agent's whole task description. | ticket | internal |
| consent | The person's choice, per category such as analytics or crashes, of what the app may record and send about them. | permission (for this), opt-in, tracking preference | user |
| transport | The function that delivers analytics batches or crash reports somewhere, such as an HTTP endpoint or the console. | sink, backend, destination | user |
| breadcrumb | One recent happening, such as a press, a screen shown or an action settled, kept to send with a crash report. | trail entry, log line | user |
| catalogue | The file of messages for one locale, locales/<locale>.json. | translation file, resource bundle, dictionary | user |
| message | One translatable text in a catalogue, named by a key and written in ICU message syntax. | string, translation (for the text) | user |
| locale | A language tag such as en or ar-EG that picks the catalogue, the text direction and the number and date formats. | language (for the tag), culture | user |
| lint rule | A check that duolith lint runs, with a warning code from W0001 to W0099, turned off or on under lint in duolith.yaml. | linter rule, inspection | user |