mdeck 3.9.0 → 3.10.0

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 3.10.0 — 2026-10-11
+
+- Glass has a `motion` setting: `motion: 0` holds its light still, for recordings and calm rooms. The guide for theme authors names the settings themes share: `motion` for what moves while presenting and `texture` for grain, paper and scanlines.
+
 ## 3.9.0 — 2026-10-11
 
 - Theme parameters say what kind of value they take: `type = "size"` (pixels, with `min`, `max` and `step`), `"number"`, `"switch"` (1 or 0), `"choice"` (one of `choices`) or `"font"`. The deck settings show a slider, a box to tick or a list instead of a text box; a deck value that does not fit is left out, so the theme's own value stays, and `mdeck check` says why; a value outside the range is used, with a warning. `mdeck list themes` shows each theme's settings and what they take, and the design page lets a theme's author set the kind. `mdeck themes build` writes each theme's settings into the gallery's `looks.json`. A parameter without a type takes any text, as before. The built-in themes give every parameter a type and a description with its default and range. A theme that uses `type` needs this version of mdeck.

package/assets/extensions/themes/glass/extension.toml

@@ -3,7 +3,7 @@ kind = "theme"
 id = "glass"
 title = "Glass"
 description = "Liquid glass: soft pools of light behind every slide, content without frames, titles on a frosted pane with a bright rim; capsule labels, glass beads for list markers and a glass lens for chapter numbers; Geist throughout, dark by default."
-version = "0.2.0"
+version = "0.3.0"
 author = "Tilman Schieber"
 license = "MIT"
 # The palette this theme uses unless the deck sets one; colours come only from palettes.
@@ -40,6 +40,8 @@ styles = "styles.css"
 # The glass: how round the panes are and how much they blur what is behind them.
 "--glass-radius" = "44px"
 "--glass-blur" = "28px"
+# Whether the light drifts (1) or holds still (0).
+"--motion" = "1"
 
 # Type families
 "--font-display" = "\"Geist\", \"Inter\", \"Helvetica Neue\", Arial, sans-serif"
@@ -64,6 +66,12 @@ min = 0
 max = 48
 description = "28px by default, from 0px (clear glass) to about 48px."
 
+[params.motion]
+token = "--motion"
+title = "Motion"
+type = "switch"
+description = "1 (the default) lets the pools of light drift while presenting; 0 keeps them still, for recordings or a calm room. Print and reduced motion are always still."
+
 # What this theme is for and how to write for it: shown in listings, and read
 # by assistants that write slides as the theme author's advice.
 [guide]

package/assets/extensions/themes/glass/styles.css

@@ -53,9 +53,9 @@
      to tint. Radial gradients only (no blur filter): they stay vector in a
      PDF and are cheap to draw. */
   background:
-    radial-gradient(circle max(var(--a-r) * 2.8, 720px) at calc(var(--a-x) + var(--dx)) calc(var(--a-y) + var(--dy)), var(--wash-a) 0%, color-mix(in oklab, var(--wash-a) 55%, transparent) 40%, transparent 100%),
-    radial-gradient(circle max(var(--b-r) * 2.8, 640px) at calc(var(--b-x) - var(--dx)) calc(var(--b-y) - var(--dy)), var(--wash-b) 0%, color-mix(in oklab, var(--wash-b) 55%, transparent) 40%, transparent 100%),
-    radial-gradient(circle max(var(--c-r) * 2.6, 520px) at calc(var(--c-x) + var(--dy)) calc(var(--c-y) + var(--dx)), var(--wash-c) 0%, transparent 100%),
+    radial-gradient(circle max(var(--a-r) * 2.8, 720px) at calc(var(--a-x) + var(--dx) * var(--motion)) calc(var(--a-y) + var(--dy) * var(--motion)), var(--wash-a) 0%, color-mix(in oklab, var(--wash-a) 55%, transparent) 40%, transparent 100%),
+    radial-gradient(circle max(var(--b-r) * 2.8, 640px) at calc(var(--b-x) - var(--dx) * var(--motion)) calc(var(--b-y) - var(--dy) * var(--motion)), var(--wash-b) 0%, color-mix(in oklab, var(--wash-b) 55%, transparent) 40%, transparent 100%),
+    radial-gradient(circle max(var(--c-r) * 2.6, 520px) at calc(var(--c-x) + var(--dy) * var(--motion)) calc(var(--c-y) + var(--dx) * var(--motion)), var(--wash-c) 0%, transparent 100%),
     var(--canvas);
 }
 
@@ -526,7 +526,7 @@ strong { font-weight: 650; color: var(--ink); }
 }
 
 /* The light drifts slowly while presenting; never in print or for people
-   who prefer less motion. */
+   who prefer less motion. motion: 0 holds it still. */
 @media (prefers-reduced-motion: no-preference) {
   .slide:is(.slide--title, .slide--chapter, .slide--focus) { animation: glass-drift 22s ease-in-out infinite alternate; }
 }

package/docs/reference/authoring.md

@@ -82,7 +82,10 @@ params:
 
 Available params depend on the theme; `mdeck list themes` shows them with the
 kind of value each takes: a size in pixels, a number, a switch (`1` or `0`), a
-choice or a font. `0` or `0px` turns a feature off. A value that does not fit
+choice or a font. `0` or `0px` turns a feature off.
+A font named this way is not downloaded: it has to be installed on the
+computer that shows the slides, or the browser uses the next font in the
+list; PDFs and single files embed only the theme's own fonts. A value that does not fit
 is left out, and `mdeck check` says why. Colours are not params: they come from
 the palette.
 

package/docs/site/content/theme-authoring.md

@@ -138,7 +138,7 @@ params:
   fontBody: "Georgia, serif"
 ```
 
-Its default is simply the token's value. Colours are not parameters: they come from the palette.
+Its default is simply the token's value. Colours are not parameters: they come from the palette. A font a deck names this way is not downloaded: it has to be installed on the computer that shows the slides, or the browser uses the next font in the list; PDFs and single files embed only the theme's own fonts.
 
 Say what kind of value a parameter takes with `type`, so mdeck can check what authors write and the editor can offer the right control:
 
@@ -167,6 +167,8 @@ A few habits make parameters easy to use:
 - Turn a feature off with its parameter at zero (`0px`, `0`) rather than a second parameter.
 - Use a switch or a strength by multiplying with it, as in `calc(330px * var(--shapes))`.
 - Let the `description` give the default and a sensible range: the editor shows it under the control, and assistants read it.
+- Offer what people change from one talk to the next, because of the room, the medium or the content, and leave sizes and distances at the values the theme was made with.
+- Use the shared names where they fit, so people learn them once: `motion` (a switch) turns off everything that moves while presenting, for recordings and calm rooms; `texture` (a switch) turns off grain, paper and scanlines, for washed-out projectors and handouts.
 
 ## Say what it is for
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mdeck",
-  "version": "3.9.0",
+  "version": "3.10.0",
   "type": "module",
   "description": "Write slides as a plain text file, present them in the browser, share them as one HTML file or PDF.",
   "license": "MIT",