@crossworks/client-types 0.239.35 → 0.239.37

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crossworks/client-types",
-  "version": "0.239.35",
+  "version": "0.239.37",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/dto/rows.ts

@@ -297,8 +297,9 @@ export type ProfilePreferences = {
    *  as a compact JSON spec `{v,seed,tone,speed}` — colours are DERIVED from
    *  the live theme tokens client-side, never stored, so the background
    *  follows every colour theme and mode. Brain-level for the same reason as
-   *  backgrounds: it is the look of the product. Unset ⇒ the plain themed
-   *  fill. Read via projectNeatBackground, never raw. */
+   *  backgrounds: it is the look of the product. Never set ⇒ the
+   *  fresh-install spec (FRESH_APPEARANCE); '' ⇒ off, the plain themed fill.
+   *  Read via readNeatBackground, never raw. */
   neatBackground?: string;
   /** The brain's default light/dark mode for surfaces where the visitor has
    *  not chosen one themselves — today the public /s share reader, which stamps

package/src/fresh-appearance.ts

@@ -0,0 +1,23 @@
+/**
+ * The look a brain wears until someone chooses otherwise: the Jackdaw colour
+ * theme, Lorelei avatars, and the Neat background switched on.
+ *
+ * ONE source for every reader, and it lives HERE (zero dependencies) because
+ * both sides import it: the brain (content-core's DEFAULT_PREFERENCES and its
+ * read projections) and the clients (@mantle/share-ui's DEFAULT_AVATAR_STYLE,
+ * FRESH_COLOR_THEME and resolveAppearanceAttrs). Clients pin client-types and
+ * share-ui together, so a client can never hold one half of this without the
+ * other. A stored choice always wins; nothing writes this over a row that has
+ * one. It is for FRESH installs: migration keep_existing_look wrote the old
+ * look (clean-slate, thumbs, Neat off) into every profile row that existed
+ * before this release, so an existing brain looks exactly as it did.
+ *
+ * `neatBackground` is the canonical encodeNeatSpec form of
+ * `{v:1, seed, tone:'auto', speed:2}`. The seed was picked by eye against the
+ * Jackdaw theme in light and dark: a soft wash that stays behind content.
+ */
+export const FRESH_APPEARANCE = {
+  colorTheme: 'jackdaw',
+  avatarStyle: 'lorelei',
+  neatBackground: '{"v":1,"seed":55361,"tone":"auto","speed":2}',
+} as const;