domma-cms 1.66.9 → 1.66.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -262,6 +262,7 @@ Build smoother experiences, one letter at a time.
262
262
  <h3 id="sc-scramble"><code>scramble</code> - text out of random characters</h3>
263
263
  <p>Text that appears through a flurry of random characters, settling into the real words.</p>
264
264
  <pre><code>[scramble speed=&quot;50&quot;]Access granted[/scramble]
265
+ [scramble loop loop-delay=&quot;3000&quot;]Now hiring[/scramble]
265
266
  </code></pre>
266
267
  <table class="table table-sm">
267
268
  <thead>
@@ -274,6 +275,14 @@ Build smoother experiences, one letter at a time.
274
275
  <td><code>speed</code></td>
275
276
  <td>Milliseconds per character (default 50)</td>
276
277
  </tr>
278
+ <tr>
279
+ <td><code>loop</code></td>
280
+ <td>Switch: play again and again. Without it, the text scrambles once</td>
281
+ </tr>
282
+ <tr>
283
+ <td><code>loop-delay</code></td>
284
+ <td>With <code>loop</code>: how long the words stay still between plays, in milliseconds (default 2000)</td>
285
+ </tr>
277
286
  </tbody></table>
278
287
  <h3 id="sc-counter"><code>counter</code> - a number that counts up</h3>
279
288
  <p>A number that counts up (or down) to its target.</p>
@@ -333,6 +342,10 @@ Build smoother experiences, one letter at a time.
333
342
  <td><code>duration</code></td>
334
343
  <td>How long it lasts, in milliseconds (default 600)</td>
335
344
  </tr>
345
+ <tr>
346
+ <td><code>opacity</code></td>
347
+ <td>How strong the ripple starts, from 0 (invisible) to 1 (solid, the default). Use it with a solid colour: <code>colour=&quot;#7c6af7&quot; opacity=&quot;0.3&quot;</code></td>
348
+ </tr>
336
349
  </tbody></table>
337
350
  <h3 id="sc-twinkle"><code>twinkle</code> - sparkles</h3>
338
351
  <p>Sparkling particles over what is inside.</p>
@@ -844,6 +857,10 @@ Fast, file-based and friendly.
844
857
  [/card]
845
858
 
846
859
  [button href=&quot;/contact&quot; pulse]Get in touch[/button]
860
+
861
+ [card title=&quot;New&quot; animate animate-type=&quot;zoom-in&quot; ambient ambient-type=&quot;aurora&quot;]
862
+ A card that zooms in, on a moving background.
863
+ [/card]
847
864
  </code></pre>
848
865
  <table class="table table-sm">
849
866
  <thead>
@@ -854,26 +871,26 @@ Fast, file-based and friendly.
854
871
  </thead>
855
872
  <tbody><tr>
856
873
  <td><code>[card]</code>, <code>[box]</code></td>
857
- <td><code>reveal</code>, <code>breathe</code>, <code>pulse</code>, <code>shake</code>, <code>twinkle</code>, <code>ripple</code></td>
874
+ <td><code>reveal</code>, <code>breathe</code>, <code>pulse</code>, <code>shake</code>, <code>twinkle</code>, <code>ripple</code>, <code>animate</code>, <code>ambient</code></td>
858
875
  </tr>
859
876
  <tr>
860
877
  <td><code>[hero]</code></td>
861
- <td><code>reveal</code>, <code>breathe</code>, <code>pulse</code>, <code>twinkle</code>, <code>ticker-tape</code>, <code>butterflies</code>, <code>strobe</code></td>
878
+ <td><code>reveal</code>, <code>breathe</code>, <code>pulse</code>, <code>twinkle</code>, <code>ticker-tape</code>, <code>butterflies</code>, <code>strobe</code>, <code>animate</code>, <code>ambient</code></td>
862
879
  </tr>
863
880
  <tr>
864
881
  <td><code>[banner]</code></td>
865
- <td><code>reveal</code>, <code>pulse</code>, <code>shake</code></td>
882
+ <td><code>reveal</code>, <code>pulse</code>, <code>shake</code>, <code>animate</code>, <code>ambient</code></td>
866
883
  </tr>
867
884
  <tr>
868
885
  <td><code>[col]</code></td>
869
- <td><code>reveal</code>, <code>breathe</code>, <code>ripple</code></td>
886
+ <td><code>reveal</code>, <code>breathe</code>, <code>ripple</code>, <code>animate</code></td>
870
887
  </tr>
871
888
  <tr>
872
889
  <td><code>[button]</code></td>
873
- <td><code>breathe</code>, <code>pulse</code>, <code>shake</code>, <code>ripple</code></td>
890
+ <td><code>breathe</code>, <code>pulse</code>, <code>shake</code>, <code>ripple</code>, <code>animate</code></td>
874
891
  </tr>
875
892
  </tbody></table>
876
- <p><code>[animate]</code> and <code>[ambient]</code> are always written as a pair of tags around the content.</p>
893
+ <p><code>animate</code> and <code>ambient</code> take the same settings as their tags: <code>animate-type</code>, <code>animate-duration</code>, <code>animate-delay</code>, <code>animate-repeat</code>, and <code>ambient-type</code>, <code>ambient-speed</code>, <code>ambient-intensity</code>. Written with no type, <code>animate</code> fades the tag in and <code>ambient</code> gives it the <code>aurora</code> background.</p>
877
894
 
878
895
  </div>
879
896
  </div>
@@ -222,7 +222,7 @@
222
222
  <td>Your own id on the column</td>
223
223
  </tr>
224
224
  </tbody></table>
225
- <p>A column also takes the effects <code>reveal</code>, <code>breathe</code> and <code>ripple</code> as switches - see <a href="#/docs/usage/shortcodes-effects">Effects</a>.</p>
225
+ <p>A column also takes the effects <code>reveal</code>, <code>breathe</code>, <code>ripple</code> and <code>animate</code> as switches - see <a href="#/docs/usage/shortcodes-effects">Effects</a>.</p>
226
226
  <h3 id="sc-center"><code>center</code> - centred content</h3>
227
227
  <p>Centres whatever is inside it.</p>
228
228
  <pre><code>[center]
@@ -414,7 +414,7 @@ The body, as usual.
414
414
  <p>Good to know:</p>
415
415
  <ul>
416
416
  <li>The full list of layouts, variants and gradients, with pictures, is in <a href="#/docs/usage/shortcodes">Shortcodes</a> under Cards. The editor&#39;s Card builder offers all of them.</li>
417
- <li>A card takes the effects <code>reveal</code>, <code>breathe</code>, <code>pulse</code>, <code>shake</code>, <code>twinkle</code> and <code>ripple</code> as switches: <code>[card title=&quot;Why us&quot; reveal reveal-animation=&quot;zoom&quot;]</code>.</li>
417
+ <li>A card takes the effects <code>reveal</code>, <code>breathe</code>, <code>pulse</code>, <code>shake</code>, <code>twinkle</code>, <code>ripple</code>, <code>animate</code> and <code>ambient</code> as switches: <code>[card title=&quot;Why us&quot; reveal reveal-animation=&quot;zoom&quot;]</code>.</li>
418
418
  <li>Cards can go inside grids, boxes, slideovers and other cards.</li>
419
419
  </ul>
420
420
  <h3 id="sc-box"><code>box</code> - a plain container</h3>
@@ -555,7 +555,7 @@ Optional text underneath, with **Markdown**.
555
555
  <td>Your own CSS class or id</td>
556
556
  </tr>
557
557
  </tbody></table>
558
- <p>A hero takes the effects <code>reveal</code>, <code>breathe</code>, <code>pulse</code>, <code>twinkle</code>, <code>ticker-tape</code>, <code>butterflies</code> and <code>strobe</code> as switches.</p>
558
+ <p>A hero takes the effects <code>reveal</code>, <code>breathe</code>, <code>pulse</code>, <code>twinkle</code>, <code>ticker-tape</code>, <code>butterflies</code>, <code>strobe</code>, <code>animate</code> and <code>ambient</code> as switches.</p>
559
559
  <h3 id="sc-slideover"><code>slideover</code> - a panel that slides in</h3>
560
560
  <p>A button that opens a panel sliding in from the side. What you write between the tags is what the panel shows.</p>
561
561
  <pre><code>[slideover title=&quot;Delivery details&quot; trigger=&quot;Read more&quot; size=&quot;lg&quot;]
@@ -386,7 +386,7 @@ Your text appears letter by letter.
386
386
  <h3 class="mb-2">Scramble</h3>
387
387
  <p class="text-muted mb-2">Reveals text through a character-scramble animation. Great for tech/data
388
388
  aesthetics.</p>
389
- <pre class="code-block mb-3">[scramble speed="50" loop="false"]
389
+ <pre class="code-block mb-3">[scramble speed="50" loop loop-delay="2000"]
390
390
  Scrambled reveal text.
391
391
  [/scramble]</pre>
392
392
 
@@ -247,8 +247,8 @@ with either, so pick a lighter or darker shade for body text. Anything else in `
247
247
  text, links, code and footer on it.
248
248
 
249
249
  A header is never drawn: `title`, `subtitle`, `icon`, `image` and `layout` are ignored. Effects that go on a
250
- `[card]` (`reveal`, `pulse`, …) go on a `[box]` too. A `[card]` can sit inside a `[box]` and a `[box]` inside a
251
- `[card]`; a `[box]` cannot hold another `[box]`. `rounded="xs"` is also available on `[card]`.
250
+ `[card]` (`reveal`, `pulse`, …) go on a `[box]` too. A `[card]` can sit inside a `[box]`, a `[box]` inside a
251
+ `[card]`, and a `[box]` inside another `[box]`. `rounded="xs"` is also available on `[card]`.
252
252
 
253
253
  ---
254
254
 
@@ -562,7 +562,7 @@ The following shortcodes are also available in page Markdown:
562
562
  ```
563
563
 
564
564
  Attributes on `[tabs]`: `style` (`"pills"`, `"bordered"`, or default underline), `align` (`"center"` or `"right"`),
565
- `fade` (flag - fade between panes), `id`.
565
+ `id`. Panels always fade in - Domma's tabs do it themselves, so there is no switch for it.
566
566
  Attributes on `[tab]`: `title`, `icon` (Domma icon name shown before the title).
567
567
 
568
568
  ---
@@ -754,9 +754,10 @@ The site will be read-only on **Sunday** from 8am.
754
754
  | `class` | Extra CSS classes on the banner |
755
755
 
756
756
  `[banner]` also accepts injected effects (`reveal`, `pulse`, `shake`, `ambient`, `animate`) - see
757
- [Effect injection](#effect-injection). It is processed late (after `[card]` and `[grid]`), so it cannot be nested inside
758
- a card, grid, tab or similar container body - place it at the top level of the page, or inside `[center]` or
759
- `[slideover]`.
757
+ [Effect injection](#effect-injection). It is processed late (after `[card]` and `[grid]`), when a container has already turned
758
+ its body into HTML, so the opening tag's attributes are put aside before the containers run (`holdBannerTags()`) and
759
+ given back at the banner stage. A banner can therefore sit inside a card, box, column, tab, accordion item or
760
+ slideover. A `[banner]` tag that appears later (from a plugin shortcode, say) is read as written, without that help.
760
761
 
761
762
  ---
762
763
 
@@ -1706,9 +1707,9 @@ The following shortcodes are provided by the built-in Effects system.
1706
1707
  | `[pulse]...[/pulse]` | Repeating scale pulse |
1707
1708
  | `[shake]...[/shake]` | One-shot shake |
1708
1709
  | `[scribe speed="50"]...[/scribe]` | Typewriter - simple mode (text typed letter by letter) |
1709
- | `[scramble]...[/scramble]` | Character-scramble reveal |
1710
+ | `[scramble speed loop loop-delay]...[/scramble]` | Character-scramble reveal; `loop` replays it after `loop-delay` ms (default 2000) |
1710
1711
  | `[counter to="100" /]` | Animated number counter (self-closing) |
1711
- | `[ripple]...[/ripple]` | Click-triggered ripple |
1712
+ | `[ripple colour duration opacity]...[/ripple]` | Click-triggered ripple; `opacity` (0-1) is how strong it starts |
1712
1713
  | `[twinkle count="50"]...[/twinkle]` | Particle/star overlay |
1713
1714
  | `[ticker-tape palette="festive" /]` | Falling ticker-tape strips - self-closing for full-page, wrapping form for container-scoped |
1714
1715
  | `[butterflies palette="meadow" /]` | Flapping butterflies wander and rise - self-closing for full-page, wrapping form for container-scoped |
@@ -1862,6 +1863,10 @@ Fast, file-based and friendly.
1862
1863
  [button href="/contact" pulse]Get in touch[/button]
1863
1864
  ```
1864
1865
 
1866
+ `animate` and `ambient` are CSS only. As switches they emit the same classes as their tags
1867
+ (`animate-type="zoom-in"` gives `animate-zoom-in`; `ambient-type="wave"` gives `bg-ambient-wave`) rather than a
1868
+ `dm-fx-*` class, and with no type they default to `fade-in` and `aurora`.
1869
+
1865
1870
  | Host tag | Effects that can be injected |
1866
1871
  |---|---|
1867
1872
  | `[card]`, `[box]` | `reveal`, `breathe`, `pulse`, `shake`, `twinkle`, `ambient`, `animate`, `ripple` |
@@ -1920,8 +1925,8 @@ Container tags render their own bodies as they go: effect wrappers, `[tabs]`, `[
1920
1925
  `[text]`, `[button]`, `[link]`, `[cta]`) and `[grid]`/`[card]` over their body before Markdown, so those work inside
1921
1926
  all of them. `[center]` leaves its body as Markdown for the later stages, so anything processed after it works
1922
1927
  inside it. Tags processed before a container (components, collections, views, blocks, menus) are already HTML by
1923
- the time the container sees them, so they can be nested anywhere. `[banner]` runs after `[card]` and `[grid]`, so
1924
- it cannot be nested inside a container that has already rendered its body. Do not nest `[slideover]` inside another `[slideover]`. Cards, boxes, grids, rows, columns and background sections support balanced nesting.
1928
+ the time the container sees them, so they can be nested anywhere. `[banner]` runs after `[card]` and `[grid]`, but
1929
+ its attributes are held aside before they run, so it nests inside them too. Do not nest `[slideover]` inside another `[slideover]`. Cards, boxes, grids, rows, columns and background sections support balanced nesting.
1925
1930
 
1926
1931
  ### Optional Christmas elf scenes
1927
1932
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "domma-cms",
3
- "version": "1.66.9",
3
+ "version": "1.66.10",
4
4
  "description": "File-based CMS powered by Domma and Fastify. Run npx domma-cms my-site to create a new project.",
5
5
  "type": "module",
6
6
  "main": "server/server.js",