domma-cms 1.6.60 → 1.7.0

package/docs/superpowers/specs/plans/2026-09-22-tools-promotion.md

@@ -0,0 +1,260 @@
+# Promoting Plugins into Core Tools, and the Marketplace Rename
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Rename the Plugins screen to **Marketplace**, and promote four plugins into core so they
+stop being things you install and start being things the CMS has.
+
+**The model, decided 2026-09-22:** a plugin is something you acquire from the **Marketplace**; once
+enabled it is a **Tool**. The sidebar already works this way - `sidebar-grouping.js` gathers every
+enabled plugin into a Tools folder, on the grounds that "once a plugin is turned on it is part of the
+system, not an optional extra". Only the naming lagged behind.
+
+**Destinations differ by plugin.** Three of the four are not Tools at all:
+
+| Plugin | LOC | Destination | Why |
+|---|---|---|---|
+| `demo-viewer` | 40 | a core shortcode in `markdown.js` | registers `[demo]` and nothing else. No admin view, no routes, no data. A shortcode is not a Tool. |
+| `theme-switcher` | 101 | a toggle in **Content → Theme** | a floating disc on the *public* site. No admin screen worth opening; it manipulates exactly what `themeSettings.js` already owns. |
+| `notes` | 412 | core Tool | genuine admin app: view, routes, per-user collection. |
+| `todo` | 452 | core Tool | as above. |
+| `analytics` | 678 | core Tool | already in `CORE_PLUGINS`: always loaded, cannot be switched off. A Tool in all but name. |
+| `contacts` | 1,427 | core Tool | enabled on 9 of 9 sites. Two collections, plus a seeded sample file. |
+
+**Spec:** `docs/superpowers/specs/2026-09-22-dcms-marketplace-design.md` (tier register, and the
+Marketplace framing)
+
+**Critical project rules** (from `CLAUDE.md` + memory):
+
+- Server on port **4096** is always running; never start or stop it. Test via `curl`.
+- `npm test` is serial. `domma-cms` is worked on concurrently - commit early, named paths only.
+- These four are vendored in **two** places: `domma-cms/plugins/` and `dcms-marketplace/plugins/`.
+  Both must lose them, and the monorepo's `reserved.json` must gain them.
+- Promotion changes core, so it reaches the fleet only in a release. Until then the plugins keep
+  working exactly as they do now, which is what makes each phase independently shippable.
+
+**Ordering constraint:** each retirement migration runs **before** the plugin loader, or a site
+briefly runs the core feature and the plugin at once. `search-migration.js` is the template and is
+already wired that way in `server.js`.
+
+---
+
+## Phase 1 - Rename, and delete a dead control
+
+Framing first: it is cheap, carries no data risk, and makes the promotions read correctly.
+
+- [ ] `MANAGE_PLUGINS_ITEM.text` in `admin/js/lib/sidebar-grouping.js`: "Manage Plugins" →
+  **"Marketplace"**. Consider `shopping-bag` or similar for the icon.
+- [ ] Update the heading and tab labels in `admin/js/views/plugins.js`.
+- [ ] **Keep the URL as `#/plugins`.** Renaming the hash means touching every plugin manifest's
+  `admin.sidebar[].url` and any stored admin-sidebar menu that references them, all invisible to a
+  user who reads labels.
+- [ ] **Delete the `bundled` control.** `btn-bundle-plugin` writes `bundled` through
+  `PUT /plugins/:name` into `config/plugins.json`, and **nothing reads it**: not `server/`, not the
+  manager, not the scaffolder (which reads `tier` since 2026-09-22), and no site on the fleet has it
+  set. Remove the badge, the handler, and the `bundled` branch in the route. The `bundled` flag in
+  `blocks.js` is a different concept and stays.
+- [ ] Leave **Update** off the screen. `installPlugin()` refuses an existing directory, so the verb
+  has no mechanism until the upgrade path lands in the marketplace work. A shop with no Update is
+  honest; one with a button that throws is not.
+
+**No migration needed.** `stripItemByUrl(tree, MANAGE_PLUGINS_URL)` removes any persisted copy of the
+item from stored menu data and re-synthesises it on every render, so the new label reaches every site
+on next load.
+
+**Exit:** the sidebar reads Marketplace, the screen's verbs are install / enable / configure, and no
+control writes a value nothing consumes.
+
+## Phase 2 - `demo-viewer` → a core shortcode
+
+Smallest promotion, and it establishes the retirement pattern.
+
+- [ ] Move the `[demo]` handler out of `plugins/demo-viewer/plugin.js` and into core's shortcode set
+  alongside the others in `markdown.js`. Keep the attribute contract identical - it is in use on 8 of
+  9 sites.
+- [ ] Settings from `config.js` (if any are read) move to the shortcode's own defaults.
+- [ ] Retirement migration, modelled on `search-migration.js`: drop the `plugins.json` entry, and
+  delete `plugins/demo-viewer/` **only if it is the bundled one** (manifest `name` and `author` both
+  match). A directory of that name carrying somebody else's work is left alone.
+- [ ] Tests: `[demo]` renders identically before and after, on a page that already uses it.
+
+**Exit:** `[demo]` works with no plugin present, on a site that never had one.
+
+## Phase 3 - `theme-switcher` → Content → Theme
+
+- [ ] Add the switcher's options to `config/theme.json` via `themeSettings.js`, and a control for
+  them on the **Content → Theme** screen. It is a theme feature, so it belongs beside the theme,
+  fonts and per-element overrides it manipulates.
+- [ ] The public assets from `public/inject-head.html` and `public/inject-body.html` become a core
+  builder, in the shape of `buildThemeView()` and `buildSearchAssets()`.
+- [ ] **Wire it into BOTH render paths in `renderer.js`.** This is the standing trap in that file:
+  `buildThemeView()` and `buildSearchAssets()` each have two call sites, and wiring one and not the
+  other is how a feature works on one path and silently does nothing on the other.
+- [ ] `enabled: false` must emit nothing at all, matching how search settings behave.
+- [ ] Retirement migration as Phase 2, lifting any existing settings out of `plugins.json` into
+  `theme.json` before deleting the directory.
+- [ ] Verify in a browser on a real page, both themes, since the whole feature is visual.
+
+**Exit:** the disc appears from a theme setting, the plugin is gone, and a site that had it
+configured keeps its configuration.
+
+## Phase 4 - `notes` and `todo` → core Tools
+
+Both have the same shape, so they are one phase done twice.
+
+- [ ] Admin view and template → `admin/js/views/`, registered in `admin/js/views/index.js` and the
+  core route list in `app.js`. An editor view reads its slug from `location.hash`, never from a
+  second `onMount` parameter, which is always `undefined`.
+- [ ] Routes → `server/routes/api/`, registered in `server.js`.
+- [ ] **Permissions**: plugin routes currently get theirs through `registerPluginResource()`. Core
+  routes need explicit entries in `permissionRegistry.js`, and the sidebar item needs a `permission`
+  key so it hides for a role that lacks it.
+- [ ] Collection schemas → the `PRESETS` array in `server/services/presetCollections.js`, keeping the
+  slugs **exactly**: `notes-notes` and `todo-items`.
+
+  **The directory name is not the slug.** `setupPlugin()` reads `schema.slug`, never the folder it
+  found the file in, and every plugin collection in this repo disagrees with its own directory:
+  `collections/user-notes/` declares `notes-notes`, `collections/todos/` declares `todo-items`,
+  `collections/user-contacts/` declares `contacts-contacts`. Key a preset off the directory name and
+  core will create a new empty collection while the site's real one sits beside it, orphaned.
+- [ ] **The data does not move.** Entries already live in `content/collections/<slug>/`, outside the
+  plugin directory, because `setupPlugin()` seeded them there. Keep the slug and existing entries are
+  untouched; change it and they are orphaned.
+- [ ] Preserve the per-user scope. Both filter on `userId` by hand in their route handlers, driven by
+  `config.scope`. Core has `rowAccess.js` for exactly this. Moving to it is the better end state, but
+  it is a **behaviour change** and belongs in its own task, not smuggled into a move.
+- [ ] Preserve `notes`' storage declaration: its `config.js` asks for the mongodb adapter with file
+  fallback. A site with no `connections.json` must keep degrading gracefully.
+- [ ] Retirement migration per plugin, as Phase 2.
+
+**Exit:** both Tools work with no plugin directory present; a site that had notes keeps every note.
+
+## Phase 5 - `analytics` → core Tool
+
+It is already `CORE_PLUGINS`, so it always loads and files under Tools whatever `plugins.json` says.
+Promotion makes the code match what the behaviour has been for a while. **It is the riskiest phase
+here**, for one reason the others do not have.
+
+- [ ] **The data moves, and it is real history.** Unlike `notes` and `todo`, whose entries already sit
+  in `content/collections/`, analytics keeps `stats.json`, `daily.json`, `lifetime.json` and
+  `journeys.json` inside `plugins/analytics/data/` - **28K to 96K per site** of accumulated traffic
+  history across the fleet. Losing it is losing every site's past.
+- [ ] Move the store to `content/analytics/`, not `var/` and not a collection. `content/` is the
+  operator's own directory and survives an update; `plugins/` is upstream-managed territory, which is
+  the wrong home for data a site cannot regenerate.
+- [ ] The migration must **copy, verify, then leave the originals in place** for one release rather
+  than moving. A failed move here is unrecoverable; a duplicated 96K is not a problem.
+- [ ] The `scaffold.reset` entries in the manifest (which blank the four files for a new site) become
+  part of core's site scaffolding.
+- [ ] Drop the five `!plugins/analytics/*` exclusions from `package.json` `files` once the data lives
+  elsewhere.
+- [ ] The public beacon from `public/inject-head.html` / `inject-body.html` becomes a core builder,
+  and like Phase 3 it must be **wired into both render paths in `renderer.js`**.
+- [ ] Keep Do-Not-Track and per-session dedup exactly as they are. They are in the manifest
+  description, which means they are a promise.
+
+### `analytics-pro` stays a paid plugin, and needs no supersede
+
+The two do not overlap the way a free/paid pair usually does:
+
+| | collection method | store |
+|---|---|---|
+| `analytics` (core) | **client-side beacon**, injected head + bodyEnd | `data/*.json` |
+| `analytics-pro` (paid) | **server-side `onRequest` hook**, no inject at all | `hits.jsonl` |
+
+Pro is not a better version of the free one, it is a *different instrument*: the beacon misses bots,
+blocked scripts and Do-Not-Track visitors by design, while request logging catches everything. So
+they coexist correctly, and `supersedes` is neither needed nor available - `resolveSupersessions()`
+refuses to let anything supersede a core plugin, and promotion makes that permanent.
+
+- [ ] **Decide how two numbers are presented.** On the four sites running both, the server-side count
+  will always exceed the client-side one, for good reasons a customer will not infer. Labelling them
+  as what they are - "page views" against "requests" - is the cheap fix. Showing one number that
+  silently changes when you buy Pro is the expensive mistake.
+
+## Phase 6 - `contacts` → core Tool
+
+Same shape as `notes` and `todo`, with one extra wrinkle and one dependent.
+
+- [ ] Admin view, template and `admin/css/index.css` → core. It is the only one of these with its own
+  stylesheet.
+- [ ] Collections → `PRESETS`, keeping the slugs **`contacts-contacts` and `contacts-groups`** - see
+  the warning in Phase 4, since both directories are named something else entirely.
+- [ ] `data/contacts.json` is **seeded sample data, not user data**: 401 bytes, two entries, byte
+  identical on every site that has it. It does not need migrating, and core should stop shipping it -
+  a new install with two fictional contacts in it is worse than an empty one.
+- [ ] `surveys` (paid) imports from contacts, in `admin/views/audience.js`. Promotion **improves**
+  that: a paid plugin depending on core is sound, where depending on another plugin that may be
+  uninstalled was always fragile. Check the import path still resolves once contacts is no longer at
+  `plugins/contacts/`.
+
+### What the data actually says about this tier
+
+Measured across all nine sites: **`contacts-contacts` and `contacts-groups` exist on six sites and
+hold zero entries on every one of them.** No site has a blog post either. So "enabled on 9 of 9" -
+which is how contacts was described earlier in this work - is a measure of what the scaffolder
+switched on, not of anything anyone uses.
+
+That does not argue against promoting it. It does mean promotion should not be expected to change
+usage, and the honest reason to do it is coherence: a contacts book is the kind of thing a CMS has
+rather than something you go shopping for.
+
+## Phase 7 - Remove them from the marketplace
+
+**Done 2026-09-22.** All seven phases complete.
+
+- [x] All six deleted from `dcms-marketplace/plugins/`; `make verify` reports **14 plugins: 2 free,
+  12 paid, 10 reserved slugs**.
+- [x] All six added to `reserved.json` with a reason and date, so the slugs cannot return as
+  third-party plugins wearing familiar names. `make verify` already fails a reserved slug that has a
+  directory.
+- [x] **The free tier is 2 plugins**: `blog` and `mail-reader`. At two, it is worth
+  asking whether it is still a tier or just the two things that have not been promoted yet. `blog` is
+  genuinely optional - a site either has one or does not. `mail-reader` is the trial for `email-pro`,
+  which supersedes it, so it earns its place as the free half of a paid product rather than as a
+  feature. Both defensible, but state the reason rather than leaving it as residue.
+- [ ] `CORE_PLUGINS` becomes empty and can be deleted along with `isCorePlugin()`, or kept as the
+  mechanism for the next promotion. It called itself "a waiting room rather than a destination"; with
+  `analytics` gone it has no residents.
+- [x] `CLAUDE.md` gains the Tools model and the two promotion traps; `README.md`'s table is
+  regenerated from what is actually in `plugins/`; `docs/plugin-development.md`'s example table
+  pointed at `analytics`, which is no longer a plugin, and now points at `blog`.
+
+**Exit: met.** The marketplace lists only plugins you can actually acquire.
+
+### What the promotions cost, for the next one
+
+Three things bit during this work and are now written into `CLAUDE.md`:
+
+1. **`schema.slug` is the slug, never the directory name.** All five plugin collections disagreed
+   with their own folders. This plan named two wrong slugs before it was corrected.
+2. **`seedAll()` rewrites `schema.json` on every boot.** A preset's `storage` block must match what
+   the plugin declared, or an install's adapter flips and its rows go out of sight.
+3. **The admin-sidebar menu is seeded once, file-existence guarded.** Core entries must go through
+   `registerSidebarItem()` or they reach new installs only.
+
+And two behaviours were found and pinned rather than tidied, because a relocation is the wrong place
+to change behaviour: `contacts` groups are site-wide while contacts are per-user, and `[demo]` had
+been emitting an iframe with no `src` since `allowedIframeHostnames` was introduced.
+
+## Verification
+
+- [ ] `npm test` passes, serially, after each phase.
+- [ ] A site with none of the four installed has working `[demo]`, a theme switcher toggle, Notes and
+  Todo.
+- [ ] A site that **had** notes with entries still has every entry afterwards.
+- [ ] A site that had `theme-switcher` configured keeps its configuration in `theme.json`.
+- [ ] Each migration is idempotent: run twice, second run is a no-op.
+- [ ] A directory named `notes` that is *not* ours survives the migration untouched.
+- [ ] The Marketplace screen offers install / enable / configure and nothing that writes a dead value.
+
+## Out of scope
+
+**`contacts` stays a plugin for now**, despite being the strongest candidate on usage - enabled on
+**9 of 9 sites**, the only free plugin anybody runs. Recorded here so the argument is not had twice:
+if the test for promotion is "this is part of the system rather than an add-on", contacts passes it
+more clearly than `notes` or `todo` do. Revisit once the four above have proved the pattern.
+
+Also out of scope: the plugin **Update** verb and its upgrade path, the developer surface split
+(scaffolding and the code editor are gated by `plugins.create` / `plugins.develop` and arguably want
+their own screen rather than tabs on a shop), and moving `notes`/`todo` onto `rowAccess.js`.

package/docs/theming.md

@@ -0,0 +1,320 @@
+# Theming
+
+Domma CMS uses the **Domma** UI framework's theming system. Themes are applied via a CSS class on `<html>` and control all colour tokens, shadows, and typography scales through CSS custom properties.
+
+---
+
+## Available Themes
+
+Twenty-eight public themes ship out of the box - fourteen colour palettes each available in a dark and a light variant.
+
+| Palette   | Dark variant       | Light variant       |
+|-----------|--------------------|---------------------|
+| Charcoal  | `charcoal-dark`    | `charcoal-light`    |
+| Ocean     | `ocean-dark`       | `ocean-light`       |
+| Forest    | `forest-dark`      | `forest-light`      |
+| Sunset    | `sunset-dark`      | `sunset-light`      |
+| Royal     | `royal-dark`       | `royal-light`       |
+| Lemon     | `lemon-dark`       | `lemon-light`       |
+| Silver    | `silver-dark`      | `silver-light`      |
+| Grayve    | `grayve-dark`      | `grayve-light`      |
+| Mint      | `mint-dark`        | `mint-light`        |
+| Unicorn   | `unicorn-dark`     | `unicorn-light`     |
+| Dreamy    | `dreamy-dark`      | `dreamy-light`      |
+| Christmas | `christmas-dark`   | `christmas-light`   |
+| Wedding   | `wedding-dark`     | `wedding-light`     |
+| Corporate | `corporate-dark`   | `corporate-light`   |
+
+### Admin Themes
+
+Nine dedicated admin-chrome themes engineered across three finishes:
+
+| Finish | Indigo | Steel | Teal | Description |
+|---|---|---|---|---|
+| **Sharp** | `admin-sharp-indigo` | `admin-sharp-steel` | `admin-sharp-teal` | Crisp, high-contrast light chrome |
+| **Slate** | `admin-slate-indigo` | `admin-slate-steel` | `admin-slate-teal` | Balanced mid-tone chrome for long administrative sessions |
+| **Smooth** | `admin-smooth-indigo` | `admin-smooth-steel` | `admin-smooth-teal` | Low-glare dark chrome |
+
+---
+
+## Setting the Theme
+
+### Via the admin
+
+1. Log in to the admin panel
+2. Go to **Content > Theme** in the sidebar
+3. On the **Themes** tab, choose a **Front-end Theme** for the public site and an **Admin Theme** for the
+   admin panel, and set the typography
+4. Click **Save**
+
+Everything on that page is stored in `config/theme.json`. It used to live in `config/site.json`; a one-shot
+migration lifts it out on first boot after upgrading, and the old keys are still rewritten there on every
+save so plugins and fleet tooling that read them keep working. `theme.json` is the authoritative copy -
+editing the mirrored keys in `site.json` by hand has no effect.
+
+### Via `config/theme.json` directly
+
+```json
+{
+  "theme": "ocean-dark",
+  "adminTheme": "charcoal-dark",
+  "autoTheme": {"enabled": false, "dayTheme": "ocean-light", "nightTheme": "ocean-dark",
+                "dayStart": "07:00", "nightStart": "19:00"},
+  "font": {"family": "Nunito", "size": 18},
+  "overrides": []
+}
+```
+
+The server reads this per render and stamps the theme onto `<body>` as `dm-theme-<id>`.
+
+---
+
+## Element Overrides
+
+A theme is nothing but a block of custom properties scoped to a class:
+
+```css
+.dm-theme-ocean-dark { --dm-primary: #00b4d8; --dm-surface: #1e293b; /* ... */ }
+```
+
+So re-theming *one region* of the page is a scoping problem, not a CSS-authoring one. Declare the same
+properties on a selector and everything inside it follows - including components rendered later, which is
+what hand-written rules always miss.
+
+**Content > Theme > Element Overrides** does exactly that. Each override is:
+
+| Field | Meaning |
+|-------|---------|
+| Target selector | The region to re-theme, e.g. `#site-navbar`, `.site-content`, `.card` |
+| Adopt a theme here | Copies every token of that theme onto the region |
+| Token overrides | Individual `--dm-*` values, applied after the adopted theme so they win |
+| Custom CSS | Escape hatch, appended verbatim after the generated rule |
+
+A light navbar on a dark site is therefore one override, not a stylesheet:
+
+```json
+{
+  "label": "Navbar island",
+  "scope": "#site-navbar",
+  "theme": "ocean-light",
+  "tokens": {"--dm-primary": "#0096c7"}
+}
+```
+
+which compiles to a single rule injected into every public page, **before** `content/custom.css` so your
+hand-written CSS is still the last word:
+
+```css
+#site-navbar { color-scheme: light; --dm-background: #ffffff; /* ...every ocean-light token... */
+               --dm-primary: #0096c7; }
+```
+
+### Why tokens rather than rules
+
+A rule like `#site-navbar a { color: #fff }` has to win a specificity fight against Domma's own selectors,
+and loses to anything carrying `!important` (Domma's legacy light-mode link hover, for one). A token
+override never enters that fight: it changes the *input* to the rule that was going to win anyway.
+
+### What overrides refuse
+
+- `*`, `:root` and `html` as a selector - that is the site theme, not an override
+- Token names that are not `--dm-*` custom properties, and names the shipped stylesheet does not define
+  (the admin's picker is built from the stylesheet, so it cannot offer one that does not exist)
+- Token values carrying `;`, `{`, `}`, `<`, `url()`, `@import` or `javascript:` - a value that can close
+  its own declaration can write arbitrary CSS into every page
+- An override with a selector but nothing to apply
+
+### Known limit: mode-flipped regions
+
+A few Domma component rules key off an **ancestor's** mode rather than tokens - `[data-mode="dark"]
+.alert-info`, and the syntax-highlight palette. Scoping a light theme into a dark page re-colours
+everything token-driven, but those handful of rules still follow the page, because no element can stop an
+ancestor selector from matching. If a mode-flipped region contains alerts or code blocks, add the fix to
+that override's **Custom CSS** box.
+
+---
+
+## Customising via `public/css/site.css`
+
+For site-specific overrides - colours, fonts, spacing, or layout tweaks - edit `public/css/site.css`. This file is served as a static asset and loaded on every public page.
+
+```css
+/* Override the primary accent colour */
+:root {
+  --dm-color-primary: #e63946;
+  --dm-color-primary-hover: #c1121f;
+}
+
+/* Adjust the navbar link font size */
+.navbar-link,
+.navbar-dropdown-toggle {
+  font-size: 15px;
+}
+
+/* Tighten icon size in nav links */
+.navbar-link span[data-icon],
+.navbar-link svg,
+.navbar-dropdown-toggle span[data-icon],
+.navbar-dropdown-toggle svg {
+  width: 15px;
+  height: 15px;
+  margin-right: 10px;
+}
+```
+
+Changes to `site.css` take effect immediately on the next page load (no build step required).
+
+You can also manage custom CSS through the admin panel under **Settings → Custom CSS**, which writes to `content/custom.css` - a separate file loaded after `site.css`.
+
+---
+
+## Template Slots
+
+The public page HTML shell is at `server/templates/page.html`. It contains two injection slots where the server inserts dynamic content:
+
+| Slot | Location | Purpose |
+|---|---|---|
+| `{{headInject}}` | Inside `<head>` | Server-generated `<script>` tags for site config, nav, and plugin head snippets |
+| `{{bodyEndInject}}` | Before `</body>` | Plugin body-end injection snippets |
+
+### What goes into `{{headInject}}`
+
+The renderer injects a `<script>` block containing:
+
+```js
+window.__CMS_SITE__  = { title, theme, adminTheme, ... };
+window.__CMS_NAV__   = { brand, items, variant, position };
+window.__CMS_DCONFIG__ = { /* per-page declarative config */ };
+```
+
+These objects are consumed by `public/js/site.js` to initialise the Domma navbar, apply the theme, and wire any declarative page config.
+
+If any enabled plugins declare a `inject.head` file in their `plugin.json`, those HTML snippets are also appended inside `{{headInject}}`.
+
+### What goes into `{{bodyEndInject}}`
+
+Plugin `inject.bodyEnd` snippets are concatenated here - typically `<script>` tags for client-side analytics, chat widgets, or other integrations.
+
+---
+
+## CSS Custom Properties
+
+Domma themes expose a consistent set of custom properties. These are the **real** names - a `var()` on a
+token that does not exist silently resolves to nothing, which is how a popup ends up with no background at
+all. The admin's token picker (Content > Theme) lists every one the installed stylesheet defines, and
+`GET /api/theme/catalog` returns the same list.
+
+```css
+/* Colours - each of primary/secondary/success/warning/danger/info also has
+   -hover, -active, -light, -dark, -text and -hover-text variants */
+--dm-primary
+--dm-primary-hover
+--dm-secondary
+--dm-success
+--dm-warning
+--dm-danger
+--dm-info
+
+/* Surfaces and text */
+--dm-background
+--dm-background-alt
+--dm-surface
+--dm-surface-raised
+--dm-surface-overlay
+--dm-text
+--dm-text-secondary
+--dm-text-muted
+--dm-text-inverse
+--dm-border
+--dm-border-light
+--dm-border-dark
+--dm-border-focus
+
+/* Typography */
+--dm-font-sans
+--dm-font-serif
+--dm-font-mono
+--dm-text-sm
+--dm-text-base
+--dm-text-lg
+--dm-leading-normal
+
+/* Spacing */
+--dm-space-1  /* 4px */
+--dm-space-2  /* 8px */
+--dm-space-3  /* 12px */
+--dm-space-4  /* 16px */
+--dm-space-6  /* 24px */
+--dm-space-8  /* 32px */
+
+/* Borders and shadows */
+--dm-radius-md
+--dm-radius-lg
+--dm-shadow-md
+--dm-shadow-lg
+```
+
+The theme stylesheet defines them on `.dm-theme-<id>`, which sits on `<body>`. Redeclaring one under any
+selector re-scopes it to that subtree - which is all an element override does.
+
+---
+
+
+## Theme Switcher (public)
+
+A floating disc of theme dots that lets a visitor pick their own theme. Off by default - a
+visitor-facing theme picker is a choice a site makes.
+
+Enable it at **Content → Theme → Theme Switcher**, or in `config/theme.json`:
+
+```json
+"switcher": {
+  "enabled": true,
+  "position": "right-center",
+  "offsetX": 32,
+  "offsetY": 32,
+  "themes": []
+}
+```
+
+| Key | Default | Notes |
+|-----|---------|-------|
+| `enabled` | `false` | `false` emits no stylesheet, no script and no settings at all |
+| `position` | `right-center` | `right-center`, `left-center`, `bottom-right`, `bottom-left`, `top-right`, `top-left` |
+| `offsetX` / `offsetY` | `32` | Pixels from the anchored edges, 0 to 400 |
+| `themes` | `[]` | **A filter, not a list to maintain.** Empty means every theme the stylesheet ships |
+
+Each dot's colours are that theme's own `--dm-primary` and `--dm-secondary`, so a theme added to
+`domma-themes.css` appears automatically. Was the `theme-switcher` plugin until 0.67.0, which
+hardcoded 26 dots against a stylesheet carrying 32 themes.
+
+## Custom Themes (the Theme Roller)
+
+A custom theme is a built-in theme plus the `--dm-*` tokens changed on top of it. The **Theme Roller**
+plugin makes them: pick a base, change colours, fonts, spacing and borders with a live preview, and
+save. A saved theme then joins the built-in ones everywhere a theme is chosen - the site theme, the
+admin theme, the day and night themes, and "Adopt a theme here" in an element override - listed under
+**Custom themes** in Content › Theme, or used straight from the Theme Roller's saved-themes menu.
+
+How it is applied: Domma's theme engine only knows its built-in themes (`Domma.theme.set()` refuses an
+unknown id and strips every `dm-theme-*` class it did not add), so a custom theme `brand` on
+`ocean-dark` is two classes on `<body>`:
+
+```html
+<body class="dm-theme-ocean-dark dm-custom-brand">
+```
+
+and one generated rule carrying only the changed tokens, emitted after Domma's theme stylesheet so it
+wins on source order:
+
+```css
+.dm-custom-brand { --dm-primary: #1144ff; }
+```
+
+Adopted onto a region by an override, a custom theme carries its base's full token set plus its
+changes. The public **theme switcher** cannot offer custom themes - it switches through Domma's engine.
+
+If the plugin providing a theme goes away (disabled, licence lapsed), the page keeps the theme's base:
+config/theme.json remembers each custom theme's base in `customBases` when the config is saved.
+
+Plugins provide themes with `hooks.registerThemes()` - see `docs/plugin-development.md`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "domma-cms",
-  "version": "1.6.60",
+  "version": "1.7.0",
   "description": "File-based CMS powered by Domma and Fastify. Run npx domma-cms my-site to create a new project.",
   "type": "module",
   "main": "server/server.js",
@@ -84,7 +84,7 @@
     "@fastify/rate-limit": "^10.3.0",
     "@fastify/static": "9.1.1",
     "bcryptjs": "^3.0.3",
-    "domma-js": "0.52.3",
+    "domma-js": "0.52.4",
     "dotenv": "^17.2.3",
     "fastify": "5.8.5",
     "gray-matter": "^4.0.3",

package/public/js/celebrations/core/canvas.js

@@ -6,4 +6,4 @@ export class CanvasManager{constructor(e={}){this.canvasId=e.canvasId||"celebrat
       height: 100vh;
       pointer-events: none;
       z-index: ${this.zIndex};
-    `,this.ctx=this.canvas.getContext("2d",{alpha:!0}),this.resize(),document.body.appendChild(this.canvas),window.addEventListener("resize",this._handleResize))}resize(){this.canvas&&(this.canvas.width=window.innerWidth,this.canvas.height=window.innerHeight)}clear(){this.ctx&&this.ctx.clearRect(0,0,this.canvas.width,this.canvas.height)}getDimensions(){return{width:this.canvas?.width||0,height:this.canvas?.height||0}}isMobile(){return window.innerWidth<768}destroy(){window.removeEventListener("resize",this._handleResize),this.canvas&&this.canvas.parentNode&&this.canvas.parentNode.removeChild(this.canvas),this.canvas=null,this.ctx=null}_handleResize(){this.resizeTimeout&&clearTimeout(this.resizeTimeout),this.resizeTimeout=setTimeout(()=>{this.resize(),this.resizeCallback&&this.resizeCallback()},250)}}
+    `,this.ctx=this.canvas.getContext("2d",{alpha:!0}),this.resize(),document.body.appendChild(this.canvas),window.addEventListener("resize",this._handleResize))}resize(){this.canvas&&(this.canvas.width=window.innerWidth,this.canvas.height=window.innerHeight)}clear(){this.ctx&&this.ctx.clearRect(0,0,this.canvas.width,this.canvas.height)}getDimensions(){return{width:this.canvas?.width||0,height:this.canvas?.height||0}}isMobile(){return window.innerWidth<768}destroy(){this.resizeTimeout&&clearTimeout(this.resizeTimeout),this.resizeTimeout=null,window.removeEventListener("resize",this._handleResize),this.canvas&&this.canvas.parentNode&&this.canvas.parentNode.removeChild(this.canvas),this.canvas=null,this.ctx=null}_handleResize(){this.resizeTimeout&&clearTimeout(this.resizeTimeout),this.resizeTimeout=setTimeout(()=>{this.resize(),this.resizeCallback&&this.resizeCallback()},250)}}

package/public/js/celebrations/index.js

@@ -1 +1 @@
-var w=Object.defineProperty;var b=(u,e,i)=>e in u?w(u,e,{enumerable:!0,configurable:!0,writable:!0,value:i}):u[e]=i;var v=(u,e,i)=>b(u,typeof e!="symbol"?e+"":e,i);export{mountCharacter,getCharacters,CHARACTER_SIZES}from"./characters.js";import{resolveCelebrationTraits as M}from"./trait-data.mjs";import{CanvasManager as P}from"./core/canvas.js";import{PhysicsEngine as C,updateMovingParticle as z,updateParticlePhysics as j}from"./core/physics.js";import{createParticle as F}from"./core/particles.js";const c=class c{static isDateInRange(e,i,s,o){const l=new Date,n=l.getMonth()+1,d=l.getDate();return s<e?n===e&&d>=i||n>e||n<e&&n<=s||n===s&&d<=o:(n>e||n===e&&d>=i)&&(n<s||n===s&&d<=o)}static getCurrentTheme(){for(const[e,i]of Object.entries(c.themes)){const[[s,o],[l,n]]=i.dates;if(c.isDateInRange(s,o,l,n))return e}return null}static isCelebrationSeason(){return c.getCurrentTheme()!==null}static getThemes(){return c.themes}constructor(e={}){this.options={theme:e.theme||"auto",intensity:e.intensity||"medium",enabled:e.enabled!==void 0?e.enabled:!0,zIndex:e.zIndex||999,overrides:e.overrides||{}},this.canvasManager=null,this.physicsEngine=null,this.themeModule=null,this.currentTheme=null,this.particles=[],this.specialParticles=[],this.animationFrame=null,this.lastTime=0,this.running=!1,this.initialized=!1}async init(){if(this.initialized){console.warn("[Celebrations] Already initialized");return}console.log("[Celebrations] Initializing...");let e=this.options.theme;if(e==="auto"&&(e=c.getCurrentTheme(),!e)){console.log("[Celebrations] No active celebration detected");return}if(!c.themes[e]){console.error(`[Celebrations] Unknown theme: ${e}`);return}this.currentTheme=e,console.log(`[Celebrations] Loading theme: ${e}`);try{const s=await import(c.themes[e].module);this.themeModule=s.default,console.log(`[Celebrations] Theme loaded: ${this.themeModule.displayName}`)}catch(i){console.error(`[Celebrations] Failed to load theme module: ${i.message}`);return}this.canvasManager=new P({canvasId:"celebrations-canvas",zIndex:this.options.zIndex}),this.canvasManager.create(),this.physicsEngine=new C({gustInterval:[5e3,15e3],gustStrength:[-2,2]}),window.addEventListener("resize",()=>{this.canvasManager.resize(),this.resetParticles()}),this.resetParticles(),this.initialized=!0,console.log("[Celebrations] Initialized successfully"),this.options.enabled&&this.start()}isParticleEnabled(e){return!this.disabledTypes?.has(e.type)}resetParticles(){const e=Object.assign({},this.themeModule.intensityConfig[this.options.intensity]),i=a=>String(a).toLowerCase().replace(/[^a-z0-9]/g,""),s=[...Object.keys(e),...this.themeModule.decorationKeys||[]],o=a=>s.find(r=>i(r)===i(a))||a,l=a=>["true","1","yes","on"].includes(String(a).toLowerCase()),n=this.themeModule.optInDecorations||{},d=Object.entries(this.options.overrides).some(([a,r])=>["snowonly","fallingonly"].includes(i(a))&&l(r));for(const a of Object.values(n))e[a.chance]=0;for(const[a,r]of Object.entries(this.options.overrides)){if((i(a)==="snowonly"||i(a)==="fallingonly")&&l(r)){for(const m of this.themeModule.decorationKeys||[])e[m]=0;continue}const p=Object.keys(n).find(m=>i(m)===i(a));if(p&&!d&&l(r)){const m=n[p];e[m.chance]=m.value}r==="off"&&(e[o(a)]=0)}const t=M(this.themeModule.name,this.options.overrides);Object.assign(e,t.config),this.disabledTypes=t.disabledTypes,this.disabledGlobals=t.disabledGlobals,this.config=e;const f=this.canvasManager.canvas.width,h=this.canvasManager.canvas.height;this.particles=[],this.specialParticles=[];const g=e.initialParticleRatio!==void 0?e.initialParticleRatio:1,y=Math.floor(e.count*g);if(this.themeModule.createFallingParticle)for(let a=0;a<y;a++){const r=this.themeModule.createFallingParticle(f,h,e);r.y=Math.random()*h,this.isParticleEnabled(r)&&this.particles.push(r)}else for(let a=0;a<y;a++){const r=F(e,f,h);r.y=Math.random()*h,this.isParticleEnabled(r)&&this.particles.push(r)}if(this.themeModule.createInitialDecorations){const a=this.themeModule.createInitialDecorations(f,h,e);this.specialParticles.push(...a.filter(r=>this.isParticleEnabled(r))),console.log(`[Celebrations] Created ${a.length} decorations`)}console.log(`[Celebrations] Created ${y}/${e.count} particles (${this.options.intensity}, ${Math.round(g*100)}% initial)`)}start(){if(!this.initialized){console.warn("[Celebrations] Cannot start - not initialized");return}if(this.running){console.warn("[Celebrations] Already running");return}console.log("[Celebrations] Starting animation"),this.running=!0,this.lastTime=performance.now(),this.animate()}pause(){this.running&&(console.log("[Celebrations] Pausing animation"),this.running=!1,this.animationFrame&&(cancelAnimationFrame(this.animationFrame),this.animationFrame=null))}resume(){this.running||this.start()}destroy(){console.log("[Celebrations] Destroying effect"),this.pause(),this.canvasManager&&this.canvasManager.canvas&&this.canvasManager.canvas.remove(),this.particles=[],this.specialParticles=[],this.canvasManager=null,this.physicsEngine=null,this.themeModule=null,this.initialized=!1}setIntensity(e){if(!["light","medium","heavy"].includes(e)){console.error(`[Celebrations] Invalid intensity: ${e}`);return}console.log(`[Celebrations] Changing intensity to: ${e}`),this.options.intensity=e,this.resetParticles()}async setTheme(e){console.log(`[Celebrations] Changing theme to: ${e}`);const i=this.running;this.pause(),await new Promise(s=>setTimeout(s,20)),this.initialized=!1,this.canvasManager&&this.canvasManager.clear(),this.particles=[],this.specialParticles=[],this.canvasManager&&this.canvasManager.clear(),this.options.theme=e,await this.init(),i&&this.start()}animate(){if(!this.running)return;const e=performance.now(),i=e-this.lastTime;this.lastTime=e,this.canvasManager.clear();const s=this.canvasManager.ctx,o=this.canvasManager.canvas.width,l=this.canvasManager.canvas.height,n=this.config;this.physicsEngine.updateWind(e);const d=this.physicsEngine.getWindForce();if(this.particles.length<n.count&&Math.random()<.05&&this.themeModule.createFallingParticle){const t=this.themeModule.createFallingParticle(o,l,n);(t.y===void 0||t.y<0)&&(t.y=-20),this.isParticleEnabled(t)&&this.particles.push(t)}if(this.particles.forEach((t,f)=>{if(j(t,i,d),t.y>l+50&&(t.y=-20,t.x=Math.random()*o),t.x<-50&&(t.x=o+50),t.x>o+50&&(t.x=-50),this.themeModule.drawSnowflake&&t.type==="snowflake")this.themeModule.drawSnowflake(s,t);else if(this.themeModule["draw"+this.capitalizeFirst(t.type)]){const h="draw"+this.capitalizeFirst(t.type);this.themeModule[h](s,t,e)}else s.save(),s.globalAlpha=t.opacity,s.fillStyle=this.themeModule.colors?.primary||"#ffffff",s.beginPath(),s.arc(t.x,t.y,t.size,0,Math.PI*2),s.fill(),s.restore()}),this.themeModule.updateSpecialParticles&&this.themeModule.updateSpecialParticles(this.specialParticles,i,o,l),this.specialParticles=this.specialParticles.filter(t=>{if(!t.active||!this.isParticleEnabled(t))return!1;if(!t.static){z(t,i,e);const g=t.type==="train"?600:200;if(t.x<-g||t.x>o+g)return t.active=!1,!1}if(!isFinite(t.x)||!isFinite(t.y)||t.size&&!isFinite(t.size))return console.warn("[Celebrations] Invalid particle values, removing:",t.type),t.active=!1,!1;const h="draw"+this.capitalizeFirst(t.type);return this.themeModule[h]&&this.themeModule[h](s,t,e),!0}),this.themeModule.spawnSpecialParticle){const t=this.themeModule.spawnSpecialParticle(this.specialParticles,o,l,n);t&&this.isParticleEnabled(t)&&this.specialParticles.push(t)}this.themeModule.drawGlobalEffects&&!this.disabledGlobals?.has("lightning")&&this.themeModule.drawGlobalEffects(s,e,o,l),this.animationFrame=requestAnimationFrame(()=>this.animate())}capitalizeFirst(e){if(!e)return"";const i=e.replace(/-([a-z])/g,(s,o)=>o.toUpperCase());return i.charAt(0).toUpperCase()+i.slice(1)}};v(c,"themes",{christmas:{module:"./themes/christmas.js?v=20261003-characters",dates:[[12,1],[1,1]],displayName:"Christmas",emoji:"\u{1F384}"},halloween:{module:"./themes/halloween.js?v=20261003-characters",dates:[[10,26],[10,31]],displayName:"Halloween",emoji:"\u{1F383}"},valentines:{module:"./themes/valentines.js?v=20261003-characters",dates:[[2,9],[2,14]],displayName:"Valentine's Day",emoji:"\u{1F495}"},"guy-fawkes":{module:"./themes/guy-fawkes.js?v=20261003-characters",dates:[[11,1],[11,5]],displayName:"Guy Fawkes Night",emoji:"\u{1F386}"},"st-patricks":{module:"./themes/st-patricks.js?v=20261003-characters",dates:[[3,12],[3,17]],displayName:"St Patrick's Day",emoji:"\u2618\uFE0F"},"st-andrews":{module:"./themes/st-andrews.js?v=20261003-characters",dates:[[11,25],[11,30]],displayName:"St Andrew's Day",emoji:"\u{1F3F4}\u{E0067}\u{E0062}\u{E0073}\u{E0063}\u{E0074}\u{E007F}"},"st-davids":{module:"./themes/st-davids.js?v=20261003-characters",dates:[[2,24],[3,1]],displayName:"St David's Day",emoji:"\u{1F3F4}\u{E0067}\u{E0062}\u{E0077}\u{E006C}\u{E0073}\u{E007F}"},"st-georges":{module:"./themes/st-georges.js?v=20261003-characters",dates:[[4,18],[4,23]],displayName:"St George's Day",emoji:"\u{1F3F4}\u{E0067}\u{E0062}\u{E0065}\u{E006E}\u{E0067}\u{E007F}"}});export let CelebrationsEffect=c;export default CelebrationsEffect;
+var M=Object.defineProperty;var b=(d,e,s)=>e in d?M(d,e,{enumerable:!0,configurable:!0,writable:!0,value:s}):d[e]=s;var v=(d,e,s)=>b(d,typeof e!="symbol"?e+"":e,s);export{mountCharacter,getCharacters,CHARACTER_SIZES}from"./characters.js";import{launchMakeItRain as w}from"./themes/rain-control.js";import{isEasterSeason as P,isChineseNewYearSeason as j}from"./themes/calendar.js";import{resolveCelebrationTraits as C}from"./trait-data.mjs";import{CanvasManager as k}from"./core/canvas.js";import{PhysicsEngine as N,updateMovingParticle as S,updateParticlePhysics as I}from"./core/physics.js";import{createParticle as z}from"./core/particles.js";const h=class h{static isDateInRange(e,s,i,n,l=new Date){const o=l.getMonth()+1,c=l.getDate();return i<e?o===e&&c>=s||o>e||o<i||o===i&&c<=n:(o>e||o===e&&c>=s)&&(o<i||o===i&&c<=n)}static getCurrentTheme(e=new Date){for(const[s,i]of Object.entries(h.themes)){if(i.isInSeason){if(i.isInSeason(e))return s;continue}if(!i.dates)continue;const[[n,l],[o,c]]=i.dates;if(h.isDateInRange(n,l,o,c,e))return s}return null}static isCelebrationSeason(){return h.getCurrentTheme()!==null}static getThemes(){return h.themes}constructor(e={}){this.options={theme:e.theme||(e.message?"greeting":"auto"),intensity:e.intensity||"medium",enabled:e.enabled!==void 0?e.enabled:!0,zIndex:e.zIndex||999,overrides:{...e.overrides||{},...typeof e.message=="string"?{message:e.message}:{}}},this.canvasManager=null,this.physicsEngine=null,this.themeModule=null,this.currentTheme=null,this.particles=[],this.specialParticles=[],this.animationFrame=null,this.lastTime=0,this.running=!1,this.initialized=!1}async init(){if(this.initialized){console.warn("[Celebrations] Already initialized");return}console.log("[Celebrations] Initializing...");let e=this.options.theme;if(e==="auto"&&this.options.overrides.message&&(e="greeting"),e==="auto"&&(e=h.getCurrentTheme(),!e)){console.log("[Celebrations] No active celebration detected");return}if(!h.themes[e]){console.error(`[Celebrations] Unknown theme: ${e}`);return}this.currentTheme=e,console.log(`[Celebrations] Loading theme: ${e}`);try{const i=await import(h.themes[e].module);this.themeModule=i.default;const n=this.options.overrides.message||this.themeModule.defaultMessage;if(n){const{prepareSparklerFont:l}=await import("./themes/sparkler-font.js");await l(n)}console.log(`[Celebrations] Theme loaded: ${this.themeModule.displayName}`)}catch(s){console.error(`[Celebrations] Failed to load theme module: ${s.message}`);return}this.canvasManager=new k({canvasId:"celebrations-canvas",zIndex:this.options.zIndex,onResize:()=>{this.initialized&&this.resetParticles()}}),this.canvasManager.create(),this.physicsEngine=new N({gustInterval:[5e3,15e3],gustStrength:[-2,2]}),this.resetParticles(),this.initialized=!0,console.log("[Celebrations] Initialized successfully"),this.options.enabled&&this.start()}isParticleEnabled(e){return!this.disabledTypes?.has(e.type)}resetParticles(){const e=Object.assign({},this.themeModule.intensityConfig[this.options.intensity]);e.sparkler={message:this.options.overrides.message,style:this.options.overrides["sparkler-style"],colour:this.options.overrides["sparkler-colour"]||this.options.overrides["sparkler-color"],greeting:this.options.overrides["sparkler-greeting"],year:this.options.overrides["sparkler-year"]};const s=a=>String(a).toLowerCase().replace(/[^a-z0-9]/g,""),i=[...Object.keys(e),...this.themeModule.decorationKeys||[]],n=a=>i.find(r=>s(r)===s(a))||a,l=a=>["true","1","yes","on"].includes(String(a).toLowerCase()),o=this.themeModule.optInDecorations||{},c=Object.entries(this.options.overrides).some(([a,r])=>["snowonly","fallingonly"].includes(s(a))&&l(r));for(const a of Object.values(o))e[a.chance]=0;for(const[a,r]of Object.entries(this.options.overrides)){if((s(a)==="snowonly"||s(a)==="fallingonly")&&l(r)){for(const u of this.themeModule.decorationKeys||[])e[u]=0;continue}const p=Object.keys(o).find(u=>s(u)===s(a));if(p&&!c&&l(r)){const u=o[p];e[u.chance]=u.value}r==="off"&&(e[n(a)]=0)}const t=C(this.themeModule.name,this.options.overrides);Object.assign(e,t.config),this.disabledTypes=t.disabledTypes,this.disabledGlobals=t.disabledGlobals,this.config=e;const g=this.canvasManager.canvas.width,m=this.canvasManager.canvas.height;this.particles=[],this.specialParticles=[];const f=e.initialParticleRatio!==void 0?e.initialParticleRatio:1,y=Math.floor(e.count*f);if(this.themeModule.createFallingParticle)for(let a=0;a<y;a++){const r=this.themeModule.createFallingParticle(g,m,e);r.y=Math.random()*m,this.isParticleEnabled(r)&&this.particles.push(r)}else for(let a=0;a<y;a++){const r=z(e,g,m);r.y=Math.random()*m,this.isParticleEnabled(r)&&this.particles.push(r)}if(this.themeModule.createInitialDecorations){const a=this.themeModule.createInitialDecorations(g,m,e);this.specialParticles.push(...a.filter(r=>this.isParticleEnabled(r))),console.log(`[Celebrations] Created ${a.length} decorations`)}console.log(`[Celebrations] Created ${y}/${e.count} particles (${this.options.intensity}, ${Math.round(f*100)}% initial)`)}start(){if(!this.initialized){console.warn("[Celebrations] Cannot start - not initialized");return}if(this.running){console.warn("[Celebrations] Already running");return}console.log("[Celebrations] Starting animation"),this.running=!0,this.lastTime=performance.now(),this.animate()}pause(){this.running&&(console.log("[Celebrations] Pausing animation"),this.running=!1,this.animationFrame&&(cancelAnimationFrame(this.animationFrame),this.animationFrame=null))}resume(){this.running||this.start()}destroy(){console.log("[Celebrations] Destroying effect"),this.pause(),this.canvasManager&&this.canvasManager.destroy(),this.particles=[],this.specialParticles=[],this.canvasManager=null,this.physicsEngine=null,this.themeModule=null,this.initialized=!1}setIntensity(e){if(!["light","medium","heavy"].includes(e)){console.error(`[Celebrations] Invalid intensity: ${e}`);return}console.log(`[Celebrations] Changing intensity to: ${e}`),this.options.intensity=e,this.resetParticles()}async setTheme(e){console.log(`[Celebrations] Changing theme to: ${e}`);const s=this.running;this.pause(),await new Promise(i=>setTimeout(i,20)),this.initialized=!1,this.canvasManager&&this.canvasManager.clear(),this.particles=[],this.specialParticles=[],this.canvasManager&&this.canvasManager.clear(),this.options.theme=e,await this.init(),s&&this.start()}animate(){if(!this.running)return;const e=performance.now(),s=e-this.lastTime;this.lastTime=e,this.canvasManager.clear();const i=this.canvasManager.ctx,n=this.canvasManager.canvas.width,l=this.canvasManager.canvas.height,o=this.config;this.physicsEngine.updateWind(e);const c=this.physicsEngine.getWindForce();if(this.particles.length<o.count&&Math.random()<.05&&this.themeModule.createFallingParticle){const t=this.themeModule.createFallingParticle(n,l,o);(t.y===void 0||t.y<0)&&(t.y=-20),this.isParticleEnabled(t)&&this.particles.push(t)}if(this.particles.forEach((t,g)=>{if(I(t,s,c),t.y>l+50&&(t.y=-20,t.x=Math.random()*n),t.x<-50&&(t.x=n+50),t.x>n+50&&(t.x=-50),this.themeModule.drawSnowflake&&t.type==="snowflake")this.themeModule.drawSnowflake(i,t);else if(this.themeModule["draw"+this.capitalizeFirst(t.type)]){const m="draw"+this.capitalizeFirst(t.type);this.themeModule[m](i,t,e)}else i.save(),i.globalAlpha=t.opacity,i.fillStyle=this.themeModule.colors?.primary||"#ffffff",i.beginPath(),i.arc(t.x,t.y,t.size,0,Math.PI*2),i.fill(),i.restore()}),this.themeModule.updateSpecialParticles&&this.themeModule.updateSpecialParticles(this.specialParticles,s,n,l),this.specialParticles=this.specialParticles.filter(t=>{if(!t.active||!this.isParticleEnabled(t))return!1;if(!t.static){S(t,s,e);const f=t.type==="train"?600:200;if(t.x<-f||t.x>n+f)return t.active=!1,!1}if(!isFinite(t.x)||!isFinite(t.y)||t.size&&!isFinite(t.size))return console.warn("[Celebrations] Invalid particle values, removing:",t.type),t.active=!1,!1;const m="draw"+this.capitalizeFirst(t.type);return this.themeModule[m]&&this.themeModule[m](i,t,e),!0}),this.themeModule.spawnSpecialParticle){const t=this.themeModule.spawnSpecialParticle(this.specialParticles,n,l,o);t&&this.isParticleEnabled(t)&&this.specialParticles.push(t)}this.themeModule.drawGlobalEffects&&!this.disabledGlobals?.has("lightning")&&this.themeModule.drawGlobalEffects(i,e,n,l),this.animationFrame=requestAnimationFrame(()=>this.animate())}capitalizeFirst(e){if(!e)return"";const s=e.replace(/-([a-z])/g,(i,n)=>n.toUpperCase());return s.charAt(0).toUpperCase()+s.slice(1)}};v(h,"themes",{"chinese-new-year":{module:"./themes/chinese-new-year.js?v=20261015-occasions",dates:null,isInSeason:j,displayName:"Chinese New Year",emoji:"\u{1F409}"},"new-year":{module:"./themes/new-year.js?v=20261015-occasions",dates:[[12,31],[1,2]],displayName:"New Year",emoji:"\u{1F389}"},easter:{module:"./themes/easter.js?v=20261015-occasions",dates:null,isInSeason:P,displayName:"Easter",emoji:"\u{1F423}"},"summer-garden":{module:"./themes/summer-garden.js?v=20261015-occasions",dates:[[6,1],[8,31]],displayName:"Summer Garden",emoji:"\u{1F33C}"},christmas:{module:"./themes/christmas.js?v=20261015-occasions",dates:[[12,1],[12,30]],displayName:"Christmas",emoji:"\u{1F384}"},halloween:{module:"./themes/halloween.js?v=20261003-characters",dates:[[10,26],[10,31]],displayName:"Halloween",emoji:"\u{1F383}"},valentines:{module:"./themes/valentines.js?v=20261003-characters",dates:[[2,9],[2,14]],displayName:"Valentine's Day",emoji:"\u{1F495}"},"guy-fawkes":{module:"./themes/guy-fawkes.js?v=20261003-characters",dates:[[11,1],[11,5]],displayName:"Guy Fawkes Night",emoji:"\u{1F386}"},"st-patricks":{module:"./themes/st-patricks.js?v=20261003-characters",dates:[[3,12],[3,17]],displayName:"St Patrick's Day",emoji:"\u2618\uFE0F"},"st-andrews":{module:"./themes/st-andrews.js?v=20261003-characters",dates:[[11,25],[11,30]],displayName:"St Andrew's Day",emoji:"\u{1F3F4}\u{E0067}\u{E0062}\u{E0073}\u{E0063}\u{E0074}\u{E007F}"},"st-davids":{module:"./themes/st-davids.js?v=20261003-characters",dates:[[2,24],[3,1]],displayName:"St David's Day",emoji:"\u{1F3F4}\u{E0067}\u{E0062}\u{E0077}\u{E006C}\u{E0073}\u{E007F}"},"st-georges":{module:"./themes/st-georges.js?v=20261003-characters",dates:[[4,18],[4,23]],displayName:"St George's Day",emoji:"\u{1F3F4}\u{E0067}\u{E0062}\u{E0065}\u{E006E}\u{E0067}\u{E007F}"}}),(()=>{h.themes.winter={module:"./themes/winter.js?v=20261015-occasions",dates:[[12,1],[2,28]],displayName:"Winter",emoji:"\u2744\uFE0F"},h.themes["make-it-rain"]={module:"./themes/make-it-rain.js?v=20261015-occasions",dates:null,displayName:"Make it rain",emoji:"\u{1F327}\uFE0F"},h.themes["money-rain"]={module:"./themes/money-rain.js?v=20261015-occasions",dates:null,displayName:"Money Rain",emoji:"\u{1F4B8}"};for(const[e,s,i]of[["graduation","Graduation","\u{1F393}"],["birthday","Birthday","\u{1F382}"],["anniversary","Anniversary","\u{1F48D}"],["greeting","Sparkler greeting","\u2728"]])h.themes[e]={module:`./themes/${e}.js?v=20261015-occasions`,dates:null,displayName:s,emoji:i};h.themes.autumn={module:"./themes/autumn.js?v=20261015-occasions",dates:[[9,1],[11,30]],displayName:"Autumn",emoji:"\u{1F342}"}})();export let CelebrationsEffect=h;export default CelebrationsEffect;export function makeItRain(d={}){return w(CelebrationsEffect,d)}export function moneyRain(d={}){return w(CelebrationsEffect,d,"money-rain")}