@plitzi/sdk-shared 0.38.8 → 0.38.10

package/CHANGELOG.md

@@ -1,5 +1,148 @@
 # @plitzi/sdk-shared
 
+## 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
+
+- 64f4cd6: - **`unusedPort()`** (`@plitzi/sdk-server`): a port the system has just handed out, for a test to listen on. The
+  package's own tests and `@plitzi/sdk-mcp`'s listened on fixed ports in the ephemeral range (393xx), which any
+  outgoing connection of a test running beside them could take: CI failed with `EADDRINUSE` on runs with nothing
+  wrong. Every one now listens on a port the system gives it.
+  - **Brotli at quality 5** (`@plitzi/sdk-server`): `compression.brotliQuality`, for a page rendered for one request, is
+    5 (was 2). At 2 a 220 KB page came out larger than gzip — 36 KB against 31 — and at 5 it is 29 KB, for the CPU gzip
+    spends; on half a core ~0.1 ms a page.
+  - **`verify` checks the pages for signed-in visitors** (`@plitzi/cli`): a page that sends the browser to sign in is
+    checked again signed in as the account `.env` names — `PLITZI_CHECK_USER`, `PLITZI_CHECK_PASSWORD` (the environment
+    wins over `.env`). With none named, `verify` says how. `page check --as` reads the password from `.env` too, and
+    `page check` takes several pages, in one browser.
+  - **An address that shows nothing answers 404** (`@plitzi/sdk-shared`, `@plitzi/plitzi-sdk`, `@plitzi/sdk-server`):
+    one no page answers was sent to the home page with a 302 — every typo read as the home page. A page whose slug is
+    `'*'` is now the space's page for it, sent with status 404 (a folder may have its own; the deepest wins), and a page
+    gated off by a flag shows it too. Never kept in the page cache: an address asked for at random filled it. Only a slug
+    that IS `'*'`: a page answering a subtree by its own (`spaces/:spaceId/update/*`) stays a page like any other.
+  - **`authorSpace` gives a space with no `'*'` page a plain one** (`@plitzi/sdk-authoring`), in the home page's layout,
+    and says so: suggestion `not-found-page`. The project templates carry their own.
+  - **`notFound` on a server provider** (`@plitzi/sdk-elements`, `@plitzi/sdk-server`): an expression against its answer
+    (`{{ source.found == false }}`); when it is true the page is sent with status 404, rendered as written. Refused on a
+    browser provider (`not-found-in-browser`) and when it is not one expression (`not-found-not-a-template`).
+  - **`page check` and `verify` know a page sent with 404** (`@plitzi/cli`): it is said, not failed; the space's `'*'`
+    page is checked at an address no page has, and fails if it is not sent with 404.
+  - **A form field draws no background of its own** (`@plitzi/sdk-elements`): the `<input>` inside a form control's box
+    (`field`) took `background-color: inherit`, and painted a translucent box colour a second time — a darker box inside
+    the padding (Tremor's search). It is `transparent`: the box shows through it.
+  - **`space lint` offers `quiet` only where there is an element to put it on** (`@plitzi/cli`): a suggestion about what
+    the space lacks — `not-found-page` — is answered by writing it.
+  - **`feedback --previous`** (`@plitzi/cli`): the brief says what to do when an earlier report's link no longer opens —
+    say so, and ask the person for the highest id it had.
+  - **`start:prod` runs in production by itself** (`@plitzi/cli`): `NODE_ENV=production node …`. Without the variable a
+    deployed project was a development server — dev tools on, and every public action answering its `steps` and `trace`
+    (each step's result, what the `output` was meant to leave out). `doctor` says a `start:prod` that does not
+    (`start-prod-not-production`); `plitzi upgrade --write` rewrites the script.
+  - **A project's `ActionRefusal` reaches the flow** (`@plitzi/sdk-server`): a functions bundle carries its own copy of the
+    class, so `instanceof` never knew it and the run lost its reason (`{{ x.error }}` empty). Told apart by name now.
+  - **Plugins are not remounted after hydration** (`@plitzi/sdk-elements`): the registry wrapped each plugin again when
+    the host handed it over again, a new component type every time — the server's HTML thrown away, entrances replayed,
+    effects run twice. Each plugin component is wrapped once.
+  - **`start:dev` survives a space that does not author** (`@plitzi/sdk-server`): a restart while the space had an error
+    died, and fixing the space woke nothing. It comes up answering every page with what is wrong (503), and loads the
+    space the first time a save authors.
+  - **`page check` sees what is cut off at the screen's edge** (`@plitzi/sdk-authoring`, `@plitzi/cli`): a link or words an
+    ancestor hides past the viewport, which no sideways scroll shows (`cut-off`).
+  - **`page shot --click <element...> --sheet`** (`@plitzi/cli`): elements clicked in order — a name or a CSS selector,
+    inside a plugin too — pictured after each (`--frames`/`--every`), with how much changed, and every picture on one
+    contact sheet. The dev tools' badge is no longer in a picture: its shadow root is marked (`@plitzi/sdk-dev-tools`).
+  - **`formControl` is optional unless it says `required: true`** (`@plitzi/sdk-elements`), as an HTML field is. A field
+    left without `required` in an older space was required, and is not now.
+  - **`text({ decorative })`, `list({ label })`** (`@plitzi/sdk-elements`); **`writing-mode`, `text-orientation`** in the
+    CSS vocabulary (`@plitzi/sdk-shared`).
+  - **`unused-token` reads the plugins' stylesheets** (`@plitzi/sdk-authoring`): `authorSpace`'s `stylesheets`, which
+    `projectAuthoring` fills with every `.css` under `src/plugins/` — a token only a plugin used was said to be unused.
+  - **`id-taken` on a provider placed on two pages points at the layout they share** (`@plitzi/sdk-authoring`), not at
+    `scope()`, which renamed its source and every template reading it.
+  - **The welcome template's tokens keep their names** (`@plitzi/sdk-authoring`): `satisfies`, not an annotation, so
+    `tokens(variables).card` typechecks as the cheatsheet teaches.
+
 ## 0.38.8
 
 ### Patch Changes

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/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 } from "./schema/serverElements.mjs";
-import { isSnippet as Un } from "./schema/snippet.mjs";
-import Wn from "./network/NetworkContext.mjs";
-import Gn from "./network/NetworkInternalContext.mjs";
-import { elementFromWire as Kn, schemaFromWire as qn, schemaToWire as Jn } from "./schema/wire.mjs";
-import { SpaceEvents as Yn, spaceEventSchemas as Xn, validateSpaceEvent as Zn } from "./network/spaceEvents.mjs";
-import Qn from "./network/graphql/builder/Mutations/index.mjs";
-import $n from "./network/graphql/builder/Queries/index.mjs";
-import er from "./network/graphql/builder/Subscriptions/index.mjs";
-import tr from "./network/graphql/sdk/Mutations/index.mjs";
-import nr from "./network/graphql/sdk/Queries/index.mjs";
-import rr, { RTEvent as ir, RTEventCloseCode as ar, getInstance as or, isRTEvent as sr, isRTEventCloseCode as cr, setInstance as lr } from "./websockets/RTCodec.mjs";
-import { THEME_CLASSES as ur, THEME_COOKIE_NAME as dr, applyThemeClass as fr, isTheme as pr, readThemeCookie as mr, themeFromCookies as hr, writeThemeCookie as gr } from "./theme/themeCookie.mjs";
-import _r, { createThemeState as vr, createThemeStore as yr, resolveScheme as br, setAreaTheme as xr, setMachineScheme as Sr, setThemeMode as Cr, themeFor as wr } from "./theme/themeStore.mjs";
-import { useThemeStore as Tr } from "./theme/ThemeScope.mjs";
-import Er from "./theme/ThemeProvider.mjs";
-import Dr, { SPACE_THEME_AREA as Or } from "./theme/useTheme.mjs";
-import kr from "./server/actions/useActionsSync.mjs";
-import Ar, { cancelRsc as jr, currentRscLocation as Mr, releaseRscRequests as Nr, rscDataPath as Pr } from "./server/rsc/refreshRsc.mjs";
-import Fr from "./server/rsc/useRscRefresh.mjs";
-import Ir from "./server/rsc/useRscSync.mjs";
-import { PAINTED_STATE_BUDGET as Lr, clearPaintedEntry as Rr, paintedEntryFromCookies as zr, paintedKeys as Br, paintedStateCookieName as Vr, paintedStateFor as Hr, pickPainted as Ur, readPaintedEntry as Wr, writePaintedEntry as Gr } from "./state/paintedState.mjs";
-import { runtimeStatePersist as Kr, stateOwner as qr } from "./state/runtimeStatePersist.mjs";
-export { Mn as ANCHOR_PATTERN, x as BODYLESS_METHODS, y as BuilderContext, Qn as BuilderMutations, $n 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, Wn as NetworkContext, Gn as NetworkInternalContext, Lr 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, rr as RTCodec, ir as RTEvent, ar as RTEventCloseCode, bt as RUNTIME_CSS_LAYER, Ht as RUNTIME_STYLE_ID, Or 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, tr as SdkMutations, nr as SdkQueries, er as SpaceEventSubscription, Yn as SpaceEvents, pt as StyleBindingsAllowed, lt as StyleVariableCategory, ur as THEME_CLASSES, dr as THEME_COOKIE_NAME, Er as ThemeProvider, Rn as VARIABLE_REGEX, a as VISITOR_NAME, ct as WHILE_RUNNING_MODES, E as WRITE_ENDPOINT_NAMES, Nn as anchorOf, fr as applyThemeClass, t as authFailureFromResponse, Et as availableFonts, mt as baseDefaultValue, jr as cancelRsc, Qt as canonicalCondition, o as checkVisitorRoles, Rr 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, vr as createThemeState, yr as createThemeStore, Mr 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, Kn 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, or 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, sr as isRTEvent, cr as isRTEventCloseCode, e as isRecord, Nt as isSafeFontUrl, Ie as isSchemaFlag, Un as isSnippet, Cn as isStartingState, nn as isStyleCondition, dn as isStylePseudo, Tn as isStyleRules, ut as isStyleVariableCategory, pr 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, n as onAuthFailure, je as pConsole, zr as paintedEntryFromCookies, Br as paintedKeys, Vr as paintedStateCookieName, Hr as paintedStateFor, rn as parseContainerCondition, Q as parseDate, ze as parseFlagList, It as parseSpaceFont, qe as passesFlagGate, Ur as pickPainted, Pt as primaryFamily, l as processTwig, u as processTwigParam, d as processTwigValue, fn as pseudoHonours, pn as pseudoSuffix, Wr as readPaintedEntry, mr as readThemeCookie, Ar as refreshRsc, Nr as releaseRscRequests, r as reportAuthFailure, Je as resolveFlags, Bn as resolveLayoutChain, br as resolveScheme, h as resolveStepParam, Se as resolveVariables, Pr as rscDataPath, Kr as runtimeStatePersist, i as sameRegistrableDomain, qt as sameSelector, nt as sameValue, qn as schemaFromWire, Jn as schemaToWire, Jt as selectorsOf, Be as serializeFlagList, xr as setAreaTheme, En as setAtKeys, lr as setInstance, Sr as setMachineScheme, Cr as setThemeMode, Xn as spaceEventSchemas, qr 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, wr as themeFor, hr as themeFromCookies, _r as themeStore, $ as toUnixSeconds, Ye as undeclaredFlagOverrides, Fn as uniqueAnchor, Qe as uniqueLines, kr as useActionsSync, rt as useFontHead, it as useNetwork, at as usePlitziServiceContext, be as useRegisterSource, Ce as useResolvedVariables, Fr as useRscRefresh, Ir as useRscSync, xe as useStableValue, Dr as useTheme, Tr as useThemeStore, ge as utility, _e as utilityOptions, M as validateConnectorManifest, Zn as validateSpaceEvent, An as valueAtKeys, s as visitorAccess, Ve as withForcedFlag, He as writeForcedFlags, Gr as writePaintedEntry, gr 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/navigation/index.d.ts

@@ -1,4 +1,4 @@
 export { matchPath } from './matchPath';
-export { getPageFullPath, getPaths, isAbsoluteUrl, isPageAuthored, matchRoutePath, getRouteParams, getSlugParams, navigationTarget } from './routes';
+export { getPageFullPath, getPaths, isAbsoluteUrl, isPageAuthored, matchRoutePath, notFoundPageFor, getRouteParams, getSlugParams, navigationTarget, NOT_FOUND_SLUG } from './routes';
 export type { PathMatch, PathPattern } from './matchPath';
 export type { NavigationAccessLevel, NavigationAction, Path } from './routes';

package/dist/navigation/index.mjs

@@ -1,3 +1,3 @@
 import { matchPath as e } from "./matchPath.mjs";
-import { getPageFullPath as t, getPaths as n, getRouteParams as r, getSlugParams as i, isAbsoluteUrl as a, isPageAuthored as o, matchRoutePath as s, navigationTarget as c } from "./routes.mjs";
-export { t as getPageFullPath, n as getPaths, r as getRouteParams, i as getSlugParams, a as isAbsoluteUrl, o as isPageAuthored, e as matchPath, s as matchRoutePath, c as navigationTarget };
+import { NOT_FOUND_SLUG as t, getPageFullPath as n, getPaths as r, getRouteParams as i, getSlugParams as a, isAbsoluteUrl as o, isPageAuthored as s, matchRoutePath as c, navigationTarget as l, notFoundPageFor as u } from "./routes.mjs";
+export { t as NOT_FOUND_SLUG, n as getPageFullPath, r as getPaths, i as getRouteParams, a as getSlugParams, o as isAbsoluteUrl, s as isPageAuthored, e as matchPath, c as matchRoutePath, l as navigationTarget, u as notFoundPageFor };

package/dist/navigation/routes.d.ts

@@ -11,6 +11,12 @@ export type Path = {
     path: string;
     unauthorizedBehaviour?: NavigationAction;
     unauthorizedPageRedirect?: string;
+    /**
+     * A path of the space's "not found" page — a page whose slug is `*`, the page of every address under its folder that
+     * no other page answers — sent with status 404. Not every path ending in `*`: `update/*` is a page of its own that
+     * answers a whole subtree.
+     */
+    notFound?: true;
 };
 /**
  * Does this name another origin, rather than somewhere in this space?
@@ -20,6 +26,8 @@ export type Path = {
  * external would turn a typo into an off-site redirect.
  */
 export declare const isAbsoluteUrl: (url: string) => boolean;
+/** The slug of the space's "not found" page: the page of every address under its folder that no other page answers. */
+export declare const NOT_FOUND_SLUG = "*";
 declare function getPageFullPath(pages: Record<string, Element>, pageFolders: PageFolder[], pageId: string, asString: true): string;
 declare function getPageFullPath(pages: Record<string, Element>, pageFolders: PageFolder[], pageId: string, asString?: false): Record<string, string>;
 /**
@@ -31,7 +39,7 @@ declare function getPageFullPath(pages: Record<string, Element>, pageFolders: Pa
  */
 declare const navigationTarget: (pages: Record<string, Element>, pageFolders: PageFolder[], target: string) => string;
 declare const isPageAuthored: (accessLevel?: NavigationAccessLevel, authenticated?: boolean, previewMode?: boolean) => boolean;
-declare const getPaths: (pages?: Record<string, Element>, pageFolders?: PageFolder[], authenticated?: boolean, basePath?: string, previewMode?: boolean, strictMode?: boolean) => Path[];
+declare const getPaths: (pages?: Record<string, Element>, pageFolders?: PageFolder[], authenticated?: boolean, basePath?: string, previewMode?: boolean) => Path[];
 declare const matchRoutePath: (paths: Path[], pathName: string, authenticated: boolean) => {
     action: {
         type: "authenticated" | "accessDenied" | "redirect" | "notFound" | "normal";
@@ -40,7 +48,9 @@ declare const matchRoutePath: (paths: Path[], pathName: string, authenticated: b
     pathMatch?: PathMatch;
     pageId?: string;
 };
+/** The space's "not found" page for an address — its deepest folder's, or the space's — when it declares one. */
+declare const notFoundPageFor: (paths: Path[], pathName: string) => string | undefined;
 declare const getRouteParams: (path: string) => string[];
 /** The params a page's slug declares, in either spelling a slug accepts: `post/{{slug}}` and `:spaceId/update`. */
 declare const getSlugParams: (slug: string) => string[];
-export { getPageFullPath, getPaths, matchRoutePath, isPageAuthored, getRouteParams, getSlugParams, navigationTarget };
+export { getPageFullPath, getPaths, matchRoutePath, notFoundPageFor, isPageAuthored, getRouteParams, getSlugParams, navigationTarget };

package/dist/navigation/routes.mjs

@@ -1,76 +1,63 @@
 import { matchPath as e } from "./matchPath.mjs";
 //#region src/navigation/routes.ts
-var t = (e) => /^https?:\/\//i.test(e), n = (e) => t(e) || e.includes("{{"), r = (e) => e.replaceAll(/\/+/g, "/"), i = (e) => r(e.replace(/{{([a-zA-Z0-9-_:*/]+)}}/gi, ":$1")), a = (e, t) => {
+var t = (e) => /^https?:\/\//i.test(e), n = "*", r = (e) => t(e) || e.includes("{{"), i = (e) => e.replaceAll(/\/+/g, "/"), a = (e) => i(e.replace(/{{([a-zA-Z0-9-_:*/]+)}}/gi, ":$1")), o = (e, t) => {
 	if (!t || !e[t]) return "";
 	let { slug: n, parentId: r } = e[t];
-	return r ? `${a(e, r)}/${n}` : n;
+	return r ? `${o(e, r)}/${n}` : n;
 };
-function o(e, t, n, o = !1) {
+function s(e, t, n, r = !1) {
 	let s = n.replace(/^\/+/, ""), { slug: c = "", folder: l, default: u } = e[s]?.attributes ?? {
 		slug: s,
 		folder: "",
 		default: !1
 	};
-	if (u && !o) return {
+	if (u && !r) return {
 		"/": n,
 		[`/${n}`]: n
 	};
-	if (u && o) return "/";
-	if (!l && !o) return {
-		[i(`/${c}`)]: n,
-		[i(`/${n}`)]: n
+	if (u && r) return "/";
+	if (!l && !r) return {
+		[a(`/${c}`)]: n,
+		[a(`/${n}`)]: n
 	};
-	if (!l && o) return r(`/${c}`);
-	if (!t.find((e) => e.id === l)) return o ? r(`/${c}`) : {
-		[i(`/${c}`)]: n,
-		[i(`/${n}`)]: n
+	if (!l && r) return i(`/${c}`);
+	if (!t.find((e) => e.id === l)) return r ? i(`/${c}`) : {
+		[a(`/${c}`)]: n,
+		[a(`/${n}`)]: n
 	};
-	let d = [a(t.reduce((e, t) => ({
+	let d = [o(t.reduce((e, t) => ({
 		...e,
 		[t.id]: t
 	}), {}), l), c].filter(Boolean).join("/");
-	return o ? r(`/${d}`) : {
-		[i(`/${d}`)]: n,
-		[i(`/${n}`)]: n
+	return r ? i(`/${d}`) : {
+		[a(`/${d}`)]: n,
+		[a(`/${n}`)]: n
 	};
 }
-var s = (e, t, n) => {
+var c = (e, t, n) => {
 	let r = n.indexOf("#");
-	if (r > 0) return `${s(e, t, n.slice(0, r))}${n.slice(r)}`;
+	if (r > 0) return `${c(e, t, n.slice(0, r))}${n.slice(r)}`;
 	let i = e[n];
 	if (!i) return n;
-	let { slug: a, default: c } = i.attributes;
-	return typeof a == "string" ? o(e, t, n, !0) : c ? "/" : `/${n}`;
-}, c = (e, t, n = !0) => !e || !n || t === void 0 || t && e === "authenticated" || !t && e === "public" ? !0 : t && e === "public" ? !1 : !e, l = (e = {}, t = [], r, i = "", a = !0, s = !0) => {
-	let l = Object.keys(e).reduce((s, l) => {
-		let { attributes: { accessLevel: u, enabled: d = !0, unauthorizedBehaviour: f } } = e[l], p = e[l].attributes.unauthorizedPageRedirect;
-		if (!d && a) return s;
-		p &&= n(p) ? p : o(e, t, p, !0);
-		let m = o(e, t, l), h = Object.keys(m).map((e) => ({
-			pageId: l,
-			path: `${i}${e}`.replaceAll("//", "/"),
-			accessLevel: u,
-			enabled: d,
-			isRaw: `/${l}` === e,
-			unauthorizedBehaviour: f,
-			unauthorizedPageRedirect: p,
-			hasAccess: c(u, r, a)
-		}));
-		return [...s, ...h];
-	}, []).filter((e) => e.path !== "*" || e.hasAccess).sort((e, t) => e.path === t.path ? e.accessLevel === "authenticated" ? -1 : 1 : e.path > t.path ? -1 : 1);
-	if (!l.find((e) => e.path === "*") && !s) {
-		let e = l.find((e) => e.path === "/" && e.hasAccess);
-		e && e.unauthorizedBehaviour === "redirect" && e.unauthorizedPageRedirect && l.push({
-			...e,
-			path: "*",
-			hasAccess: !1,
-			isRaw: !0,
-			unauthorizedBehaviour: "redirect",
-			unauthorizedPageRedirect: "/"
-		});
-	}
-	return l;
-}, u = (t, n, r) => {
+	let { slug: a, default: o } = i.attributes;
+	return typeof a == "string" ? s(e, t, n, !0) : o ? "/" : `/${n}`;
+}, l = (e, t, n = !0) => !e || !n || t === void 0 || t && e === "authenticated" || !t && e === "public" ? !0 : t && e === "public" ? !1 : !e, u = (e = {}, t = [], n, i = "", a = !0) => Object.keys(e).reduce((o, c) => {
+	let { attributes: { accessLevel: u, enabled: d = !0, unauthorizedBehaviour: f } } = e[c], p = e[c].attributes.unauthorizedPageRedirect;
+	if (!d && a) return o;
+	p &&= r(p) ? p : s(e, t, p, !0);
+	let m = s(e, t, c), h = e[c].attributes.slug === "*", g = Object.keys(m).map((e) => ({
+		pageId: c,
+		path: `${i}${e}`.replaceAll("//", "/"),
+		accessLevel: u,
+		enabled: d,
+		isRaw: `/${c}` === e,
+		unauthorizedBehaviour: f,
+		unauthorizedPageRedirect: p,
+		hasAccess: l(u, n, a),
+		...h ? { notFound: !0 } : {}
+	}));
+	return [...o, ...g];
+}, []).sort((e, t) => !!e.notFound == !!t.notFound ? e.path === t.path ? e.accessLevel === "authenticated" ? -1 : 1 : e.path > t.path ? -1 : 1 : e.notFound ? 1 : -1), d = (t, n, r) => {
 	if (!n) return {
 		action: {
 			type: "accessDenied",
@@ -90,35 +77,28 @@ var s = (e, t, n) => {
 			pageId: t.pageId
 		});
 	});
-	let a = i.find(({ path: { accessLevel: e } }) => e === "authenticated" && r || e === "public" && !r || !e);
-	if (a ||= i.find(({ path: { accessLevel: e } }) => e === "authenticated" && !r || e === "public" && r), !a && t.find((e) => e.path === "/" && e.hasAccess)) return {
-		action: {
-			type: "redirect",
-			path: "/"
-		},
-		pathMatch: void 0
-	};
-	if (!a) return {
+	let a = (e) => e.find(({ path: { accessLevel: e } }) => e === "authenticated" && r || e === "public" && !r || !e) ?? e.find(({ path: { accessLevel: e } }) => e === "authenticated" && !r || e === "public" && r), o = a(i.filter(({ path: e }) => !e.notFound)) ?? a(i.filter(({ path: e }) => e.notFound));
+	if (!o) return {
 		action: {
 			type: "notFound",
 			path: void 0
 		},
 		pathMatch: void 0
 	};
-	let { pageId: o, matchResult: s, path: { hasAccess: c, unauthorizedBehaviour: l, unauthorizedPageRedirect: u } } = a;
-	return !c && l === "redirect" && u ? {
+	let { pageId: s, matchResult: c, path: { hasAccess: l, unauthorizedBehaviour: u, unauthorizedPageRedirect: d, notFound: f } } = o;
+	return !l && u === "redirect" && d ? {
 		action: {
 			type: "redirect",
-			path: u
+			path: d
 		},
 		pathMatch: void 0
-	} : c ? {
+	} : l ? {
 		action: {
-			type: "normal",
+			type: f ? "notFound" : "normal",
 			path: void 0
 		},
-		pathMatch: s,
-		pageId: o
+		pathMatch: c,
+		pageId: s
 	} : {
 		action: {
 			type: "accessDenied",
@@ -126,6 +106,9 @@ var s = (e, t, n) => {
 		},
 		pathMatch: void 0
 	};
-}, d = (e) => !e || typeof e != "string" ? [] : (e.match(/:[a-zA-Z0-9-_:*]+/gim) || []).map((e) => e.replace(":", "")), f = (e) => d(i(e));
+}, f = (t, n) => t.find((t) => t.hasAccess && t.notFound && e({
+	path: t.path,
+	end: !0
+}, n))?.pageId, p = (e) => !e || typeof e != "string" ? [] : (e.match(/:[a-zA-Z0-9-_:*]+/gim) || []).map((e) => e.replace(":", "")), m = (e) => p(a(e));
 //#endregion
-export { o as getPageFullPath, l as getPaths, d as getRouteParams, f as getSlugParams, t as isAbsoluteUrl, c as isPageAuthored, u as matchRoutePath, s as navigationTarget };
+export { n as NOT_FOUND_SLUG, s as getPageFullPath, u as getPaths, p as getRouteParams, m as getSlugParams, t as isAbsoluteUrl, l as isPageAuthored, d as matchRoutePath, c as navigationTarget, f as notFoundPageFor };

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 } from "./serverElements.mjs";
-import { isSnippet as f } 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, f as isSnippet, 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,6 +20,38 @@ 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.
+ *
+ * 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: 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,20 +1,35 @@
-import { passesFlagGate as e } from "../flags/resolveFlags.mjs";
-import { resolveLayoutChain as t } from "./layoutChain.mjs";
+import { processTwigValue as e } from "../helpers/twigWrapper/processTwig/processTwig.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 n = (n, r, i, a) => {
-	if (r === void 0) return [];
-	let o = i ? new Set(i) : void 0, s = [], c = /* @__PURE__ */ new Set(), l = n.flat[r], u = (e) => typeof e == "string" ? e : "", d = [r, ...l ? t((e) => n.flat[e], 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 t = d.pop();
 		if (t === void 0 || c.has(t)) continue;
 		c.add(t);
-		let r = n.flat[t];
-		if (!r || a && !e(r.definition.flag, a)) continue;
+		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;
-}, r = (e, t, r) => n(e, t, void 0, r).length > 0;
+}, 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, 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 { n as collectServerElements, r as hasServerElements };
+export { i as collectServerElements, a as hasServerElements, o as notFoundProvider, u as pageNotFound, l as pageSeoText, s as pageServerContext };

package/dist/style/styleConstants.d.ts

@@ -178,6 +178,8 @@ declare const styleConstants: {
     readonly TEXT_INDENT: "text-indent";
     readonly TEXT_TRANSFORM: "text-transform";
     readonly DIRECTION: "direction";
+    readonly WRITING_MODE: "writing-mode";
+    readonly TEXT_ORIENTATION: "text-orientation";
     readonly WHITE_SPACE: "white-space";
     readonly TEXT_WRAP: "text-wrap";
     readonly WORD_BREAK: "word-break";
@@ -199,8 +201,8 @@ declare const styleConstants: {
 };
 export declare const inheritableAttributesBase: StyleCategory[];
 export declare const StyleBindingsAllowed: {
-    path: "color" | "cursor" | "filter" | "fill" | "display" | "flex-wrap" | "flex-direction" | "align-items" | "justify-items" | "justify-content" | "align-content" | "row-gap" | "column-gap" | "grid-row-gap" | "grid-column-gap" | "grid-template-areas" | "grid-template-columns" | "grid-template-rows" | "grid-auto-flow" | "grid-auto-rows" | "grid-auto-columns" | "grid-row-start" | "grid-column-start" | "grid-row-end" | "grid-column-end" | "align-self" | "justify-self" | "order" | "flex-grow" | "flex-shrink" | "flex-basis" | "list-style" | "list-style-type" | "list-style-position" | "list-style-image" | "background-color" | "background-image" | "background-position" | "background-size" | "background-repeat" | "background-origin" | "background-clip" | "background-attachment" | "background-blend-mode" | "mask-image" | "mask-size" | "mask-position" | "mask-repeat" | "mask-composite" | "-webkit-mask-image" | "border-top-style" | "border-top-width" | "border-top-color" | "border-bottom-style" | "border-bottom-width" | "border-bottom-color" | "border-left-style" | "border-left-width" | "border-left-color" | "border-right-style" | "border-right-width" | "border-right-color" | "border-top-left-radius" | "border-top-right-radius" | "border-bottom-left-radius" | "border-bottom-right-radius" | "border-collapse" | "border-spacing" | "table-layout" | "opacity" | "visibility" | "transition" | "transition-property" | "transition-duration" | "transition-timing-function" | "transition-delay" | "transition-behavior" | "animation" | "animation-name" | "animation-duration" | "animation-timing-function" | "animation-delay" | "animation-iteration-count" | "animation-direction" | "animation-fill-mode" | "animation-play-state" | "animation-timeline" | "animation-range" | "box-shadow" | "backdrop-filter" | "mix-blend-mode" | "isolation" | "clip-path" | "transform" | "transform-origin" | "translate" | "rotate" | "scale" | "transform-style" | "perspective" | "perspective-origin" | "backface-visibility" | "will-change" | "outline-width" | "outline-style" | "outline-color" | "outline-offset" | "pointer-events" | "user-select" | "touch-action" | "resize" | "appearance" | "scroll-behavior" | "overscroll-behavior" | "scroll-snap-type" | "scroll-snap-align" | "scroll-snap-stop" | "scroll-padding-top" | "scroll-margin-top" | "accent-color" | "caret-color" | "color-scheme" | "content" | "position" | "float" | "clear" | "z-index" | "top" | "bottom" | "left" | "right" | "box-sizing" | "aspect-ratio" | "width" | "height" | "min-width" | "min-height" | "max-width" | "max-height" | "overflow" | "overflow-x" | "overflow-y" | "scrollbar-width" | "scrollbar-color" | "container-type" | "container-name" | "object-fit" | "object-position" | "column-width" | "column-count" | "margin-top" | "margin-bottom" | "margin-left" | "margin-right" | "padding-top" | "padding-bottom" | "padding-left" | "padding-right" | "font-family" | "font-weight" | "font-size" | "line-height" | "text-align" | "font-style" | "font-variant" | "font-variant-numeric" | "font-feature-settings" | "text-decoration" | "text-decoration-line" | "text-decoration-color" | "text-decoration-style" | "text-decoration-thickness" | "text-underline-offset" | "letter-spacing" | "word-spacing" | "text-indent" | "text-transform" | "direction" | "white-space" | "text-wrap" | "word-break" | "overflow-wrap" | "hyphens" | "vertical-align" | "text-overflow" | "text-shadow" | "line-clamp" | "-webkit-line-clamp" | "-webkit-box-orient" | "-webkit-text-fill-color" | "-webkit-background-clip" | "box-decoration-break" | "-webkit-box-decoration-break" | "stroke" | "stroke-width";
-    label: "color" | "cursor" | "filter" | "fill" | "display" | "flex-wrap" | "flex-direction" | "align-items" | "justify-items" | "justify-content" | "align-content" | "row-gap" | "column-gap" | "grid-row-gap" | "grid-column-gap" | "grid-template-areas" | "grid-template-columns" | "grid-template-rows" | "grid-auto-flow" | "grid-auto-rows" | "grid-auto-columns" | "grid-row-start" | "grid-column-start" | "grid-row-end" | "grid-column-end" | "align-self" | "justify-self" | "order" | "flex-grow" | "flex-shrink" | "flex-basis" | "list-style" | "list-style-type" | "list-style-position" | "list-style-image" | "background-color" | "background-image" | "background-position" | "background-size" | "background-repeat" | "background-origin" | "background-clip" | "background-attachment" | "background-blend-mode" | "mask-image" | "mask-size" | "mask-position" | "mask-repeat" | "mask-composite" | "-webkit-mask-image" | "border-top-style" | "border-top-width" | "border-top-color" | "border-bottom-style" | "border-bottom-width" | "border-bottom-color" | "border-left-style" | "border-left-width" | "border-left-color" | "border-right-style" | "border-right-width" | "border-right-color" | "border-top-left-radius" | "border-top-right-radius" | "border-bottom-left-radius" | "border-bottom-right-radius" | "border-collapse" | "border-spacing" | "table-layout" | "opacity" | "visibility" | "transition" | "transition-property" | "transition-duration" | "transition-timing-function" | "transition-delay" | "transition-behavior" | "animation" | "animation-name" | "animation-duration" | "animation-timing-function" | "animation-delay" | "animation-iteration-count" | "animation-direction" | "animation-fill-mode" | "animation-play-state" | "animation-timeline" | "animation-range" | "box-shadow" | "backdrop-filter" | "mix-blend-mode" | "isolation" | "clip-path" | "transform" | "transform-origin" | "translate" | "rotate" | "scale" | "transform-style" | "perspective" | "perspective-origin" | "backface-visibility" | "will-change" | "outline-width" | "outline-style" | "outline-color" | "outline-offset" | "pointer-events" | "user-select" | "touch-action" | "resize" | "appearance" | "scroll-behavior" | "overscroll-behavior" | "scroll-snap-type" | "scroll-snap-align" | "scroll-snap-stop" | "scroll-padding-top" | "scroll-margin-top" | "accent-color" | "caret-color" | "color-scheme" | "content" | "position" | "float" | "clear" | "z-index" | "top" | "bottom" | "left" | "right" | "box-sizing" | "aspect-ratio" | "width" | "height" | "min-width" | "min-height" | "max-width" | "max-height" | "overflow" | "overflow-x" | "overflow-y" | "scrollbar-width" | "scrollbar-color" | "container-type" | "container-name" | "object-fit" | "object-position" | "column-width" | "column-count" | "margin-top" | "margin-bottom" | "margin-left" | "margin-right" | "padding-top" | "padding-bottom" | "padding-left" | "padding-right" | "font-family" | "font-weight" | "font-size" | "line-height" | "text-align" | "font-style" | "font-variant" | "font-variant-numeric" | "font-feature-settings" | "text-decoration" | "text-decoration-line" | "text-decoration-color" | "text-decoration-style" | "text-decoration-thickness" | "text-underline-offset" | "letter-spacing" | "word-spacing" | "text-indent" | "text-transform" | "direction" | "white-space" | "text-wrap" | "word-break" | "overflow-wrap" | "hyphens" | "vertical-align" | "text-overflow" | "text-shadow" | "line-clamp" | "-webkit-line-clamp" | "-webkit-box-orient" | "-webkit-text-fill-color" | "-webkit-background-clip" | "box-decoration-break" | "-webkit-box-decoration-break" | "stroke" | "stroke-width";
+    path: "color" | "cursor" | "filter" | "fill" | "display" | "flex-wrap" | "flex-direction" | "align-items" | "justify-items" | "justify-content" | "align-content" | "row-gap" | "column-gap" | "grid-row-gap" | "grid-column-gap" | "grid-template-areas" | "grid-template-columns" | "grid-template-rows" | "grid-auto-flow" | "grid-auto-rows" | "grid-auto-columns" | "grid-row-start" | "grid-column-start" | "grid-row-end" | "grid-column-end" | "align-self" | "justify-self" | "order" | "flex-grow" | "flex-shrink" | "flex-basis" | "list-style" | "list-style-type" | "list-style-position" | "list-style-image" | "background-color" | "background-image" | "background-position" | "background-size" | "background-repeat" | "background-origin" | "background-clip" | "background-attachment" | "background-blend-mode" | "mask-image" | "mask-size" | "mask-position" | "mask-repeat" | "mask-composite" | "-webkit-mask-image" | "border-top-style" | "border-top-width" | "border-top-color" | "border-bottom-style" | "border-bottom-width" | "border-bottom-color" | "border-left-style" | "border-left-width" | "border-left-color" | "border-right-style" | "border-right-width" | "border-right-color" | "border-top-left-radius" | "border-top-right-radius" | "border-bottom-left-radius" | "border-bottom-right-radius" | "border-collapse" | "border-spacing" | "table-layout" | "opacity" | "visibility" | "transition" | "transition-property" | "transition-duration" | "transition-timing-function" | "transition-delay" | "transition-behavior" | "animation" | "animation-name" | "animation-duration" | "animation-timing-function" | "animation-delay" | "animation-iteration-count" | "animation-direction" | "animation-fill-mode" | "animation-play-state" | "animation-timeline" | "animation-range" | "box-shadow" | "backdrop-filter" | "mix-blend-mode" | "isolation" | "clip-path" | "transform" | "transform-origin" | "translate" | "rotate" | "scale" | "transform-style" | "perspective" | "perspective-origin" | "backface-visibility" | "will-change" | "outline-width" | "outline-style" | "outline-color" | "outline-offset" | "pointer-events" | "user-select" | "touch-action" | "resize" | "appearance" | "scroll-behavior" | "overscroll-behavior" | "scroll-snap-type" | "scroll-snap-align" | "scroll-snap-stop" | "scroll-padding-top" | "scroll-margin-top" | "accent-color" | "caret-color" | "color-scheme" | "content" | "position" | "float" | "clear" | "z-index" | "top" | "bottom" | "left" | "right" | "box-sizing" | "aspect-ratio" | "width" | "height" | "min-width" | "min-height" | "max-width" | "max-height" | "overflow" | "overflow-x" | "overflow-y" | "scrollbar-width" | "scrollbar-color" | "container-type" | "container-name" | "object-fit" | "object-position" | "column-width" | "column-count" | "margin-top" | "margin-bottom" | "margin-left" | "margin-right" | "padding-top" | "padding-bottom" | "padding-left" | "padding-right" | "font-family" | "font-weight" | "font-size" | "line-height" | "text-align" | "font-style" | "font-variant" | "font-variant-numeric" | "font-feature-settings" | "text-decoration" | "text-decoration-line" | "text-decoration-color" | "text-decoration-style" | "text-decoration-thickness" | "text-underline-offset" | "letter-spacing" | "word-spacing" | "text-indent" | "text-transform" | "direction" | "writing-mode" | "text-orientation" | "white-space" | "text-wrap" | "word-break" | "overflow-wrap" | "hyphens" | "vertical-align" | "text-overflow" | "text-shadow" | "line-clamp" | "-webkit-line-clamp" | "-webkit-box-orient" | "-webkit-text-fill-color" | "-webkit-background-clip" | "box-decoration-break" | "-webkit-box-decoration-break" | "stroke" | "stroke-width";
+    label: "color" | "cursor" | "filter" | "fill" | "display" | "flex-wrap" | "flex-direction" | "align-items" | "justify-items" | "justify-content" | "align-content" | "row-gap" | "column-gap" | "grid-row-gap" | "grid-column-gap" | "grid-template-areas" | "grid-template-columns" | "grid-template-rows" | "grid-auto-flow" | "grid-auto-rows" | "grid-auto-columns" | "grid-row-start" | "grid-column-start" | "grid-row-end" | "grid-column-end" | "align-self" | "justify-self" | "order" | "flex-grow" | "flex-shrink" | "flex-basis" | "list-style" | "list-style-type" | "list-style-position" | "list-style-image" | "background-color" | "background-image" | "background-position" | "background-size" | "background-repeat" | "background-origin" | "background-clip" | "background-attachment" | "background-blend-mode" | "mask-image" | "mask-size" | "mask-position" | "mask-repeat" | "mask-composite" | "-webkit-mask-image" | "border-top-style" | "border-top-width" | "border-top-color" | "border-bottom-style" | "border-bottom-width" | "border-bottom-color" | "border-left-style" | "border-left-width" | "border-left-color" | "border-right-style" | "border-right-width" | "border-right-color" | "border-top-left-radius" | "border-top-right-radius" | "border-bottom-left-radius" | "border-bottom-right-radius" | "border-collapse" | "border-spacing" | "table-layout" | "opacity" | "visibility" | "transition" | "transition-property" | "transition-duration" | "transition-timing-function" | "transition-delay" | "transition-behavior" | "animation" | "animation-name" | "animation-duration" | "animation-timing-function" | "animation-delay" | "animation-iteration-count" | "animation-direction" | "animation-fill-mode" | "animation-play-state" | "animation-timeline" | "animation-range" | "box-shadow" | "backdrop-filter" | "mix-blend-mode" | "isolation" | "clip-path" | "transform" | "transform-origin" | "translate" | "rotate" | "scale" | "transform-style" | "perspective" | "perspective-origin" | "backface-visibility" | "will-change" | "outline-width" | "outline-style" | "outline-color" | "outline-offset" | "pointer-events" | "user-select" | "touch-action" | "resize" | "appearance" | "scroll-behavior" | "overscroll-behavior" | "scroll-snap-type" | "scroll-snap-align" | "scroll-snap-stop" | "scroll-padding-top" | "scroll-margin-top" | "accent-color" | "caret-color" | "color-scheme" | "content" | "position" | "float" | "clear" | "z-index" | "top" | "bottom" | "left" | "right" | "box-sizing" | "aspect-ratio" | "width" | "height" | "min-width" | "min-height" | "max-width" | "max-height" | "overflow" | "overflow-x" | "overflow-y" | "scrollbar-width" | "scrollbar-color" | "container-type" | "container-name" | "object-fit" | "object-position" | "column-width" | "column-count" | "margin-top" | "margin-bottom" | "margin-left" | "margin-right" | "padding-top" | "padding-bottom" | "padding-left" | "padding-right" | "font-family" | "font-weight" | "font-size" | "line-height" | "text-align" | "font-style" | "font-variant" | "font-variant-numeric" | "font-feature-settings" | "text-decoration" | "text-decoration-line" | "text-decoration-color" | "text-decoration-style" | "text-decoration-thickness" | "text-underline-offset" | "letter-spacing" | "word-spacing" | "text-indent" | "text-transform" | "direction" | "writing-mode" | "text-orientation" | "white-space" | "text-wrap" | "word-break" | "overflow-wrap" | "hyphens" | "vertical-align" | "text-overflow" | "text-shadow" | "line-clamp" | "-webkit-line-clamp" | "-webkit-box-orient" | "-webkit-text-fill-color" | "-webkit-background-clip" | "box-decoration-break" | "-webkit-box-decoration-break" | "stroke" | "stroke-width";
 }[];
 export declare const baseDefaultValue: Record<StyleCategory, StyleValue>;
 export default styleConstants;

package/dist/style/styleConstants.mjs

@@ -191,6 +191,8 @@ var e = {
 	TEXT_INDENT: "text-indent",
 	TEXT_TRANSFORM: "text-transform",
 	DIRECTION: "direction",
+	WRITING_MODE: "writing-mode",
+	TEXT_ORIENTATION: "text-orientation",
 	WHITE_SPACE: "white-space",
 	TEXT_WRAP: "text-wrap",
 	WORD_BREAK: "word-break",
@@ -413,6 +415,8 @@ var e = {
 	[t.TEXT_INDENT]: "0px",
 	[t.TEXT_TRANSFORM]: "none",
 	[t.DIRECTION]: "ltr",
+	[t.WRITING_MODE]: "horizontal-tb",
+	[t.TEXT_ORIENTATION]: "mixed",
 	[t.WHITE_SPACE]: "normal",
 	[t.TEXT_WRAP]: "wrap",
 	[t.WORD_BREAK]: "normal",

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/ServerTypes.d.ts

@@ -772,8 +772,9 @@ export type SSRCompressionConfig = {
     /** Responses smaller than this many bytes go out uncompressed. Default 1024. */
     threshold?: number;
     /**
-     * Brotli quality, 0–11, for a body compressed on every request — a page rendered for this request alone. Default 2:
-     * measured on a quarter core, going to 4 cost a tenth of the pages a second to save half a kilobyte on each.
+     * Brotli quality, 0–11, for a body compressed on every request — a page rendered for this request alone. Default 5:
+     * the first quality under gzip's size for the CPU gzip spends — 2 came out larger than gzip on a 220 KB page (36 KB
+     * against 31; 5: 29). On half a core it costs ~0.1 ms a page, 5–8% of the pages a second of a 6 KB page.
      */
     brotliQuality?: number;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plitzi/sdk-shared",
-  "version": "0.38.8",
+  "version": "0.38.10",
   "license": "AGPL-3.0",
   "files": [
     "dist",