One declaration does three jobs: renders the panel, carries the defaults, names
the values that come back. A module writes no DOM and reads no DOM.
Validation refuses rather than repairs -- unknown type, a renderer its type does
not have, a label that is not text, a default outside its own bounds, a when
naming a key the module never declared. A module that is wrong does not get a
best-effort panel; it does not load, and says why once.
Ordering is by declared relation and stage, never priority numbers, and a cycle
drops only the modules in it. Compatibility is by trait, never model name.
The shell hands a module { composer, values, on, shell } and nothing else: no
node, no document, no kit internals. It cannot style anything because it is
never given anything that could.
catalogue/hide.html puts one good module and five broken ones through the real
shell and shows the result: one panel, five absent, no placeholders. The lint
fixtures make the scanner prove it catches each rule, so a clean scan means
something.
First slice: modules/system/appearance. Two settings, an optional ui.js, and
clicking Light actually turns the app light.
40 lines
1.1 KiB
Python
40 lines
1.1 KiB
Python
"""Appearance: theme and grid density.
|
|
|
|
The first real vertical slice, and deliberately the smallest one that exercises
|
|
the whole path -- announcement, schema, panel, values -- with no model, no
|
|
sampler and nothing that needs a GPU to be seen working.
|
|
"""
|
|
|
|
ID = "appearance"
|
|
TITLE = "Appearance"
|
|
MOUNT = "settings.general"
|
|
STAGE = "load"
|
|
STATUS = "proven"
|
|
|
|
SETTINGS = {
|
|
"theme": {
|
|
"type": "enum", "default": "auto",
|
|
"label": "Colour scheme", "ui": "segmented",
|
|
"options": [
|
|
{"value": "dark", "label": "Dark"},
|
|
{"value": "light", "label": "Light"},
|
|
{"value": "auto", "label": "Auto"},
|
|
],
|
|
},
|
|
"density": {
|
|
"type": "int", "default": 0, "min": 0, "max": 4, "step": 1,
|
|
"label": "Media columns",
|
|
"hint": "0 fits as many as the panel allows.",
|
|
"ui": "stepper",
|
|
},
|
|
}
|
|
|
|
|
|
def apply(values, context=None):
|
|
"""Nothing to do at generation time: appearance is the browser's business.
|
|
|
|
Declared anyway so the module has the same shape as every other one -- a
|
|
module core has to special-case is a module that will be forgotten.
|
|
"""
|
|
return context
|