@crossworks/content-core 0.239.35 → 0.239.36

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crossworks/content-core",
-  "version": "0.239.35",
+  "version": "0.239.36",
   "description": "Browser-safe content logic — markdown, blocks, pages, tables, formulas — shared by the server and any client. Zero server deps by design: nothing here may reach @mantle/db, node-only APIs, or the network (the jackdaw-repo-split P0 boundary).",
   "exports": {
     "./app-nav": "./src/app-nav.ts",
@@ -33,7 +33,7 @@
     "./tree": "./src/tree.ts"
   },
   "dependencies": {
-    "@mantle/client-types": "npm:@crossworks/client-types@0.239.35",
+    "@mantle/client-types": "npm:@crossworks/client-types@0.239.36",
     "marked": "^18.0.11",
     "mathjs": "15.2.0"
   },

package/src/profile-projections-fresh-look.test.ts

@@ -0,0 +1,86 @@
+import { describe, expect, it } from 'vitest';
+import {
+  DEFAULT_PREFERENCES,
+  FRESH_APPEARANCE,
+  projectNeatBackground,
+  readAvatarStyle,
+  readColorTheme,
+  readNeatBackground,
+} from './profile-projections';
+
+/**
+ * The fresh-install look: a brain that never chose wears the Jackdaw theme,
+ * Lorelei avatars and the Neat background. A brain that DID choose keeps its
+ * choice, and "off" for the background is a choice too.
+ */
+describe('FRESH_APPEARANCE', () => {
+  it('is the Jackdaw theme, Lorelei avatars and a valid Neat spec', () => {
+    expect(FRESH_APPEARANCE.colorTheme).toBe('jackdaw');
+    expect(FRESH_APPEARANCE.avatarStyle).toBe('lorelei');
+    // Survives the same projection a stored value goes through.
+    expect(projectNeatBackground(FRESH_APPEARANCE.neatBackground)).toBe(
+      FRESH_APPEARANCE.neatBackground,
+    );
+    expect(JSON.parse(FRESH_APPEARANCE.neatBackground)).toEqual({
+      v: 1,
+      seed: 55361,
+      tone: 'auto',
+      speed: 2,
+    });
+  });
+
+  it('is seeded into a new profile row', () => {
+    expect(DEFAULT_PREFERENCES.colorTheme).toBe(FRESH_APPEARANCE.colorTheme);
+    expect(DEFAULT_PREFERENCES.avatarStyle).toBe(FRESH_APPEARANCE.avatarStyle);
+    expect(DEFAULT_PREFERENCES.neatBackground).toBe(FRESH_APPEARANCE.neatBackground);
+  });
+});
+
+describe('readColorTheme', () => {
+  it('defaults an unset theme', () => {
+    expect(readColorTheme(undefined)).toBe('jackdaw');
+    expect(readColorTheme(null)).toBe('jackdaw');
+    expect(readColorTheme('')).toBe('jackdaw');
+    expect(readColorTheme('not a slug!')).toBe('jackdaw');
+  });
+
+  it('keeps a chosen theme, the old baseline included', () => {
+    expect(readColorTheme('clean-slate')).toBe('clean-slate');
+    expect(readColorTheme('darkmatter')).toBe('darkmatter');
+  });
+});
+
+describe('readAvatarStyle', () => {
+  it('defaults an unset style', () => {
+    expect(readAvatarStyle(undefined)).toBe('lorelei');
+    expect(readAvatarStyle('')).toBe('lorelei');
+  });
+
+  it('keeps a chosen style, the old default included', () => {
+    expect(readAvatarStyle('thumbs')).toBe('thumbs');
+    // Legacy ids survive storage; the web layer translates them on render.
+    expect(readAvatarStyle('beam')).toBe('beam');
+  });
+});
+
+describe('readNeatBackground', () => {
+  it('switches the background on for a brain that never set it', () => {
+    expect(readNeatBackground(undefined)).toBe(FRESH_APPEARANCE.neatBackground);
+    expect(readNeatBackground(null)).toBe(FRESH_APPEARANCE.neatBackground);
+  });
+
+  it('keeps an explicit OFF off', () => {
+    // '' is what the neat-background route stores for "off".
+    expect(readNeatBackground('')).toBeUndefined();
+  });
+
+  it('keeps a chosen spec', () => {
+    const mine = '{"v":1,"seed":7,"tone":"darker","speed":0}';
+    expect(readNeatBackground(mine)).toBe(mine);
+  });
+
+  it('reads garbage as off, never as the default', () => {
+    expect(readNeatBackground('{"v":2}')).toBeUndefined();
+    expect(readNeatBackground(42)).toBeUndefined();
+  });
+});

package/src/profile-projections.ts

@@ -30,6 +30,7 @@ import {
   thinkingEffortForBudget,
   type ThinkingEffort,
 } from './thinking-tiers';
+import { FRESH_APPEARANCE } from '@mantle/client-types/fresh-appearance';
 import {
   APP_OPENS_MAX,
   APP_PINS_MAX,
@@ -538,10 +539,39 @@ export const DEFAULT_HOUSE_STYLE =
   'ranges (2020\u20132024, pages 10\u201314) are correct and stay, and hyphens in compound ' +
   'words (self-hosted, read-only) are unaffected.';
 
+/** The fresh-install look (Jackdaw theme, Lorelei avatars, Neat on), shared
+ *  with the clients from @mantle/client-types. Re-exported so brain code reads
+ *  it from here like every other preference default. */
+export { FRESH_APPEARANCE };
+
+/** Read a stored `colorTheme` with the fresh-install default: any value that
+ *  does not project (unset, empty, garbage) reads as the default theme. */
+export function readColorTheme(raw: unknown): string {
+  return projectColorTheme(raw) ?? FRESH_APPEARANCE.colorTheme;
+}
+
+/** Read a stored `avatarStyle` with the fresh-install default, the
+ *  readColorTheme contract. */
+export function readAvatarStyle(raw: unknown): string {
+  return projectAvatarStyle(raw) ?? FRESH_APPEARANCE.avatarStyle;
+}
+
+/** Read a stored `neatBackground` with the fresh-install default. Only an
+ *  ABSENT key takes it: '' is the deliberate "off" the neat-background route
+ *  writes, so it must keep reading as off (undefined), never flip back on. */
+export function readNeatBackground(raw: unknown): string | undefined {
+  if (raw === undefined || raw === null) return FRESH_APPEARANCE.neatBackground;
+  return projectNeatBackground(raw);
+}
+
 export const DEFAULT_PREFERENCES: ProfilePreferences = {
   timezone: 'UTC',
   locale: 'en-GB',
   houseStyle: DEFAULT_HOUSE_STYLE,
+  // The fresh-install look, seeded so a new brain stores what it shows.
+  colorTheme: FRESH_APPEARANCE.colorTheme,
+  avatarStyle: FRESH_APPEARANCE.avatarStyle,
+  neatBackground: FRESH_APPEARANCE.neatBackground,
   // Live thinking on (streamThoughts defaults on) at Medium: the 4096 tier of
   // THINKING_TIERS. Unset would mean no thinking at all.
   thinkingBudget: 4096,