@workjournal/shared 2.9.0 → 2.10.0

package/dist/__tests__/theme.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=theme.test.d.ts.map

package/dist/__tests__/theme.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/theme.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/theme.test.js

@@ -0,0 +1,50 @@
+import { describe, expect, it } from 'vitest';
+import { isThemePreference, resolveTheme, THEME_INIT_SCRIPT, THEME_PREFERENCES, THEME_STORAGE_KEY, } from '../theme.js';
+describe('isThemePreference', () => {
+    it('accepts the three valid preferences', () => {
+        expect(isThemePreference('system')).toBe(true);
+        expect(isThemePreference('light')).toBe(true);
+        expect(isThemePreference('dark')).toBe(true);
+    });
+    it('rejects anything else', () => {
+        expect(isThemePreference('Dark')).toBe(false);
+        expect(isThemePreference('')).toBe(false);
+        expect(isThemePreference(null)).toBe(false);
+        expect(isThemePreference(undefined)).toBe(false);
+        expect(isThemePreference(0)).toBe(false);
+    });
+});
+describe('resolveTheme', () => {
+    it('returns the explicit preference regardless of the OS signal', () => {
+        expect(resolveTheme('light', true)).toBe('light');
+        expect(resolveTheme('light', false)).toBe('light');
+        expect(resolveTheme('dark', true)).toBe('dark');
+        expect(resolveTheme('dark', false)).toBe('dark');
+    });
+    it('follows the OS signal when preference is system', () => {
+        expect(resolveTheme('system', true)).toBe('dark');
+        expect(resolveTheme('system', false)).toBe('light');
+    });
+});
+describe('theme constants', () => {
+    it('cycles system -> light -> dark', () => {
+        expect(THEME_PREFERENCES).toEqual(['system', 'light', 'dark']);
+    });
+    it('hard-codes the storage key inside the bootstrap script (no drift)', () => {
+        // The init script can't interpolate the constant at runtime in every
+        // build target, so it inlines the literal — guard the two against drift.
+        expect(THEME_INIT_SCRIPT).toContain(`'${THEME_STORAGE_KEY}'`);
+    });
+    it('bootstrap script toggles the dark class and swallows errors', () => {
+        expect(THEME_INIT_SCRIPT).toContain("classList.toggle('dark'");
+        expect(THEME_INIT_SCRIPT).toContain('catch');
+        expect(THEME_INIT_SCRIPT).toContain('prefers-color-scheme: dark');
+    });
+    it('bootstrap script normalizes untrusted storage values to system', () => {
+        // Must mirror the runtime isThemePreference fallback so pre-paint and
+        // hydrated results never disagree (CR #694).
+        expect(THEME_INIT_SCRIPT).toContain("p!=='light'&&p!=='dark'&&p!=='system'");
+        expect(THEME_INIT_SCRIPT).toContain("p='system'");
+    });
+});
+//# sourceMappingURL=theme.test.js.map

package/dist/__tests__/theme.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.test.js","sourceRoot":"","sources":["../../src/__tests__/theme.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACN,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,GACjB,MAAM,aAAa,CAAC;AAErB,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAChC,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjD,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACtE,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnD,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChD,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACzC,MAAM,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC5E,qEAAqE;QACrE,yEAAyE;QACzE,MAAM,CAAC,iBAAiB,CAAC,CAAC,SAAS,CAAC,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACtE,MAAM,CAAC,iBAAiB,CAAC,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;QAC/D,MAAM,CAAC,iBAAiB,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,CAAC,iBAAiB,CAAC,CAAC,SAAS,CAAC,4BAA4B,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACzE,sEAAsE;QACtE,6CAA6C;QAC7C,MAAM,CAAC,iBAAiB,CAAC,CAAC,SAAS,CAAC,uCAAuC,CAAC,CAAC;QAC7E,MAAM,CAAC,iBAAiB,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -7,6 +7,8 @@ export { proposeWorkspaceNameFromEmail } from './propose-workspace-name.js';
 export { isReservedSlug, MAX_NAME_LENGTH, MAX_SLUG_LENGTH, RESERVED_SLUGS, slugify, } from './slug.js';
 export type { ClientOption, InterfaceOption } from './support-labels.js';
 export { CLIENT_OPTIONS, INTERFACE_OPTIONS, isClientOption, isInterfaceOption, } from './support-labels.js';
+export type { ResolvedTheme, ThemePreference } from './theme.js';
+export { isThemePreference, resolveTheme, THEME_INIT_SCRIPT, THEME_PREFERENCES, THEME_STORAGE_KEY, } from './theme.js';
 export type { FeatureFlag } from './tiers.js';
 export { canUseFeature, canUseFeatureForCode } from './tiers.js';
 export type { AcceptInvitationRequest, AcceptLegalRequest, ApiError, CreateEntryRequest, CreateInvitationRequest, CreateJournalRequest, CreatePromptRequest, CreateTagRequest, CreateWorkspaceRequest, Entry, EntrySummary, EntryWithNeighbors, Invitation, Journal, JournalContributor, JournalContributorRow, JournalContributorWithEmail, JournalPromptInfo, JournalTagAssignment, PaginatedResponse, Prompt, RagSearchRequest, RagSearchResponse, RagSearchResult, SharedJournal, Tag, TagWithAssignment, Tier, TierCode, UpdateEntryRequest, UpdateJournalRequest, UpdatePromptRequest, UpdateTagRequest, UserProfile, Workspace, } from './types.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EACN,SAAS,EACT,WAAW,EACX,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,uBAAuB,EACvB,cAAc,EACd,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,GACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EACN,UAAU,EACV,aAAa,EACb,OAAO,EACP,SAAS,EACT,aAAa,EACb,OAAO,EACP,WAAW,EACX,WAAW,EACX,SAAS,GACT,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EACN,cAAc,EACd,eAAe,EACf,eAAe,EACf,cAAc,EACd,OAAO,GACP,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EACN,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,iBAAiB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACjE,YAAY,EACX,uBAAuB,EACvB,kBAAkB,EAClB,QAAQ,EACR,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,KAAK,EACL,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,OAAO,EACP,kBAAkB,EAClB,qBAAqB,EACrB,2BAA2B,EAC3B,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,MAAM,EACN,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,GAAG,EACH,iBAAiB,EACjB,IAAI,EACJ,QAAQ,EACR,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,SAAS,GACT,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EACN,SAAS,EACT,WAAW,EACX,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,uBAAuB,EACvB,cAAc,EACd,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,GACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EACN,UAAU,EACV,aAAa,EACb,OAAO,EACP,SAAS,EACT,aAAa,EACb,OAAO,EACP,WAAW,EACX,WAAW,EACX,SAAS,GACT,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EACN,cAAc,EACd,eAAe,EACf,eAAe,EACf,cAAc,EACd,OAAO,GACP,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EACN,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,iBAAiB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EACN,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,GACjB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACjE,YAAY,EACX,uBAAuB,EACvB,kBAAkB,EAClB,QAAQ,EACR,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,KAAK,EACL,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,OAAO,EACP,kBAAkB,EAClB,qBAAqB,EACrB,2BAA2B,EAC3B,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,MAAM,EACN,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,GAAG,EACH,iBAAiB,EACjB,IAAI,EACJ,QAAQ,EACR,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,SAAS,GACT,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -4,5 +4,6 @@ export { AAD_STRING, isOpaqueToken, KEY_LEN, NONCE_LEN, resolveBearer, TAG_LEN,
 export { proposeWorkspaceNameFromEmail } from './propose-workspace-name.js';
 export { isReservedSlug, MAX_NAME_LENGTH, MAX_SLUG_LENGTH, RESERVED_SLUGS, slugify, } from './slug.js';
 export { CLIENT_OPTIONS, INTERFACE_OPTIONS, isClientOption, isInterfaceOption, } from './support-labels.js';
+export { isThemePreference, resolveTheme, THEME_INIT_SCRIPT, THEME_PREFERENCES, THEME_STORAGE_KEY, } from './theme.js';
 export { canUseFeature, canUseFeatureForCode } from './tiers.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,SAAS,EACT,WAAW,EACX,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,uBAAuB,EACvB,cAAc,EACd,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,GACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,EACN,UAAU,EACV,aAAa,EACb,OAAO,EACP,SAAS,EACT,aAAa,EACb,OAAO,EACP,WAAW,EACX,WAAW,EACX,SAAS,GACT,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EACN,cAAc,EACd,eAAe,EACf,eAAe,EACf,cAAc,EACd,OAAO,GACP,MAAM,WAAW,CAAC;AAEnB,OAAO,EACN,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,iBAAiB,GACjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,SAAS,EACT,WAAW,EACX,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,uBAAuB,EACvB,cAAc,EACd,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,GACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,EACN,UAAU,EACV,aAAa,EACb,OAAO,EACP,SAAS,EACT,aAAa,EACb,OAAO,EACP,WAAW,EACX,WAAW,EACX,SAAS,GACT,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EACN,cAAc,EACd,eAAe,EACf,eAAe,EACf,cAAc,EACd,OAAO,GACP,MAAM,WAAW,CAAC;AAEnB,OAAO,EACN,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,iBAAiB,GACjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACN,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

package/dist/theme.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Theme (light / dark) contract shared by every browser surface.
+ *
+ * `apps/web` (React / Tailwind v4) and `apps/landing` (Astro / plain CSS) both
+ * activate dark mode by toggling the `.dark` class on `<html>` — the design
+ * system's `tokens.css` carries the full `.dark` palette. The two surfaces must
+ * agree on the localStorage key and the system/light/dark resolution semantics
+ * or a user who sets dark on the app and opens the marketing site sees the
+ * wrong theme. Single-sourcing those primitives here makes that drift
+ * impossible — same rationale as `connections.ts`.
+ */
+/** What the user picked. `system` defers to the OS `prefers-color-scheme`. */
+export type ThemePreference = 'system' | 'light' | 'dark';
+/** The concrete theme actually applied to the DOM. */
+export type ResolvedTheme = 'light' | 'dark';
+/** localStorage key holding the persisted {@link ThemePreference}. */
+export declare const THEME_STORAGE_KEY = "wj-theme";
+/** The three selectable preferences, in cycle order (toggle steps through these). */
+export declare const THEME_PREFERENCES: readonly ThemePreference[];
+/** Narrow an untrusted value (e.g. a localStorage read) to a {@link ThemePreference}. */
+export declare function isThemePreference(value: unknown): value is ThemePreference;
+/**
+ * Collapse a preference + the current OS dark-mode signal into the concrete
+ * theme to apply. `prefersDark` is the value of
+ * `matchMedia('(prefers-color-scheme: dark)').matches`.
+ */
+export declare function resolveTheme(preference: ThemePreference, prefersDark: boolean): ResolvedTheme;
+/**
+ * Blocking bootstrap script, inlined in the document `<head>` of every surface
+ * BEFORE first paint to prevent a flash of the wrong theme (FOUC). It reads the
+ * persisted preference and applies `.dark` synchronously; the runtime provider
+ * / toggle takes over once hydrated. Kept dependency-free and self-contained so
+ * it can run as a plain inline `<script>`.
+ *
+ * The literal key here mirrors {@link THEME_STORAGE_KEY}; both must stay in
+ * sync (the constant can't be interpolated into a surface's static HTML head in
+ * every build target, so this string hard-codes it — tested in theme.test.ts).
+ *
+ * Untrusted storage values are normalized to a valid preference (fallback
+ * `system`) before resolving, so the pre-paint result matches the runtime
+ * provider's {@link isThemePreference}-guarded logic exactly — otherwise a junk
+ * value + OS-dark would paint light then flip, reintroducing the FOUC.
+ */
+export declare const THEME_INIT_SCRIPT = "(function(){try{var p=localStorage.getItem('wj-theme');if(p!=='light'&&p!=='dark'&&p!=='system')p='system';var d=p==='dark'||(p==='system'&&window.matchMedia('(prefers-color-scheme: dark)').matches);document.documentElement.classList.toggle('dark',d);}catch(e){}})();";
+//# sourceMappingURL=theme.d.ts.map

package/dist/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,8EAA8E;AAC9E,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAE1D,sDAAsD;AACtD,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;AAE7C,sEAAsE;AACtE,eAAO,MAAM,iBAAiB,aAAa,CAAC;AAE5C,qFAAqF;AACrF,eAAO,MAAM,iBAAiB,EAAE,SAAS,eAAe,EAAgC,CAAC;AAEzF,yFAAyF;AACzF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,GAAG,aAAa,CAG7F;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,iBAAiB,gRAA4R,CAAC"}

package/dist/theme.js

@@ -0,0 +1,47 @@
+/**
+ * Theme (light / dark) contract shared by every browser surface.
+ *
+ * `apps/web` (React / Tailwind v4) and `apps/landing` (Astro / plain CSS) both
+ * activate dark mode by toggling the `.dark` class on `<html>` — the design
+ * system's `tokens.css` carries the full `.dark` palette. The two surfaces must
+ * agree on the localStorage key and the system/light/dark resolution semantics
+ * or a user who sets dark on the app and opens the marketing site sees the
+ * wrong theme. Single-sourcing those primitives here makes that drift
+ * impossible — same rationale as `connections.ts`.
+ */
+/** localStorage key holding the persisted {@link ThemePreference}. */
+export const THEME_STORAGE_KEY = 'wj-theme';
+/** The three selectable preferences, in cycle order (toggle steps through these). */
+export const THEME_PREFERENCES = ['system', 'light', 'dark'];
+/** Narrow an untrusted value (e.g. a localStorage read) to a {@link ThemePreference}. */
+export function isThemePreference(value) {
+    return value === 'system' || value === 'light' || value === 'dark';
+}
+/**
+ * Collapse a preference + the current OS dark-mode signal into the concrete
+ * theme to apply. `prefersDark` is the value of
+ * `matchMedia('(prefers-color-scheme: dark)').matches`.
+ */
+export function resolveTheme(preference, prefersDark) {
+    if (preference === 'system')
+        return prefersDark ? 'dark' : 'light';
+    return preference;
+}
+/**
+ * Blocking bootstrap script, inlined in the document `<head>` of every surface
+ * BEFORE first paint to prevent a flash of the wrong theme (FOUC). It reads the
+ * persisted preference and applies `.dark` synchronously; the runtime provider
+ * / toggle takes over once hydrated. Kept dependency-free and self-contained so
+ * it can run as a plain inline `<script>`.
+ *
+ * The literal key here mirrors {@link THEME_STORAGE_KEY}; both must stay in
+ * sync (the constant can't be interpolated into a surface's static HTML head in
+ * every build target, so this string hard-codes it — tested in theme.test.ts).
+ *
+ * Untrusted storage values are normalized to a valid preference (fallback
+ * `system`) before resolving, so the pre-paint result matches the runtime
+ * provider's {@link isThemePreference}-guarded logic exactly — otherwise a junk
+ * value + OS-dark would paint light then flip, reintroducing the FOUC.
+ */
+export const THEME_INIT_SCRIPT = `(function(){try{var p=localStorage.getItem('${THEME_STORAGE_KEY}');if(p!=='light'&&p!=='dark'&&p!=='system')p='system';var d=p==='dark'||(p==='system'&&window.matchMedia('(prefers-color-scheme: dark)').matches);document.documentElement.classList.toggle('dark',d);}catch(e){}})();`;
+//# sourceMappingURL=theme.js.map

package/dist/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,sEAAsE;AACtE,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC;AAE5C,qFAAqF;AACrF,MAAM,CAAC,MAAM,iBAAiB,GAA+B,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAEzF,yFAAyF;AACzF,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC/C,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM,CAAC;AACpE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,UAA2B,EAAE,WAAoB;IAC7E,IAAI,UAAU,KAAK,QAAQ;QAAE,OAAO,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IACnE,OAAO,UAAU,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,+CAA+C,iBAAiB,yNAAyN,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@workjournal/shared",
-  "version": "2.9.0",
+  "version": "2.10.0",
   "description": "Shared types, constants, and credential helpers for the Workjournal CLI and MCP server.",
   "license": "MIT",
   "type": "module",