@plitzi/sdk-shared 0.38.9 → 0.38.11

package/CHANGELOG.md

@@ -1,5 +1,261 @@
 # @plitzi/sdk-shared
 
+## 0.38.11
+
+### Patch Changes
+
+- cadf70a: - **`server.cache.invalidate` drops what a page is rendered from** (`@plitzi/sdk-server`): the pages, the RSC answers
+  and the schema data they are rendered from go together. It dropped the pages alone, and the next request rendered
+  the same page again from the schema still cached under the same key — a publish that invalidated the space changed
+  nothing until the schema's TTL ran out. `clear()` and `size` cover the three. A filter on `hostname` drops the schema
+  data too, which belongs to no one host. `server.cache` is `null` only when nothing is cached (`cacheTtlMs: 0` and
+  `rsc.cacheTtlMs: 0`).
+
+  ## Style inspector
+  - **Finds a property** (`@plitzi/sdk-style`): a search above the categories narrows them to the ones that edit what was
+    typed — a CSS name in any order of its words (`border radius` finds the four corners), a category's title, or a
+    common word for it (`bg`, `rounded`) — opens them, and shows the advanced rows when the match lives there. Escape
+    clears it. The categories' properties live in one list (`categoryKeys.ts`) that the dots, the advanced hint and the
+    search all read.
+  - **Rows that fit**: a section with more than two controls puts its label above them and lays them out in as many
+    columns as the panel is wide, instead of one row where every label was cut (`Appearan…`, `Cell Spaci…`, the five
+    scroll-snap controls). A row's label column is 80px.
+  - **Where a value comes from, said quietly**: the label's tint keeps its four meanings — set here, from a token, bound
+    to data, inherited — without the solid blocks of colour; hovering says which (an inherited one names its selector and
+    breakpoint) and that a click resets it, the click shows it by striking the label through. The footer's info icon
+    holds the legend, and its arrow folds every category.
+  - **What is being edited**: an "Editing … › Hover" line under the pickers whenever the rules being written are not the
+    selector's plain ones, with a button back to them. Ancestor, pseudo-element and condition fold behind a toggle —
+    never while one is in use.
+  - The class being edited is the panel's one strong mark (violet), the element's type defaults a softer one; the tools'
+    tabs fit the panel and are reachable from the keyboard.
+
+  - **Lists edited in a popover, all alike**: box and text shadows, transforms, transitions and filters share one row
+    (the CSS it writes, a swatch, a remove button) and one popover (a title, a close button, Escape, the focus moved
+    into it). What none of them could read is now kept and edited as text instead of being replaced with a default — a
+    token for the whole value, `drop-shadow(…)`, `url(#…)`.
+  - **Values read the way CSS writes them**: a shadow with two, three or four lengths and its color on either end;
+    `rgba(…)` inside text shadows and filters no longer split; negative shadow offsets accepted; a transition with any
+    of its parts left out; brightness, contrast and saturation past 1. Transition presets are written as CSS — the
+    preset names (`easeInQuad`) made the browser drop the whole declaration — the curve can be dragged into one of your
+    own, and the preview stops with the editor. `font-color` (not CSS) became `color`.
+  - **Background layers keep what they hold**: a repeating gradient (now a switch), a radial gradient's explicit size, a
+    token or `image-set()` as a layer (a "Custom (CSS)" layer), a one-value position read as CSS reads it (`20%` is
+    `20% center`), lists shorter than the layers repeated as CSS repeats them, an unset repeat read as tiling, two-position
+    stops, negative angles — every one of them was rewritten on the next edit of any layer. Defaults are no longer
+    written back, and "Token values" no longer bakes resolved tokens into the layers.
+  - **A layer's editor in two halves** — what it draws, then where it goes (size, position, tile, attachment, clip,
+    which now offers `text`). The gradient's stops sit on one bar, each a handle that drags or moves with the arrow keys;
+    the stop's color and position below it. Previews and swatches resolve the space's tokens.
+  - Spacing tells margin (dashed, outside) from padding; Border's sides are labelled and readable in the dark theme; a
+    class's menu says what each action does to whom; the Style Manager opens at a size that holds both columns.
+
+  ## Builder
+  - **Shortcuts**: `?` shows every shortcut the builder answers to — the same list the "Nothing selected" card teaches
+    from — and ⌘\ / Ctrl+\ hides both side panels for the canvas alone and brings back the ones that were open. Both
+    work with the canvas focused.
+  - **Panels keep their width**: each side panel opens at the width it was left at; the right one starts at 380px.
+  - **Text no smaller than 11px** across the builder's panels (it went down to 10px in fifty places).
+
+  ## Realtime
+  - **A page hears what it sent when it asks to** (`@plitzi/sdk-shared`, `@plitzi/sdk-server`, `@plitzi/sdk-elements`):
+    `publishOn('room', 'react', data, { echo: true })`, `useChannel().publish(type, data, { echo: true })` and the
+    channel's `publish` callback (`echo`) hand the message back to the page that sent it too, once the server took it —
+    stamped like everyone's, with `echo: true`, its `from` the channel's `me`. Without it a page still never hears its
+    own messages, and the docs said "every page on its topic hears it": they now say every OTHER page. Presence never
+    echoes.
+  - **A topic is opened only once it names one** (`@plitzi/sdk-elements`): `useChannel` — and so the `channel` element —
+    opens a topic only when a channel of the space covers it, by the same `matchChannel` the server decides by. A topic
+    written from data that has not arrived (`room:` while its provider loads, or its template still as text) asked the
+    server for both, was refused with a 403 and a console error on every load, and is now waited for.
+  - **Pages that watch** (`@plitzi/sdk-server`, `@plitzi/cli`): a connection whose page carries the `plitzi-observer`
+    cookie hears its topics and says nothing on them — no `$join`, no presence, its publishes taken and dropped.
+    `page check`, `page shot` and `verify` load pages that way, so checking a live site is no longer a visitor walking
+    into a room (`X walked in`, a member more in every picture). `--presence` takes part as a visitor does.
+
+  ## Authoring
+  - **`template-in-value`** (refused): a `{{ }}` inside an attribute that is an object or a list — a provider's
+    `input`, a list's `items`, a plugin's settings — is never evaluated: only an attribute that is text is interpolated,
+    and the page server reads attributes as saved. A provider's `input` also replaced the route param of the same name
+    the action was already given, so `input: { room: '{{ navigation.routeParams.room }}' }` reached the task as `""` and
+    the page answered 404; its refusal says the action is handed the page's route and query params already. Anything
+    else is a binding on the attribute. `mockData`, a sample, is not held to it.
+  - **Rules on top of a class need no `id`** (`class: [card, { gap: '6px' }]`): they are named after the id the element
+    is given, written or not. `modifier-without-id` is gone; a one-off tweak no longer needs a name nothing reads.
+  - **Typed list rows have `inTemplate`**, as untyped ones do, and `bindTemplate`, `visibleWhen`, `hiddenWhen` and
+    `variantFrom` take a typed source's path as well as a name: turning a list typed broke every template of its rows.
+  - **`when({ field, operator: 'empty' })`** takes no `value` (nor `notEmpty`), as flows.md recommends; it did not
+    type-check.
+  - **Data-driven colours**: a style binding on a custom property (`{ to: '--who', category: 'style' }`) is written as
+    named — it was camel-cased into `who` — so a class reads `var(--who, var(--muted))`. A style binding's value carrying
+    `;` or braces is not written: the page server writes inline styles as text, and such a value added declarations of
+    its own. `binding-target-unknown` on `style` or a CSS property says to bind it in the `style` category.
+  - `unknown-attribute` for `decorative` on an `svg` or a `fontAwesome` says what it means: without a `label` it is
+    already hidden from screen readers.
+
+  - **A folder nobody declared says where to declare it**: `folder-undeclared` (a page, a layout, a folder's parent)
+    ends with `pageFolders: [{ id, name }]` on the space, and with the line of the `pageFamily` that wrote the page. A
+    folder starts its pages' addresses (`/docs/quickstart`), so a misspelt one is never declared on the author's behalf.
+    The skill's `pageFamily` example declares its folder.
+  - **A tag is an element**: a `subType` this element has not but another has — `container({ subType: 'ol' })` — names
+    that element (`list({ subType: 'ol' })`) instead of the value two letters away (`dl`). Read off the elements'
+    declarations, for every element and tag.
+  - **A `pageFamily`'s body is written once**: `repeated-shape` and `repeated-on-pages` no longer count the same part of
+    each page of one family as copies — they were offering a component for exactly what the docs recommend. Copies within
+    one page, or across pages written one by one, are still offered.
+  - **Colour emoji are not text to `page check`**: a character painted in its own colours (🎲, `❤️`, a keycap, a ZWJ
+    sequence) is left out of the contrast measure, which compared `color` with the tile behind it and failed `verify`
+    in the theme whose text colour was close to the tile. A symbol drawn as text (✓, ★) is still measured.
+
+  - **`declared-callback-target`** (refused): a value beside `on` in `declaredCallback(…, { on, date })` — written as
+    `openModal`'s target reads — was read nowhere, and the step ran without it. Refused, with the `params` it goes in
+    (`{ on: 'calendar', params: { date } }`) and whether it is one of the callback's declared params.
+  - The skill's list rows show the typed form beside the untyped one: with `items` typed by a sample, `r.item` is a path
+    (`from: r.item.title`), not text to put in a template string.
+  - **`slot-not-class`** (refused): rules written in place in a slot — `slots: { error: [fieldError, { color }] }`, past
+    the type in JavaScript or a spec rebuilt from JSON — were taken for a declaration with no rules, and `authorSpace`
+    failed later with `Cannot read properties of undefined (reading 'desktop')`, naming nothing. Refused where the slot
+    is written, naming the slot and the element, with the `styles()` declaration to hand instead.
+
+  ## CLI
+  - **`page shot --click` (and `--clip`, `--wait-for`, `--scroll-to`, `--steps`) takes any selector**: a value that is
+    not an element's name (letters, digits, `-`, `_`) is a selector, CSS or Playwright's own (`button:has-text("Orbit")`).
+    It was wrapped as a name, and an invalid selector ended the command with Playwright's stack trace; it is now refused
+    with the reason.
+
+  - **`plitzi functions add <package>`**: a package the functions use comes with them, as a function carries its
+    dependencies. Installed in the project, it is bundled (web APIs only, minified, its licence kept) into
+    `src/functions/vendor/<package>.js`, with a `.d.ts` re-exporting the installed package's types, imported as
+    `./vendor/<package>.js` and pushed, built and run with the rest — nothing is resolved anywhere else, so the builder,
+    the sandbox and the push are unchanged. A package that reaches Node (`fs`, `node:*`) is refused, naming what it
+    reached; one past the functions' 1 MB is too; one that reads `process`/`Buffer` is warned about. The build's refusal
+    of a package import now names the command.
+  - **`page shot` targets**: a bare word is an element's name, or — no element named so — a tag (`textarea`); resolved on
+    the loaded page for `--click`, `--clip`, `--scroll-to`, `--wait-for` and `--steps`. In `--steps`, `type` takes a
+    quoted element with spaces (`type ".panel textarea" hola`) — it was cut at its first space and typed the rest — and
+    fails when the click leaves no field focused, rather than sending the keys to the page's shortcuts.
+
+  ## Server
+  - **`server.listen()` resolves once the port answers** (`@plitzi/sdk-server`) — in a fleet, once the first worker
+    does. `serveProject` writes `tmp/dev-server.json` and says `pages on …` after it, not on the line after `listen`:
+    for about 0.4 s a tool trusting the line (CI, Playwright's `webServer`, `page check`) was refused. A port it cannot
+    take still ends the process, or goes to `onListenError`, and the promise is then never resolved.
+  - **Runs set for later** (`@plitzi/sdk-server`, `@plitzi/sdk-shared`, `@plitzi/sdk-authoring`, `@plitzi/plitzi-builder`):
+    a turn that runs out, a bot's move, a hold that lapses — one run starting one of the space's actions in N seconds,
+    whether or not a page is still open. The action says it may be with a **`later` trigger** (no access rule: the run
+    that set it was let in); a flow sets it with `flow.later { action, in, input, key }`, a function with
+    `ctx.later({ … })`, and `flow.cancelLater` / `ctx.cancelLater(key)` drops it. A `key` names it: set again under the
+    same key, the one still waiting is replaced — the newer of two set at once, on every replica — and a running one is
+    left. It is a job of the queue schedules use: due by the store's clock (0 s to 30 days, about a second late at most),
+    once across replicas, retried, shown in Automations → Queue. Refused before anything is queued, with why: no `later`
+    trigger, one switched off, a time out of range, a key that is not one, a server with no jobs. A plugin's functions
+    set none. `ActionJobQueue` gains `cancelPending({ spaceId, key, olderThan? })` and jobs a `key`: the memory, Mongo
+    and MySQL queues implement it, and the shared contract tests it. **MySQL**: `action_jobs` gains `job_key` (and the
+    `action_jobs_key` index), added on first use; with `createTables: false`, run that statement of
+    `mysqlJobSchemaUpgrades()`. A queue of a deployment's own implements `cancelPending` (`09-schedules` shows one).
+  - **A project's `kv` file has one holder** (`@plitzi/sdk-server`): `createFileKv` takes `<file>.lock` with its pid;
+    a second process — another `npm start`, a `--watch` left running — is refused, naming the first (`the server of
+"orbita", on port 8080`) instead of both writing their whole map over each other's changes, and a lock whose process
+    is gone is taken over. `close()` writes what is pending and lets go. A server with `workers` opens the file once, in
+    the primary, and its workers reach it through the fleet (`fleetKv`): each used to open a copy of its own.
+  - **A self-hosted project's credentials** (`@plitzi/sdk-server`, `@plitzi/cli`): `serveProject` answers
+    `getCredential` from `PLITZI_CREDENTIALS` in `.env` — one JSON object, credential id → its keys — so
+    `ctx.fetch({ credential })`, a connector and an `http.request` step work on the project's own server, not only in
+    `functions dev`. The same variable for both (it was `PLITZI_FUNCTIONS_CREDENTIALS`, read by the CLI alone); a value
+    that is not that object is refused with how to write it, instead of every credential going missing.
+  - **`HOST` beyond loopback says where to open it**: with `HOST=0.0.0.0`, `serveProject` prints the machine's network
+    addresses — what a tablet on the same Wi-Fi opens — and that anyone on that network can. `.env.example` names `HOST`
+    and `PLITZI_CREDENTIALS`.
+
+  ## SDK
+  - **`useElementSize(ref)`** (`@plitzi/plitzi-sdk`): the size a plugin's own box is drawn at, followed as it changes —
+    what `useDisplayMode()` cannot say: a tablet held upright is `mobile` by the window and still a week wide by the
+    plugin's box. `undefined` until measured, so the server's page and the hydrated one agree. The breakpoints are
+    unchanged.
+  - The functions docs say how a task's `params` types (how the builder edits them: `codemirror-json`) and an action's
+    `input` types (what the value is: `json`) correspond.
+
+## 0.38.10
+
+### Patch Changes
+
+- 200da2f: - **`focus-on-field-box`** (`@plitzi/sdk-authoring`): a warning for a `focus` or `focus-visible` state on a text
+  field's or a select's `input` slot. That slot is the box the field is drawn in, a `<div>` that never takes focus, so
+  the rule was never seen and a keyboard user tabbing to the field found no ring. The fix it names: `'focus-within'` on
+  the same class, or the state on the `field` slot.
+  - **`modalContainer` says how it is laid out** (`@plitzi/sdk-elements`): its description now names its slots and how
+    they sit — the dim layer and the dialog side by side, not one inside the other; the dialog centred by `top`/`left`
+    50% and a `translate`. A space styled the dim layer as a flex container to place the dialog, which moved nothing.
+  - **A field shows where the keyboard is** (`@plitzi/plitzi-sdk`, `@plitzi/sdk-elements`): a text field's or a select's
+    box is ringed (`2px solid currentColor`) while the field inside has keyboard focus, and a textarea while it has. No
+    text field or select showed any focus at all: the box had `outline: none`, and the field inherited it. One class of
+    specificity, so whatever a space writes about the outline wins; never in the builder's canvas, where the selection is
+    the ring. The field no longer inherits the box's outline — the box draws it.
+  - **The dim layer of a modal and a dialog is `rgb(0 0 0 / 50%)`** (`@plitzi/plitzi-sdk`, `@plitzi/sdk-elements`), not
+    black at `opacity: 0.5`: the default looks the same, and a colour a space gives the layer is drawn as it is — it was
+    halved. A space that set its own colour sees it darker: the one it wrote.
+  - **`required-message-unused`** (`@plitzi/sdk-authoring`): a warning for a `requiredMessage` on a field nothing requires —
+    since 0.38.9 a field is optional unless `required: true`, so the message is never shown and an empty answer is sent.
+    The formControl's description, the cheat sheet and the forms recipe say the default.
+  - **A page's title can say its record** (`@plitzi/sdk-shared`, `@plitzi/sdk-server`, `@plitzi/sdk-elements`,
+    `@plitzi/sdk-authoring`): `seoTitle` and `seoDescription` may be templates over the page's `runtime: 'server'`
+    providers (its layouts' too) and `navigation` — `'{{ apiContainer_post.title }} — Blog'`. The server evaluates them
+    as it writes the head, from the answers it already has; the browser evaluates the same over `rsc.data`, so the tab
+    follows a navigation from record to record. One that reads anything else — a browser provider, `state` — is refused
+    (`page-template`): it was written into the head as it was, braces included. A declaration's `serverTemplates` names
+    the attributes the page server evaluates against a context of its own (a page's title and description, a provider's
+    `notFound`): the element runtime leaves them as written — interpolated where the page renders, a `|default(…)`
+    resolved to its fallback before the head could read the providers — and the authoring lint reads the same list.
+  - **A page says when its address shows nothing** (`@plitzi/sdk-server`, `@plitzi/sdk-authoring`): `notFound` on the
+    page, one expression over the same answers its title reads — `"{{ not (apiContainer_feed.topics|find('slug',
+navigation.routeParams.slug)) }}"` — sends it with status 404, rendered as written. A provider's own `notFound` reads
+    only its answer, and one in a layout is every page's: a record read from the layout had no way to say it was not
+    there, and the page answered 200.
+  - **The Export keeps the flows of a plugin hosted by `custom`** (`@plitzi/sdk-authoring`): `specFromSpace` judged such
+    an element by `custom`'s own triggers and callbacks, and dropped a flow on the component's event (`onChange` on an
+    editor) as one "a custom never fires" — the space read back was not the space written.
+  - **`page check` reads every word on the page, in the colour the browser paints it** (`@plitzi/sdk-authoring`): what a
+    plugin draws inside an element of the space is measured too, named by the element and a selector; the measure is
+    WCAG's contrast (under 2:1 is unreadable), not "nearly the same colour"; and a colour the browser answers as
+    `oklch()`, `oklab()` or `color(srgb …)` — every token and every `color-mix()` — is read as that, where it was read as
+    `rgb()` numbers and came out near black. A plugin's dark-on-dark status line passed as "nothing wrong".
+  - **`verify` checks every theme the space can be painted in** (`@plitzi/cli`): light and dark, unless the space says
+    light only — "48 checks at 1440 and 390 px, light and dark". A page unreadable in the dark theme passed in the light
+    one; a failure names the theme it was found in.
+  - **`plitzi upgrade` says where fields became optional** (`@plitzi/cli`): for a project last upgraded before 0.38.9,
+    each `formControl(…)` with no `required`, at its file and line — said, never written. And a `.gitkeep` is asked for
+    only in a folder with nothing else in it: `upgrade` wrote one beside code, and `doctor` called it missing once deleted
+    as AGENTS.md asks ("nothing unused") — the three now say the same.
+  - **`devMode` and `devReload` are the project's** (`@plitzi/sdk-server`): `src/config/serverOptions.ts` may set them,
+    over `NODE_ENV`, which they still follow when left out. A deployment started without `NODE_ENV` (a container's `CMD`)
+    says `devMode: false`, and a public action answers with its output alone.
+  - **`page shot --from load`** (`@plitzi/cli`): `--frames` start as soon as the page's HTML is in, not once it settles —
+    an entrance that plays while the page loads had ended before the first picture.
+  - **`heavy-animation` says where each animation is** (`@plitzi/sdk-authoring`): the class and its variant, state or
+    slot — or the `customCss` rule — and writes the fix against that selector. It said "in `customCss`" for an animation
+    declared on a class's variant, and offered `.glow`, a class no space has.
+  - **`page shot --steps`** (`@plitzi/cli`): an interaction played step by step — `click`, `type`, `press`, `wait`,
+    `wait-for`, `shot [label]`, `frames <n> [ms]`, separated by `;` or written in a file (`@file`) — each picture labelled
+    with its step and the time since the first, and said when nothing changed since the one before. A queue filling, a
+    restart, an opening frame by frame took a Playwright script of the project's own. Targets take Playwright's selectors
+    too (`text=Saved`).
+  - **A space's task may take a `number` param** (`@plitzi/sdk-server`): saved functions refused it ("a type the builder
+    cannot draw") while a project's server ran it, so code that worked self-hosted failed on the platform — and the
+    builder draws one, a callback's. A step's params now arrive as the types the task declares, on every server: a
+    `number` written as text is the number, a `boolean` written `'true'` is `true`, as the browser reads a callback's.
+  - **`page shot --as <username>`** (`@plitzi/cli`): signs in first, as `page check --as` does, the password from
+    `PLITZI_CHECK_PASSWORD` in `.env`. A page for signed-in visitors was pictured as the sign-in page it sent the browser
+    to, without a word; `page shot` now says when the page sent it elsewhere, and that the picture is of that page.
+  - **A capture is of the page at rest** (`@plitzi/sdk-mcp`): the local screenshot client takes every picture with
+    `prefers-reduced-motion: reduce`, as the browser pod now does — the declared motion and a space's own keyframes that
+    honour the query are shown finished. A splash still covering its page, or an arrival caught halfway, was what a
+    thumbnail or a `plitzi_look` showed of a page that animates as it loads.
+  - **The server renders in the visitor's theme, not only the class** (`@plitzi/sdk-shared`): `ThemeProvider` set the
+    starting theme from a layout effect, which never runs on a server, so a page was drawn from the theme store's own
+    start — `{{ theme.resolved }}` was `light` under a `<html class="dark">`, and whatever named the scheme (a picture's
+    address, a `when` rule) was swapped for the other one as the page hydrated. The theme a host supplies (the cookie) is
+    now the server's snapshot of the store, and the hydration's; the shared store is never written on the server.
+
 ## 0.38.9
 
 ### Patch Changes

package/dist/actions/validateDocument.mjs

@@ -18,6 +18,7 @@ var s = [
 	"call",
 	"webhook",
 	"schedule",
+	"later",
 	"render",
 	"custom"
 ], u = ["sha256", "sha1"], d = /* @__PURE__ */ new Set([
@@ -78,7 +79,7 @@ var s = [
 			message: "is not valid JSON"
 		}) : h(e, `${g}.params.input`, d);
 	}
-	if (_ !== "schedule") {
+	if (_ !== "schedule" && _ !== "later") {
 		if (!p(v.access) || !c.includes(v.access)) d.push({
 			path: `${g}.params.access`,
 			message: "must say who may start a run this way",

package/dist/authoring/declare.d.ts

@@ -67,6 +67,14 @@ export interface ElementDeclarationData {
      * `plitzi page check`), which would otherwise wait for it to be on screen and report it hidden.
      */
     drawsNothing?: boolean;
+    /**
+     * The attributes the page server evaluates against a context of its own, never where the element renders: a
+     * provider's `notFound`, read against its answer; a page's title and description, read against its server providers.
+     * Interpolated in the element's own scope they resolved to nothing — a `|default(…)` to its fallback — before the
+     * reader that has their names could see them. Read by the element runtime, which leaves them as written, and by the
+     * authoring lint, which holds them to that context.
+     */
+    serverTemplates?: readonly string[];
     content?: {
         attributes?: Record<string, unknown>;
         definition?: {

package/dist/dataSource/getBindingsDetails.mjs

@@ -11,35 +11,35 @@ var c = (e, t, n, r, a) => {
 		fromValue: t ? i(e, t) : void 0,
 		toValue: i(n, o, t ? i(e, t) : void 0)
 	};
-}, l = (l, u, d = {}) => {
-	let { attributes: f, definition: p } = u, { bindings: m } = p;
-	return !m || typeof m == "object" && !Object.keys(m).length ? {
-		attributes: f,
+}, l = (e) => typeof e == "number" || typeof e == "string" && !/[;{}<>]/.test(e), u = (u, d, f = {}) => {
+	let { attributes: p, definition: m } = d, { bindings: h } = m;
+	return !h || typeof h == "object" && !Object.keys(h).length ? {
+		attributes: p,
 		style: {},
-		definition: p
+		definition: m
 	} : s({
-		attributes: f,
-		style: d,
-		definition: p
+		attributes: p,
+		style: f,
+		definition: m
 	}, (s) => {
-		Object.keys(m).forEach((u) => {
-			m[u] && Array.isArray(m[u]) && m[u].length && m[u].forEach((d) => {
-				let { source: f, transformers: p, when: m, enabled: h = !0 } = d, { to: g } = d;
-				if (!g || m && !o(m, l, !1, !0) || !h) return;
-				u === "style" && (g = r(g));
-				let { fromValue: _, toValue: v } = c(l, f, s, u, g), y = _;
-				p && Array.isArray(p) && p.length > 0 && p.forEach((e) => {
+		Object.keys(h).forEach((d) => {
+			h[d] && Array.isArray(h[d]) && h[d].length && h[d].forEach((f) => {
+				let { source: p, transformers: m, when: h, enabled: g = !0 } = f, { to: _ } = f;
+				if (!_ || h && !o(h, u, !1, !0) || !g) return;
+				d === "style" && !_.startsWith("--") && (_ = r(_));
+				let { fromValue: v, toValue: y } = c(u, p, s, d, _), b = v;
+				m && Array.isArray(m) && m.length > 0 && m.forEach((e) => {
 					let { action: r, params: i, enabled: a = !0 } = e;
 					if (!a) return;
 					let o = t[r];
-					o && (y = o.callback(y, n(o, i) ?? {}, s, {
-						...l,
-						sourceTo: v
+					o && (b = o.callback(b, n(o, i) ?? {}, s, {
+						...u,
+						sourceTo: y
 					}));
-				}), u === "initialState" && g === "visibility" && f && i(l, f) !== void 0 && (y = e(y)), (typeof y == "boolean" || typeof y == "number" || y) && (u === "initialState" ? a(s, `definition.${u}.${g}`, y) : a(s, `${u}.${g}`, y));
+				}), d === "initialState" && _ === "visibility" && p && i(u, p) !== void 0 && (b = e(b)), (d !== "style" || l(b)) && (typeof b == "boolean" || typeof b == "number" || b) && (d === "initialState" ? a(s, `definition.${d}.${_}`, b) : a(s, `${d}.${_}`, b));
 			});
 		});
 	});
 };
 //#endregion
-export { l as default };
+export { u as default };

package/dist/index.mjs

@@ -70,27 +70,27 @@ import jn from "./schema/SchemaContext.mjs";
 import { ANCHOR_PATTERN as Mn, anchorOf as Nn, isAnchor as Pn, uniqueAnchor as Fn } from "./schema/anchor.mjs";
 import { COMPONENT_PROPS_SOURCE as In, EMPTY_SCHEMA as Ln, VARIABLE_REGEX as Rn } from "./schema/schemaConstants.mjs";
 import { findLayoutCycle as zn, resolveLayoutChain as Bn } from "./schema/layoutChain.mjs";
-import { collectServerElements as Vn, hasServerElements as Hn, notFoundProvider as Un } from "./schema/serverElements.mjs";
-import { isSnippet as Wn } from "./schema/snippet.mjs";
-import Gn from "./network/NetworkContext.mjs";
-import Kn from "./network/NetworkInternalContext.mjs";
-import { elementFromWire as qn, schemaFromWire as Jn, schemaToWire as Yn } from "./schema/wire.mjs";
-import { SpaceEvents as Xn, spaceEventSchemas as Zn, validateSpaceEvent as Qn } from "./network/spaceEvents.mjs";
-import $n from "./network/graphql/builder/Mutations/index.mjs";
-import er from "./network/graphql/builder/Queries/index.mjs";
-import tr from "./network/graphql/builder/Subscriptions/index.mjs";
-import nr from "./network/graphql/sdk/Mutations/index.mjs";
-import rr from "./network/graphql/sdk/Queries/index.mjs";
-import ir, { RTEvent as ar, RTEventCloseCode as or, getInstance as sr, isRTEvent as cr, isRTEventCloseCode as lr, setInstance as ur } from "./websockets/RTCodec.mjs";
-import { THEME_CLASSES as dr, THEME_COOKIE_NAME as fr, applyThemeClass as pr, isTheme as mr, readThemeCookie as hr, themeFromCookies as gr, writeThemeCookie as _r } from "./theme/themeCookie.mjs";
-import vr, { createThemeState as yr, createThemeStore as br, resolveScheme as xr, setAreaTheme as Sr, setMachineScheme as Cr, setThemeMode as wr, themeFor as Tr } from "./theme/themeStore.mjs";
-import { useThemeStore as Er } from "./theme/ThemeScope.mjs";
-import Dr from "./theme/ThemeProvider.mjs";
-import Or, { SPACE_THEME_AREA as kr } from "./theme/useTheme.mjs";
-import Ar from "./server/actions/useActionsSync.mjs";
-import jr, { cancelRsc as Mr, currentRscLocation as Nr, releaseRscRequests as Pr, rscDataPath as Fr } from "./server/rsc/refreshRsc.mjs";
-import Ir from "./server/rsc/useRscRefresh.mjs";
-import Lr from "./server/rsc/useRscSync.mjs";
-import { PAINTED_STATE_BUDGET as Rr, clearPaintedEntry as zr, paintedEntryFromCookies as Br, paintedKeys as Vr, paintedStateCookieName as Hr, paintedStateFor as Ur, pickPainted as Wr, readPaintedEntry as Gr, writePaintedEntry as Kr } from "./state/paintedState.mjs";
-import { runtimeStatePersist as qr, stateOwner as Jr } from "./state/runtimeStatePersist.mjs";
-export { Mn as ANCHOR_PATTERN, x as BODYLESS_METHODS, y as BuilderContext, $n as BuilderMutations, er as BuilderQueries, In as COMPONENT_PROPS_SOURCE, N as COMPUTED_GLOBALS, S as CONNECTOR_HTTP_METHODS, an as CONTENT_PSEUDOS, mn as CURRENT_SELECTOR, Me as ComponentContext, C as DEFAULT_READ_ENDPOINT, Te as DEV_TOOLS_ATTRIBUTE, St as DISPLAY_MODES, gt as DISPLAY_MODE_MIN_WIDTH, we as DevToolsContext, w as EMPTY_RESPONSE_METHODS, Ln as EMPTY_SCHEMA, ft as EMPTY_STYLE_SCHEMA, hn as EXPANDED_SELECTOR, Ne as FLAG_GATE_PATTERN, Ue as FLAG_LAYERS, Pe as FLAG_NAME_PATTERN, Ft as FontValidationError, on as GENERATED_PSEUDOS, P as GLOBAL_SOURCES, gn as HIDDEN_CLASS, Ee as HIDE_DEV_TOOLS_CSS, ee as INTERVAL_TRIGGER, zt as LAYOUT_GRIDS, m as MAX_PARAM_PASSES, te as MIN_INTERVAL_MS, Yt as MOTION_CONDITIONS, Gn as NetworkContext, Kn as NetworkInternalContext, Rr as PAINTED_STATE_BUDGET, _n as PARENT_ANCESTOR, yt as PLUGIN_CSS_LAYER, sn as PSEUDO_PROPERTIES, oe as ParamsFromURL, ke as PlitziConsole, ot as PlitziServiceContext, st as PlitziServiceProvider, T as READ_ENDPOINT_NAMES, ir as RTCodec, ar as RTEvent, or as RTEventCloseCode, bt as RUNTIME_CSS_LAYER, Ht as RUNTIME_STYLE_ID, kr as SPACE_THEME_AREA, Xt as STYLE_CONDITION_LABELS, Zt as STYLE_MOTION_CONDITIONS, cn as STYLE_PSEUDOS, ln as STYLE_PSEUDO_LABELS, vn as STYLE_STATES, yn as STYLE_STATE_LABELS, Tt as SYSTEM_FONTS, jn as SchemaContext, nr as SdkMutations, rr as SdkQueries, tr as SpaceEventSubscription, Xn as SpaceEvents, pt as StyleBindingsAllowed, lt as StyleVariableCategory, dr as THEME_CLASSES, fr as THEME_COOKIE_NAME, Dr as ThemeProvider, Rn as VARIABLE_REGEX, a as VISITOR_NAME, ct as WHILE_RUNNING_MODES, E as WRITE_ENDPOINT_NAMES, Nn as anchorOf, pr as applyThemeClass, t as authFailureFromResponse, Et as availableFonts, mt as baseDefaultValue, Mr as cancelRsc, Qt as canonicalCondition, o as checkVisitorRoles, zr as clearPaintedEntry, Vn as collectServerElements, $t as conditionAtRule, en as conditionLabel, tn as conditionOfAtRule, k as connectorPresets, D as connectorTokens, b as contexts, B as cookieFromHeader, Ae as createStoreDevToolsLogger, yr as createThemeState, br as createThemeStore, Nr as currentRscLocation, De as debugCookieName, se as delay, Xe as describeChange, $e as diffSchema, et as diffStyle, he as disableReactDevTools, _t as displayModeAt, vt as displayModeWidthRem, V as documentCookies, qn as elementFromWire, H as elementOf, A as emptyManifest, ce as emptyObject, F as evaluateComputed, ae as evaluateRuleGroup, Lt as fallbackForFamily, Dt as familiesInCss, L as fetchManifest, Ze as fieldChanges, c as filters, zn as findLayoutCycle, We as flagUserFromSSR, Ge as flagValues, Le as flagsCookieName, Ot as fontFamilyStack, wt as fontLinkAssets, kt as fontUrlResolver, Rt as fontsFromCss, At as fontsToHead, Re as forcedFlagsFromCookies, K as formatDate, q as formatDateUTC, J as formatFromNow, Y as formatUTCToLocal, R as generateFacade, ve as getBindingsDetails, O as getConnectorTokens, le as getDisplayName, X as getDurationMs, sr as getInstance, ue as getKeyDecoded, de as getPathsFromObeject, ye as getSourceName, jt as googleCss2Url, Mt as googleTextSubsetUrl, Ke as hasConditions, Hn as hasServerElements, f as hasTemplateSyntax, p as hasValidToken, fe as hexToRGB, bn as inCascadeOrder, xt as inPluginLayer, ht as inheritableAttributesBase, g as inspectTemplate, ne as intervalOf, Pn as isAnchor, j as isConnectorManifestDraft, un as isContentValue, re as isDate, Ct as isDisplayMode, U as isElementTarget, Fe as isFlagName, pe as isInViewport, Oe as isInteractionFlow, xn as isKnownState, W as isNodeTarget, Sn as isParentAncestor, cr as isRTEvent, lr as isRTEventCloseCode, e as isRecord, Nt as isSafeFontUrl, Ie as isSchemaFlag, Wn as isSnippet, Cn as isStartingState, nn as isStyleCondition, dn as isStylePseudo, Tn as isStyleRules, ut as isStyleVariableCategory, mr as isTheme, ie as isUserEdit, Z as isValidFormat, tt as jsonCopy, Bt as layoutGridCss, Vt as layoutGridLook, I as liveSources, me as makeId, Ut as markStyleCache, Kt as mergeSnippetStyle, G as nodeOf, Un as notFoundProvider, n as onAuthFailure, je as pConsole, Br as paintedEntryFromCookies, Vr as paintedKeys, Hr as paintedStateCookieName, Ur as paintedStateFor, rn as parseContainerCondition, Q as parseDate, ze as parseFlagList, It as parseSpaceFont, qe as passesFlagGate, Wr as pickPainted, Pt as primaryFamily, l as processTwig, u as processTwigParam, d as processTwigValue, fn as pseudoHonours, pn as pseudoSuffix, Gr as readPaintedEntry, hr as readThemeCookie, jr as refreshRsc, Pr as releaseRscRequests, r as reportAuthFailure, Je as resolveFlags, Bn as resolveLayoutChain, xr as resolveScheme, h as resolveStepParam, Se as resolveVariables, Fr as rscDataPath, qr as runtimeStatePersist, i as sameRegistrableDomain, qt as sameSelector, nt as sameValue, Jn as schemaFromWire, Yn as schemaToWire, Jt as selectorsOf, Be as serializeFlagList, Sr as setAreaTheme, En as setAtKeys, ur as setInstance, Cr as setMachineScheme, wr as setThemeMode, Zn as spaceEventSchemas, Jr as stateOwner, wn as stateSuffix, Wt as styleCacheFromDocument, Gt as styleCacheTravelsInDocument, dt as styleConstants, Dn as styleTargetKeys, On as styleTargetProblem, kn as styleTargetRules, z as syntaxHighlight, _ as templatePaths, v as templateRootNames, Tr as themeFor, gr as themeFromCookies, vr as themeStore, $ as toUnixSeconds, Ye as undeclaredFlagOverrides, Fn as uniqueAnchor, Qe as uniqueLines, Ar as useActionsSync, rt as useFontHead, it as useNetwork, at as usePlitziServiceContext, be as useRegisterSource, Ce as useResolvedVariables, Ir as useRscRefresh, Lr as useRscSync, xe as useStableValue, Or as useTheme, Er as useThemeStore, ge as utility, _e as utilityOptions, M as validateConnectorManifest, Qn as validateSpaceEvent, An as valueAtKeys, s as visitorAccess, Ve as withForcedFlag, He as writeForcedFlags, Kr as writePaintedEntry, _r as writeThemeCookie };
+import { collectServerElements as Vn, hasServerElements as Hn, notFoundProvider as Un, pageNotFound as Wn, pageSeoText as Gn, pageServerContext as Kn } from "./schema/serverElements.mjs";
+import { isSnippet as qn } from "./schema/snippet.mjs";
+import Jn from "./network/NetworkContext.mjs";
+import Yn from "./network/NetworkInternalContext.mjs";
+import { elementFromWire as Xn, schemaFromWire as Zn, schemaToWire as Qn } from "./schema/wire.mjs";
+import { SpaceEvents as $n, spaceEventSchemas as er, validateSpaceEvent as tr } from "./network/spaceEvents.mjs";
+import nr from "./network/graphql/builder/Mutations/index.mjs";
+import rr from "./network/graphql/builder/Queries/index.mjs";
+import ir from "./network/graphql/builder/Subscriptions/index.mjs";
+import ar from "./network/graphql/sdk/Mutations/index.mjs";
+import or from "./network/graphql/sdk/Queries/index.mjs";
+import sr, { RTEvent as cr, RTEventCloseCode as lr, getInstance as ur, isRTEvent as dr, isRTEventCloseCode as fr, setInstance as pr } from "./websockets/RTCodec.mjs";
+import { THEME_CLASSES as mr, THEME_COOKIE_NAME as hr, applyThemeClass as gr, isTheme as _r, readThemeCookie as vr, themeFromCookies as yr, writeThemeCookie as br } from "./theme/themeCookie.mjs";
+import xr, { createThemeState as Sr, createThemeStore as Cr, resolveScheme as wr, setAreaTheme as Tr, setMachineScheme as Er, setThemeMode as Dr, startingThemeState as Or, themeFor as kr } from "./theme/themeStore.mjs";
+import { ThemeStartContext as Ar, useThemeState as jr, useThemeStore as Mr } from "./theme/ThemeScope.mjs";
+import Nr from "./theme/ThemeProvider.mjs";
+import Pr, { SPACE_THEME_AREA as Fr } from "./theme/useTheme.mjs";
+import Ir from "./server/actions/useActionsSync.mjs";
+import Lr, { cancelRsc as Rr, currentRscLocation as zr, releaseRscRequests as Br, rscDataPath as Vr } from "./server/rsc/refreshRsc.mjs";
+import Hr from "./server/rsc/useRscRefresh.mjs";
+import Ur from "./server/rsc/useRscSync.mjs";
+import { PAINTED_STATE_BUDGET as Wr, clearPaintedEntry as Gr, paintedEntryFromCookies as Kr, paintedKeys as qr, paintedStateCookieName as Jr, paintedStateFor as Yr, pickPainted as Xr, readPaintedEntry as Zr, writePaintedEntry as Qr } from "./state/paintedState.mjs";
+import { runtimeStatePersist as $r, stateOwner as ei } from "./state/runtimeStatePersist.mjs";
+export { Mn as ANCHOR_PATTERN, x as BODYLESS_METHODS, y as BuilderContext, nr as BuilderMutations, rr as BuilderQueries, In as COMPONENT_PROPS_SOURCE, N as COMPUTED_GLOBALS, S as CONNECTOR_HTTP_METHODS, an as CONTENT_PSEUDOS, mn as CURRENT_SELECTOR, Me as ComponentContext, C as DEFAULT_READ_ENDPOINT, Te as DEV_TOOLS_ATTRIBUTE, St as DISPLAY_MODES, gt as DISPLAY_MODE_MIN_WIDTH, we as DevToolsContext, w as EMPTY_RESPONSE_METHODS, Ln as EMPTY_SCHEMA, ft as EMPTY_STYLE_SCHEMA, hn as EXPANDED_SELECTOR, Ne as FLAG_GATE_PATTERN, Ue as FLAG_LAYERS, Pe as FLAG_NAME_PATTERN, Ft as FontValidationError, on as GENERATED_PSEUDOS, P as GLOBAL_SOURCES, gn as HIDDEN_CLASS, Ee as HIDE_DEV_TOOLS_CSS, ee as INTERVAL_TRIGGER, zt as LAYOUT_GRIDS, m as MAX_PARAM_PASSES, te as MIN_INTERVAL_MS, Yt as MOTION_CONDITIONS, Jn as NetworkContext, Yn as NetworkInternalContext, Wr as PAINTED_STATE_BUDGET, _n as PARENT_ANCESTOR, yt as PLUGIN_CSS_LAYER, sn as PSEUDO_PROPERTIES, oe as ParamsFromURL, ke as PlitziConsole, ot as PlitziServiceContext, st as PlitziServiceProvider, T as READ_ENDPOINT_NAMES, sr as RTCodec, cr as RTEvent, lr as RTEventCloseCode, bt as RUNTIME_CSS_LAYER, Ht as RUNTIME_STYLE_ID, Fr as SPACE_THEME_AREA, Xt as STYLE_CONDITION_LABELS, Zt as STYLE_MOTION_CONDITIONS, cn as STYLE_PSEUDOS, ln as STYLE_PSEUDO_LABELS, vn as STYLE_STATES, yn as STYLE_STATE_LABELS, Tt as SYSTEM_FONTS, jn as SchemaContext, ar as SdkMutations, or as SdkQueries, ir as SpaceEventSubscription, $n as SpaceEvents, pt as StyleBindingsAllowed, lt as StyleVariableCategory, mr as THEME_CLASSES, hr as THEME_COOKIE_NAME, Nr as ThemeProvider, Ar as ThemeStartContext, Rn as VARIABLE_REGEX, a as VISITOR_NAME, ct as WHILE_RUNNING_MODES, E as WRITE_ENDPOINT_NAMES, Nn as anchorOf, gr as applyThemeClass, t as authFailureFromResponse, Et as availableFonts, mt as baseDefaultValue, Rr as cancelRsc, Qt as canonicalCondition, o as checkVisitorRoles, Gr as clearPaintedEntry, Vn as collectServerElements, $t as conditionAtRule, en as conditionLabel, tn as conditionOfAtRule, k as connectorPresets, D as connectorTokens, b as contexts, B as cookieFromHeader, Ae as createStoreDevToolsLogger, Sr as createThemeState, Cr as createThemeStore, zr as currentRscLocation, De as debugCookieName, se as delay, Xe as describeChange, $e as diffSchema, et as diffStyle, he as disableReactDevTools, _t as displayModeAt, vt as displayModeWidthRem, V as documentCookies, Xn as elementFromWire, H as elementOf, A as emptyManifest, ce as emptyObject, F as evaluateComputed, ae as evaluateRuleGroup, Lt as fallbackForFamily, Dt as familiesInCss, L as fetchManifest, Ze as fieldChanges, c as filters, zn as findLayoutCycle, We as flagUserFromSSR, Ge as flagValues, Le as flagsCookieName, Ot as fontFamilyStack, wt as fontLinkAssets, kt as fontUrlResolver, Rt as fontsFromCss, At as fontsToHead, Re as forcedFlagsFromCookies, K as formatDate, q as formatDateUTC, J as formatFromNow, Y as formatUTCToLocal, R as generateFacade, ve as getBindingsDetails, O as getConnectorTokens, le as getDisplayName, X as getDurationMs, ur as getInstance, ue as getKeyDecoded, de as getPathsFromObeject, ye as getSourceName, jt as googleCss2Url, Mt as googleTextSubsetUrl, Ke as hasConditions, Hn as hasServerElements, f as hasTemplateSyntax, p as hasValidToken, fe as hexToRGB, bn as inCascadeOrder, xt as inPluginLayer, ht as inheritableAttributesBase, g as inspectTemplate, ne as intervalOf, Pn as isAnchor, j as isConnectorManifestDraft, un as isContentValue, re as isDate, Ct as isDisplayMode, U as isElementTarget, Fe as isFlagName, pe as isInViewport, Oe as isInteractionFlow, xn as isKnownState, W as isNodeTarget, Sn as isParentAncestor, dr as isRTEvent, fr as isRTEventCloseCode, e as isRecord, Nt as isSafeFontUrl, Ie as isSchemaFlag, qn as isSnippet, Cn as isStartingState, nn as isStyleCondition, dn as isStylePseudo, Tn as isStyleRules, ut as isStyleVariableCategory, _r as isTheme, ie as isUserEdit, Z as isValidFormat, tt as jsonCopy, Bt as layoutGridCss, Vt as layoutGridLook, I as liveSources, me as makeId, Ut as markStyleCache, Kt as mergeSnippetStyle, G as nodeOf, Un as notFoundProvider, n as onAuthFailure, je as pConsole, Wn as pageNotFound, Gn as pageSeoText, Kn as pageServerContext, Kr as paintedEntryFromCookies, qr as paintedKeys, Jr as paintedStateCookieName, Yr as paintedStateFor, rn as parseContainerCondition, Q as parseDate, ze as parseFlagList, It as parseSpaceFont, qe as passesFlagGate, Xr as pickPainted, Pt as primaryFamily, l as processTwig, u as processTwigParam, d as processTwigValue, fn as pseudoHonours, pn as pseudoSuffix, Zr as readPaintedEntry, vr as readThemeCookie, Lr as refreshRsc, Br as releaseRscRequests, r as reportAuthFailure, Je as resolveFlags, Bn as resolveLayoutChain, wr as resolveScheme, h as resolveStepParam, Se as resolveVariables, Vr as rscDataPath, $r as runtimeStatePersist, i as sameRegistrableDomain, qt as sameSelector, nt as sameValue, Zn as schemaFromWire, Qn as schemaToWire, Jt as selectorsOf, Be as serializeFlagList, Tr as setAreaTheme, En as setAtKeys, pr as setInstance, Er as setMachineScheme, Dr as setThemeMode, er as spaceEventSchemas, Or as startingThemeState, ei as stateOwner, wn as stateSuffix, Wt as styleCacheFromDocument, Gt as styleCacheTravelsInDocument, dt as styleConstants, Dn as styleTargetKeys, On as styleTargetProblem, kn as styleTargetRules, z as syntaxHighlight, _ as templatePaths, v as templateRootNames, kr as themeFor, yr as themeFromCookies, xr as themeStore, $ as toUnixSeconds, Ye as undeclaredFlagOverrides, Fn as uniqueAnchor, Qe as uniqueLines, Ir as useActionsSync, rt as useFontHead, it as useNetwork, at as usePlitziServiceContext, be as useRegisterSource, Ce as useResolvedVariables, Hr as useRscRefresh, Ur as useRscSync, xe as useStableValue, Pr as useTheme, jr as useThemeState, Mr as useThemeStore, ge as utility, _e as utilityOptions, M as validateConnectorManifest, tr as validateSpaceEvent, An as valueAtKeys, s as visitorAccess, Ve as withForcedFlag, He as writeForcedFlags, Qr as writePaintedEntry, br as writeThemeCookie };

package/dist/realtime/client.d.ts

@@ -1,4 +1,4 @@
-import { RealtimeMessage, RealtimeTransport } from '../types/RealtimeTypes';
+import { RealtimeMessage, RealtimePublishOptions, RealtimeTransport } from '../types/RealtimeTypes';
 export type RealtimeStatus = 'idle' | 'connecting' | 'open' | 'closed';
 type MessageListener = (message: RealtimeMessage) => void;
 type StatusListener = (status: RealtimeStatus) => void;
@@ -11,8 +11,11 @@ export type RealtimeClient = {
      * reopens nothing the server already let in. `undefined` forgets it.
      */
     grant: (topic: string, grant: string | undefined) => void;
-    /** Sends on a topic this page listens to. `false` when the server refused it or there is no connection. */
-    publish: (topic: string, type: string, data: unknown) => Promise<boolean>;
+    /**
+     * Sends on a topic this page listens to — heard by every other page on it, and by this one too with `echo`. `false`
+     * when the server refused it or there is no connection.
+     */
+    publish: (topic: string, type: string, data: unknown, options?: RealtimePublishOptions) => Promise<boolean>;
     onStatus: (listener: StatusListener) => () => void;
     readonly status: RealtimeStatus;
     /** This page's name on its channels — the `from` of what it sends — once connected. */

package/dist/realtime/client.mjs

@@ -67,9 +67,9 @@ var t = 30, n = [
 			topics: t,
 			transport: "sse",
 			close: () => r.abort(),
-			publish: async (t, n, r) => {
+			publish: async (t, n, r, { echo: i }) => {
 				if (!o) return !1;
-				let i = await f(e, {
+				let a = await f(e, {
 					method: "POST",
 					headers: { "content-type": "application/json" },
 					credentials: "same-origin",
@@ -77,10 +77,11 @@ var t = 30, n = [
 						token: o,
 						topic: t,
 						type: n,
-						data: r
+						data: r,
+						...i ? { echo: i } : {}
 					})
 				}).catch(() => void 0);
-				return i?.status === 401 && v === c && N(), i?.ok ?? !1;
+				return a?.status === 401 && v === c && N(), a?.ok ?? !1;
 			}
 		}, l = async (e) => {
 			let t = e.body?.getReader();
@@ -119,22 +120,23 @@ var t = 30, n = [
 			close: () => {
 				m = !0, h(), s.close();
 			},
-			publish: (e, t, n) => new Promise((i) => {
+			publish: (e, t, n, { echo: i }) => new Promise((a) => {
 				if (s.readyState !== s.OPEN) {
-					i(!1);
+					a(!1);
 					return;
 				}
 				d += 1;
-				let a = d, o = setTimeout(() => {
-					u.delete(a), i(!1);
+				let o = d, c = setTimeout(() => {
+					u.delete(o), a(!1);
 				}, r);
-				u.set(a, (e) => {
-					clearTimeout(o), i(e);
+				u.set(o, (e) => {
+					clearTimeout(c), a(e);
 				}), s.send(JSON.stringify({
-					id: a,
+					id: o,
 					topic: e,
 					type: t,
-					data: n
+					data: n,
+					...i ? { echo: i } : {}
 				}));
 			})
 		};
@@ -185,15 +187,15 @@ var t = 30, n = [
 			let n = F(e) && !y.has(e);
 			t && m.has(e) && !n && P(!0);
 		},
-		publish: async (e, t, n) => {
-			let r = await I(e) && v ? await v.publish(e, t, n) : !1;
-			return d(r ? "info" : "danger", `${e} → ${t}${r ? "" : " (not delivered)"}`, {
+		publish: async (e, t, n, r = {}) => {
+			let i = await I(e) && v ? await v.publish(e, t, n, r) : !1;
+			return d(i ? "info" : "danger", `${e} → ${t}${i ? "" : " (not delivered)"}`, {
 				event: "published",
 				topic: e,
 				type: t,
 				data: n,
-				delivered: r
-			}), r;
+				delivered: i
+			}), i;
 		},
 		onStatus: (e) => (g.add(e), () => g.delete(e)),
 		get status() {

package/dist/realtime/index.d.ts

@@ -1,6 +1,6 @@
 export { createRealtimeClient, realtimeClientFor } from './client';
 export { trackPresence } from './presence';
-export { JOIN_TYPE, LEAVE_TYPE, PRESENCE_TYPE, REVOKED_TYPE, channelLimits, channelProblems, isValidTopic, matchChannel } from './topics';
+export { JOIN_TYPE, LEAVE_TYPE, OBSERVER_COOKIE_NAME, PRESENCE_TYPE, REVOKED_TYPE, channelLimits, channelProblems, isValidTopic, matchChannel } from './topics';
 export type { RealtimeClient, RealtimeClientOptions, RealtimeStatus } from './client';
 export type { PresenceListeners, PresenceTracker, RealtimeMember } from './presence';
 export type { ChannelMatch } from './topics';

package/dist/realtime/index.mjs

@@ -1,4 +1,4 @@
-import { JOIN_TYPE as e, LEAVE_TYPE as t, PRESENCE_TYPE as n, REVOKED_TYPE as r, channelLimits as i, channelProblems as a, isValidTopic as o, matchChannel as s } from "./topics.mjs";
-import { createRealtimeClient as c, realtimeClientFor as l } from "./client.mjs";
-import { trackPresence as u } from "./presence.mjs";
-export { e as JOIN_TYPE, t as LEAVE_TYPE, n as PRESENCE_TYPE, r as REVOKED_TYPE, i as channelLimits, a as channelProblems, c as createRealtimeClient, o as isValidTopic, s as matchChannel, l as realtimeClientFor, u as trackPresence };
+import { JOIN_TYPE as e, LEAVE_TYPE as t, OBSERVER_COOKIE_NAME as n, PRESENCE_TYPE as r, REVOKED_TYPE as i, channelLimits as a, channelProblems as o, isValidTopic as s, matchChannel as c } from "./topics.mjs";
+import { createRealtimeClient as l, realtimeClientFor as u } from "./client.mjs";
+import { trackPresence as d } from "./presence.mjs";
+export { e as JOIN_TYPE, t as LEAVE_TYPE, n as OBSERVER_COOKIE_NAME, r as PRESENCE_TYPE, i as REVOKED_TYPE, a as channelLimits, o as channelProblems, l as createRealtimeClient, s as isValidTopic, c as matchChannel, u as realtimeClientFor, d as trackPresence };

package/dist/realtime/presence.mjs

@@ -20,7 +20,7 @@ var t = 2e4, n = 65e3, r = /* @__PURE__ */ new WeakMap(), i = (r, i, a) => {
 	}, m = () => {
 		u && r.publish(i, e, l);
 	}, h = r.subscribe(i, (e) => {
-		if (e.from !== r.me) {
+		if (e.from !== r.me || e.echo === !0) {
 			if (e.type === "$presence") {
 				let t = {
 					from: e.from,

package/dist/realtime/topics.d.ts

@@ -34,3 +34,9 @@ export declare const JOIN_TYPE = "$join";
  * topic, and hears nothing more on it until a new grant opens it again.
  */
 export declare const REVOKED_TYPE = "$revoked";
+/**
+ * A page that watches its channels without taking part: what `plitzi page check` and `page shot` load pages with. It
+ * hears every topic it may open, and says nothing on any — no arrival, no presence, nothing it publishes — so a check
+ * of a live site is never a visitor walking into somebody's room. Anyone may set it; it silences only that page.
+ */
+export declare const OBSERVER_COOKIE_NAME = "plitzi-observer";

package/dist/realtime/topics.mjs

@@ -21,6 +21,6 @@ var t = /^[A-Za-z0-9:_.-]{1,128}$/, n = "[A-Za-z0-9_.-]{1,64}", r = (e) => t.tes
 }, l = (e) => ({
 	maxMessageBytes: e.maxMessageBytes ?? 4096,
 	messagesPerSecond: e.messagesPerSecond ?? 30
-}), u = "$presence", d = "$leave", f = "$join", p = "$revoked";
+}), u = "$presence", d = "$leave", f = "$join", p = "$revoked", m = "plitzi-observer";
 //#endregion
-export { f as JOIN_TYPE, d as LEAVE_TYPE, u as PRESENCE_TYPE, p as REVOKED_TYPE, l as channelLimits, c as channelProblems, r as isValidTopic, a as matchChannel };
+export { f as JOIN_TYPE, d as LEAVE_TYPE, m as OBSERVER_COOKIE_NAME, u as PRESENCE_TYPE, p as REVOKED_TYPE, l as channelLimits, c as channelProblems, r as isValidTopic, a as matchChannel };

package/dist/schema/index.mjs

@@ -2,6 +2,6 @@ import e from "./SchemaContext.mjs";
 import { ANCHOR_PATTERN as t, anchorOf as n, isAnchor as r, uniqueAnchor as i } from "./anchor.mjs";
 import { COMPONENT_PROPS_SOURCE as a, EMPTY_SCHEMA as o, VARIABLE_REGEX as s } from "./schemaConstants.mjs";
 import { findLayoutCycle as c, resolveLayoutChain as l } from "./layoutChain.mjs";
-import { collectServerElements as u, hasServerElements as d, notFoundProvider as f } from "./serverElements.mjs";
-import { isSnippet as p } from "./snippet.mjs";
-export { t as ANCHOR_PATTERN, a as COMPONENT_PROPS_SOURCE, o as EMPTY_SCHEMA, e as SchemaContext, s as VARIABLE_REGEX, n as anchorOf, u as collectServerElements, c as findLayoutCycle, d as hasServerElements, r as isAnchor, p as isSnippet, f as notFoundProvider, l as resolveLayoutChain, i as uniqueAnchor };
+import { collectServerElements as u, hasServerElements as d, notFoundProvider as f, pageNotFound as p, pageSeoText as m, pageServerContext as h } from "./serverElements.mjs";
+import { isSnippet as g } from "./snippet.mjs";
+export { t as ANCHOR_PATTERN, a as COMPONENT_PROPS_SOURCE, o as EMPTY_SCHEMA, e as SchemaContext, s as VARIABLE_REGEX, n as anchorOf, u as collectServerElements, c as findLayoutCycle, d as hasServerElements, r as isAnchor, g as isSnippet, f as notFoundProvider, p as pageNotFound, m as pageSeoText, h as pageServerContext, l as resolveLayoutChain, i as uniqueAnchor };

package/dist/schema/serverElements.d.ts

@@ -20,9 +20,14 @@ import { Element, Schema } from '../types';
  * Given the flags as they resolved, an element gated off by one is skipped with its whole subtree — it will not be
  * rendered, so nothing in it wants data, and resolving it would put a feature that is off into the payload anyway.
  */
-export declare const collectServerElements: (schema: Schema, pageId: string | undefined, ids?: string[], flags?: Record<string, boolean>) => Element[];
+export declare const collectServerElements: (schema: Pick<Schema, "flat">, pageId: string | undefined, ids?: string[], flags?: Record<string, boolean>) => Element[];
 /** Whether anything on this page consumes server data at all — the question both RSC gates actually ask. */
 export declare const hasServerElements: (schema: Schema, pageId: string | undefined, flags?: Record<string, boolean>) => boolean;
+/** Where the visitor is: what a template on the server reads beside the page's data, as `navigation`. */
+export type ServerNavigation = {
+    routeParams: Record<string, unknown>;
+    queryParams: Record<string, unknown>;
+};
 /**
  * The server provider of a page whose answer says the address shows nothing — its `notFound`, a template against
  * that answer (`{{ source.found == false }}`) — by id; the page is then sent with status 404, rendered as written.
@@ -30,7 +35,23 @@ export declare const hasServerElements: (schema: Schema, pageId: string | undefi
  * Only `true` counts: a template that does not evaluate comes back as its own text, and a typo must leave the page
  * found rather than turn every visit into a 404.
  */
-export declare const notFoundProvider: (elements: Element[], serverData: Record<string, unknown>, navigation: {
-    routeParams: Record<string, unknown>;
-    queryParams: Record<string, unknown>;
-}) => string | undefined;
+export declare const notFoundProvider: (elements: Element[], serverData: Record<string, unknown>, navigation: ServerNavigation) => string | undefined;
+/**
+ * What a page's own templates read — its title, its description, its `notFound`: every server provider of the page and
+ * of the shells around it, by the name its descendants read it by (`apiContainer_capsule`), with its answer — and
+ * `navigation`. The server has both before it writes the head, and the browser has the same answer in `rsc.data`, so
+ * the two write one title.
+ */
+export declare const pageServerContext: (elements: Element[], serverData: Record<string, unknown>, navigation: ServerNavigation) => Record<string, unknown>;
+/**
+ * A page's title or description as the head carries it: its words, or its template evaluated against
+ * `pageServerContext`. Blank, or a template that did not evaluate — it comes back as its own text — is nothing, and the
+ * deployment's own title stays: braces never reach a tab or a link preview.
+ */
+export declare const pageSeoText: (value: unknown, context: Record<string, unknown>) => string | undefined;
+/**
+ * Whether a page's own `notFound` — a template over `pageServerContext` — says the address shows nothing: a record
+ * read by a provider the page shares with others, in its layout, which cannot say it for any one page itself. Only
+ * `true` counts, as for a provider's.
+ */
+export declare const pageNotFound: (template: unknown, context: Record<string, unknown>) => boolean;

package/dist/schema/serverElements.mjs

@@ -1,27 +1,35 @@
 import { processTwigValue as e } from "../helpers/twigWrapper/processTwig/processTwig.mjs";
-import { passesFlagGate as t } from "../flags/resolveFlags.mjs";
-import { resolveLayoutChain as n } from "./layoutChain.mjs";
+import t from "../dataSource/helpers/getSourceName.mjs";
+import { passesFlagGate as n } from "../flags/resolveFlags.mjs";
+import { resolveLayoutChain as r } from "./layoutChain.mjs";
 //#region src/schema/serverElements.ts
-var r = (e, r, i, a) => {
-	if (r === void 0) return [];
-	let o = i ? new Set(i) : void 0, s = [], c = /* @__PURE__ */ new Set(), l = e.flat[r], u = (e) => typeof e == "string" ? e : "", d = [r, ...l ? n((t) => e.flat[t], u(l.attributes.layout), u(l.attributes.layoutContainer)).map((e) => e.layout) : []];
+var i = (e, t, i, a) => {
+	if (t === void 0) return [];
+	let o = i ? new Set(i) : void 0, s = [], c = /* @__PURE__ */ new Set(), l = e.flat[t], u = (e) => typeof e == "string" ? e : "", d = [t, ...l ? r((t) => e.flat[t], u(l.attributes.layout), u(l.attributes.layoutContainer)).map((e) => e.layout) : []];
 	for (; d.length > 0;) {
-		let n = d.pop();
-		if (n === void 0 || c.has(n)) continue;
-		c.add(n);
-		let r = e.flat[n];
-		if (!r || a && !t(r.definition.flag, a)) continue;
+		let t = d.pop();
+		if (t === void 0 || c.has(t)) continue;
+		c.add(t);
+		let r = e.flat[t];
+		if (!r || a && !n(r.definition.flag, a)) continue;
 		r.definition.runtime === "server" && (!o || o.has(r.id)) && s.push(r);
 		let { items: i } = r.definition;
 		i && d.push(...i);
 	}
 	return s;
-}, i = (e, t, n) => r(e, t, void 0, n).length > 0, a = (t, n, r) => t.find((t) => {
+}, a = (e, t, n) => i(e, t, void 0, n).length > 0, o = (t, n, r) => t.find((t) => {
 	let i = t.attributes.notFound;
 	return typeof i == "string" && i !== "" && Object.hasOwn(n, t.id) && e(i, {
 		source: n[t.id],
 		navigation: r
 	}) === !0;
-})?.id;
+})?.id, s = (e, n, r) => ({
+	...Object.fromEntries(e.filter((e) => Object.hasOwn(n, e.id)).map((e) => [t(e.definition.type, e.id), n[e.id]])),
+	navigation: r
+}), c = /\{[{%]/, l = (t, n) => {
+	if (typeof t != "string") return;
+	let r = c.test(t) ? e(t, n) : t, i = typeof r == "string" || typeof r == "number" ? String(r).trim() : "";
+	return i === "" || c.test(i) ? void 0 : i;
+}, u = (t, n) => typeof t == "string" && t !== "" && e(t, n) === !0;
 //#endregion
-export { r as collectServerElements, i as hasServerElements, a as notFoundProvider };
+export { i as collectServerElements, a as hasServerElements, o as notFoundProvider, u as pageNotFound, l as pageSeoText, s as pageServerContext };

package/dist/style/useElementSize.d.ts

@@ -0,0 +1,16 @@
+import { RefObject } from 'react';
+export type ElementSize = {
+    width: number;
+    height: number;
+};
+/**
+ * The size an element is drawn at — a plugin's own box, which a sidebar, a panel or a split screen makes narrower than
+ * the window — kept up to date as it changes. What `useDisplayMode` cannot say: a tablet held upright is `mobile` by
+ * the window's breakpoints, and a week of seven columns still fits the 744 px the plugin has.
+ *
+ * `undefined` until it is measured: on the server, and in the browser's first render, so the page the server sent and
+ * the one that hydrates it are the same. Decide from a fallback until then — the breakpoint's guess:
+ * `const days = (size?.width ?? (useDisplayMode() === 'mobile' ? 390 : 1024)) >= 640 ? 7 : 3`.
+ */
+declare const useElementSize: (ref: RefObject<HTMLElement | null>) => ElementSize | undefined;
+export default useElementSize;

package/dist/style/useElementSize.mjs

@@ -0,0 +1,20 @@
+import { useEffect as e, useState as t } from "react";
+//#region src/style/useElementSize.ts
+var n = (n) => {
+	let [r, i] = t(void 0);
+	return e(() => {
+		let e = n.current;
+		if (!e || typeof ResizeObserver > "u") return;
+		let t = (e, t) => i((n) => n?.width === e && n.height === t ? n : {
+			width: e,
+			height: t
+		}), r = e.getBoundingClientRect();
+		t(r.width, r.height);
+		let a = new ResizeObserver((e) => {
+			e.slice(-1).forEach((e) => t(e.contentRect.width, e.contentRect.height));
+		});
+		return a.observe(e), () => a.disconnect();
+	}, [n]), r;
+};
+//#endregion
+export { n as default };

package/dist/theme/ThemeProvider.mjs

@@ -1,60 +1,69 @@
 import { useCommonStoreSync as e } from "../store/index.mjs";
 import { THEME_COOKIE_NAME as t, applyThemeClass as n, readThemeCookie as r, writeThemeCookie as i } from "./themeCookie.mjs";
 import a, { createThemeStore as o, resolveScheme as s, setMachineScheme as c, setThemeMode as l } from "./themeStore.mjs";
-import u from "./ThemeScope.mjs";
-import { use as d, useEffect as f, useId as p, useRef as m, useState as h, useSyncExternalStore as g } from "react";
-import { StoreContext as _, useIsomorphicLayoutEffect as v } from "@plitzi/nexus/react";
-import { Fragment as y, jsx as b, jsxs as x } from "react/jsx-runtime";
+import u, { ThemeStartContext as d, useThemeState as f } from "./ThemeScope.mjs";
+import { use as p, useEffect as m, useId as h, useRef as g, useState as _ } from "react";
+import { StoreContext as v, useIsomorphicLayoutEffect as y } from "@plitzi/nexus/react";
+import { jsx as b, jsxs as x } from "react/jsx-runtime";
 //#region src/theme/ThemeProvider.tsx
-var S = "(prefers-color-scheme: dark)", C = () => window.matchMedia(S).matches ? "dark" : "light", w = ({ state: t }) => (e([
-	"theme.mode",
-	"theme.resolved",
-	"theme.areas"
-], [
-	t.mode,
-	s(t.mode, t.scheme),
-	t.areas
-]), null), T = ({ defaultTheme: e = "system", theme: s, scope: T = "document", cookieName: E = t, children: D }) => {
-	let O = T === "container", k = p(), [A] = h(() => O ? o(`theme${k}`) : void 0), j = A ?? a, M = m({
+var S = "(prefers-color-scheme: dark)", C = () => window.matchMedia(S).matches ? "dark" : "light", w = ({ store: t }) => {
+	let n = f(t);
+	return e([
+		"theme.mode",
+		"theme.resolved",
+		"theme.areas"
+	], [
+		n.mode,
+		s(n.mode, n.scheme),
+		n.areas
+	]), null;
+}, T = ({ defaultTheme: e = "system", theme: s, scope: f = "document", cookieName: T = t, children: E }) => {
+	let D = f === "container", O = h(), [k] = _(() => D ? o(`theme${O}`) : void 0), A = k ?? a, j = g({
 		mode: e,
 		remembered: !1
 	});
-	v(() => {
-		let t = O ? void 0 : r(E), n = s ?? t ?? e;
-		M.current = {
+	y(() => {
+		let t = D ? void 0 : r(T), n = s ?? t ?? e;
+		j.current = {
 			mode: n,
 			remembered: t !== void 0
-		}, j.batch(() => {
-			c(C(), j), l(n, j);
+		}, A.batch(() => {
+			c(C(), A), l(n, A);
 		});
 	}, [
 		e,
 		s,
-		E,
-		O,
-		j
+		T,
+		D,
+		A
 	]);
-	let N = g(j.subscribe, j.getState, j.getState), P = d(_) !== void 0;
-	f(() => {
-		let e = window.matchMedia(S), t = () => c(e.matches ? "dark" : "light", j);
+	let M = s ?? e, N = p(v) !== void 0;
+	m(() => {
+		let e = window.matchMedia(S), t = () => c(e.matches ? "dark" : "light", A);
 		return e.addEventListener("change", t), t(), () => e.removeEventListener("change", t);
-	}, [j]), f(() => {
-		if (O) return;
+	}, [A]), m(() => {
+		if (D) return;
 		let e = () => {
-			let { mode: e } = j.getState();
-			(M.current.remembered || e !== M.current.mode) && (i(e, E), M.current.remembered = !0), n(e, document.documentElement);
+			let { mode: e } = A.getState();
+			(j.current.remembered || e !== j.current.mode) && (i(e, T), j.current.remembered = !0), n(e, document.documentElement);
 		};
-		return e(), j.subscribe(e);
+		return e(), A.subscribe(e);
 	}, [
-		E,
-		O,
-		j
+		T,
+		D,
+		A
 	]);
-	let F = P ? /* @__PURE__ */ b(w, { state: N }) : null;
-	return O ? /* @__PURE__ */ x(u, {
-		value: A,
-		children: [F, D]
-	}) : /* @__PURE__ */ x(y, { children: [F, D] });
+	let P = N ? /* @__PURE__ */ b(w, { store: A }) : null;
+	return D ? /* @__PURE__ */ b(u, {
+		value: k,
+		children: /* @__PURE__ */ x(d, {
+			value: M,
+			children: [P, E]
+		})
+	}) : /* @__PURE__ */ x(d, {
+		value: M,
+		children: [P, E]
+	});
 };
 //#endregion
 export { T as default };

package/dist/theme/ThemeScope.d.ts

@@ -1,4 +1,5 @@
 import { ThemeStoreInstance } from './themeStore';
+import { Theme, ThemeState } from '../types';
 /**
  * Which theme store the tree under here reads.
  *
@@ -11,6 +12,25 @@ import { ThemeStoreInstance } from './themeStore';
  * Deliberately NOT the way ordinary consumers reach the theme: a panel in a shadow root and an editor in a portal
  * are under no provider at all, and they still have to get an answer. That is what the fall-through is for.
  */
-declare const ThemeScopeContext: import('react').Context<import('@plitzi/nexus').StoreApi<import('..').ThemeState> | undefined>;
+declare const ThemeScopeContext: import('react').Context<import('@plitzi/nexus').StoreApi<ThemeState> | undefined>;
 export declare const useThemeStore: () => ThemeStoreInstance;
 export default ThemeScopeContext;
+/**
+ * The mode the surface under a `ThemeProvider` starts in: the theme its host supplied — the cookie a server read — or
+ * else its default.
+ *
+ * For the render that runs before any effect can: the server's, and the hydration that has to agree with it. The
+ * provider sets the store from a layout effect, which never runs on a server — so the page was rendered from the
+ * store's own starting state, `system` resolving to `light`, whatever the cookie said. The class on `<html>` was right
+ * and `{{ theme.resolved }}` was not: a picture whose address names the scheme was the light one, swapped for the dark
+ * one as the page hydrated.
+ */
+export declare const ThemeStartContext: import('react').Context<Theme | undefined>;
+/**
+ * The theme store's state, as the server rendered it until the surface is live.
+ *
+ * The starting state is the server snapshot, so the server renders with it and the hydration reads the same — it is
+ * never written into the store there, which on a server is one module-level singleton every request shares. Once
+ * hydrated, the store answers, which the provider has set by then.
+ */
+export declare const useThemeState: (store: ThemeStoreInstance) => ThemeState;

package/dist/theme/ThemeScope.mjs

@@ -1,7 +1,10 @@
 import { sharedContext as e } from "../helpers/sharedContext.mjs";
-import t from "./themeStore.mjs";
-import { use as n } from "react";
+import t, { startingThemeState as n } from "./themeStore.mjs";
+import { use as r, useMemo as i, useSyncExternalStore as a } from "react";
 //#region src/theme/ThemeScope.ts
-var r = e("ThemeScopeContext", void 0), i = () => n(r) ?? t;
+var o = e("ThemeScopeContext", void 0), s = () => r(o) ?? t, c = e("ThemeStartContext", void 0), l = (e) => {
+	let t = r(c), o = i(() => t === void 0 ? void 0 : n(t), [t]);
+	return a(e.subscribe, e.getState, () => o ?? e.getState());
+};
 //#endregion
-export { r as default, i as useThemeStore };
+export { c as ThemeStartContext, o as default, l as useThemeState, s as useThemeStore };

package/dist/theme/index.mjs

@@ -1,6 +1,6 @@
 import { THEME_CLASSES as e, THEME_COOKIE_NAME as t, applyThemeClass as n, isTheme as r, readThemeCookie as i, themeFromCookies as a, writeThemeCookie as o } from "./themeCookie.mjs";
-import s, { createThemeState as c, createThemeStore as l, resolveScheme as u, setAreaTheme as d, setMachineScheme as f, setThemeMode as p, themeFor as m } from "./themeStore.mjs";
-import { useThemeStore as h } from "./ThemeScope.mjs";
-import g from "./ThemeProvider.mjs";
-import _, { SPACE_THEME_AREA as v } from "./useTheme.mjs";
-export { v as SPACE_THEME_AREA, e as THEME_CLASSES, t as THEME_COOKIE_NAME, g as ThemeProvider, n as applyThemeClass, c as createThemeState, l as createThemeStore, r as isTheme, i as readThemeCookie, u as resolveScheme, d as setAreaTheme, f as setMachineScheme, p as setThemeMode, m as themeFor, a as themeFromCookies, s as themeStore, _ as useTheme, h as useThemeStore, o as writeThemeCookie };
+import s, { createThemeState as c, createThemeStore as l, resolveScheme as u, setAreaTheme as d, setMachineScheme as f, setThemeMode as p, startingThemeState as m, themeFor as h } from "./themeStore.mjs";
+import { ThemeStartContext as g, useThemeState as _, useThemeStore as v } from "./ThemeScope.mjs";
+import y from "./ThemeProvider.mjs";
+import b, { SPACE_THEME_AREA as x } from "./useTheme.mjs";
+export { x as SPACE_THEME_AREA, e as THEME_CLASSES, t as THEME_COOKIE_NAME, y as ThemeProvider, g as ThemeStartContext, n as applyThemeClass, c as createThemeState, l as createThemeStore, r as isTheme, i as readThemeCookie, u as resolveScheme, d as setAreaTheme, f as setMachineScheme, p as setThemeMode, m as startingThemeState, h as themeFor, a as themeFromCookies, s as themeStore, b as useTheme, _ as useThemeState, v as useThemeStore, o as writeThemeCookie };

package/dist/theme/themeStore.d.ts

@@ -1,5 +1,11 @@
 import { ColorScheme, Theme, ThemeState } from '../types';
 export declare const createThemeState: () => ThemeState;
+/**
+ * The state a surface starts in, before anything could ask the machine: the mode it opens with, and `light` for what a
+ * `system` mode resolves to until the browser answers — the one guess a server has to make, and the one the
+ * stylesheet's media queries correct without a class.
+ */
+export declare const startingThemeState: (mode: Theme) => ThemeState;
 /**
  * The theme, as a store rather than a context.
  *

package/dist/theme/themeStore.mjs

@@ -4,14 +4,17 @@ var t = () => ({
 	mode: "system",
 	scheme: "light",
 	areas: {}
-}), n = (n = "theme") => e(t(), { id: n }), r = n(), i = (e, t) => e === "system" ? t : e, a = (e, t) => (t ? e.areas[t] : void 0) ?? e.mode, o = (e, t = r) => {
+}), n = (e) => ({
+	...t(),
+	mode: e
+}), r = (n = "theme") => e(t(), { id: n }), i = r(), a = (e, t) => e === "system" ? t : e, o = (e, t) => (t ? e.areas[t] : void 0) ?? e.mode, s = (e, t = i) => {
 	t.batch(() => {
 		t.setState("mode", e), t.setState("areas", {});
 	});
-}, s = (e, t, n = r) => {
+}, c = (e, t, n = i) => {
 	n.setState(`areas.${e}`, t);
-}, c = (e, t = r) => {
+}, l = (e, t = i) => {
 	t.setState("scheme", e);
 };
 //#endregion
-export { t as createThemeState, n as createThemeStore, r as default, i as resolveScheme, s as setAreaTheme, c as setMachineScheme, o as setThemeMode, a as themeFor };
+export { t as createThemeState, r as createThemeStore, i as default, a as resolveScheme, c as setAreaTheme, l as setMachineScheme, s as setThemeMode, n as startingThemeState, o as themeFor };

package/dist/theme/useTheme.mjs

@@ -1,10 +1,10 @@
 import { resolveScheme as e, setAreaTheme as t, setThemeMode as n, themeFor as r } from "./themeStore.mjs";
-import { useThemeStore as i } from "./ThemeScope.mjs";
-import { useCallback as a, useMemo as o, useSyncExternalStore as s } from "react";
+import { useThemeState as i, useThemeStore as a } from "./ThemeScope.mjs";
+import { useCallback as o, useMemo as s } from "react";
 //#region src/theme/useTheme.ts
 var c = "canvas", l = (c) => {
-	let l = i(), u = s(l.subscribe, l.getState, l.getState), d = r(u, c), f = e(d, u.scheme), p = a((e) => c ? t(c, e, l) : n(e, l), [c, l]), m = a(() => p(f === "dark" ? "light" : "dark"), [f, p]);
-	return o(() => ({
+	let l = a(), u = i(l), d = r(u, c), f = e(d, u.scheme), p = o((e) => c ? t(c, e, l) : n(e, l), [c, l]), m = o(() => p(f === "dark" ? "light" : "dark"), [f, p]);
+	return s(() => ({
 		theme: d,
 		resolvedTheme: f,
 		setTheme: p,

package/dist/types/ActionTypes.d.ts

@@ -70,10 +70,11 @@ export type ActionWebhookVerification = {
  * The ways into an action, as the `action` of a trigger STEP rather than a list beside the flow.
  *
  * `call` — a client flow through the action endpoint. `webhook` — an inbound request, public by construction.
- * `schedule` — a cron tick. `render` — a `runtime: 'server'` element naming this action. `custom` — a trigger the
- * deployment mounted itself.
+ * `schedule` — a cron tick. `later` — a run another one set to start N seconds from then (`ctx.later`, `flow.later`):
+ * a turn that runs out, a bot's move, a hold that lapses. `render` — a `runtime: 'server'` element naming this action.
+ * `custom` — a trigger the deployment mounted itself.
  */
-export type ActionTriggerType = 'call' | 'webhook' | 'schedule' | 'render' | 'custom';
+export type ActionTriggerType = 'call' | 'webhook' | 'schedule' | 'later' | 'render' | 'custom';
 /**
  * What a trigger step carries, in its `params`.
  *
@@ -551,6 +552,11 @@ export type ActionJobInput = {
     maxAttempts: number;
     /** Fires that went by unclaimed before this one. Shown to an operator; never acted on. */
     missed?: number;
+    /**
+     * What a run set to run later (`trigger: 'later'`) was named by: setting it again under the same name replaces the
+     * one still waiting, and cancelling it by name drops it.
+     */
+    key?: string;
 };
 /** One unit of work the queue is holding, as an operator sees it. */
 export type ActionJob = ActionJobInput & {
@@ -692,4 +698,14 @@ export type ActionJobQueue = {
     requeue: (spaceIds: number[], jobId: string) => Promise<boolean>;
     /** An operator stopping a job: dropped if it is waiting, aborted at its next step if it is running. */
     cancel: (spaceIds: number[], jobId: string) => Promise<boolean>;
+    /**
+     * Drops the space's jobs waiting under `key` (`cancelled`), and answers how many. With `olderThan`, only the ones
+     * enqueued before that job — created earlier, or at the same instant with a smaller id — so of two set at once the
+     * newer is the one left, on every replica. A running one is left: it is usually the run that set the next.
+     */
+    cancelPending: (params: {
+        spaceId: number;
+        key: string;
+        olderThan?: string;
+    }) => Promise<number>;
 };

package/dist/types/RealtimeTypes.d.ts

@@ -50,9 +50,22 @@ export type RealtimeMessage = RealtimeSender & {
     data: unknown;
     /** Server time, in milliseconds. */
     at: number;
+    /**
+     * The sender asked to hear it too ({@link RealtimePublishOptions}): it reaches the page that sent it as well, which
+     * knows it for its own by `from` — its channel's `me`. Without it, a page never hears what it sent.
+     */
+    echo?: true;
+};
+/** What a page asks of a publish beyond the message itself. */
+export type RealtimePublishOptions = {
+    /**
+     * Hear it too, once the server took it — a reaction, a chat line: what the sender shows the moment it sends. Off by
+     * default, so what moves at the speed of a cursor is not drawn twice.
+     */
+    echo?: boolean;
 };
 /** What a page sends to publish: the secret its connection was given, and the message. */
-export type RealtimePublishRequest = {
+export type RealtimePublishRequest = RealtimePublishOptions & {
     token: string;
     topic: string;
     type: string;

package/dist/types/ServerTypes.d.ts

@@ -1185,7 +1185,12 @@ export type SSRContext = {
     rscParams?: Record<string, string>;
 };
 export type SSRServer = {
-    listen: (port: number, host?: string) => void;
+    /**
+     * Binds the port. Resolves once it takes connections — in a fleet, once the first worker does — so what says "ready"
+     * (a log line, a file a tool reads, a test's first request) says it after, never before. A port it could not take
+     * ends the process, or goes to `onListenError`: the promise is then never resolved.
+     */
+    listen: (port: number, host?: string) => Promise<void>;
     close: () => Promise<void>;
     readonly cache: CacheManager | null;
     readonly plugins: PluginRegistry;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plitzi/sdk-shared",
-  "version": "0.38.9",
+  "version": "0.38.11",
   "license": "AGPL-3.0",
   "files": [
     "dist",
@@ -1431,6 +1431,10 @@
       "types": "./dist/style/useDisplayMode.d.ts",
       "import": "./dist/style/useDisplayMode.mjs"
     },
+    "./style/useElementSize": {
+      "types": "./dist/style/useElementSize.d.ts",
+      "import": "./dist/style/useElementSize.mjs"
+    },
     "./theme": {
       "types": "./dist/theme/index.d.ts",
       "import": "./dist/theme/index.mjs"
@@ -1576,7 +1580,7 @@
   },
   "dependencies": {
     "@plitzi/nexus": "^1.4.0",
-    "@plitzi/plitzi-ui": "^1.6.32",
+    "@plitzi/plitzi-ui": "^1.6.33",
     "date-fns": "^4.4.0",
     "immer": "^11.1.21",
     "zod": "^4.6.5"