@agent-native/core 0.213.1 → 0.214.0

package/dist/appearance/actions/get-theme-family.d.ts

@@ -0,0 +1,8 @@
+import { type ThemeFamily } from "../theme-family.js";
+export interface ThemeFamilyPreference {
+    family: ThemeFamily;
+    source: "default" | "user-setting";
+    appId: string | null;
+}
+declare const _default: import("../../action.js").ActionDefinition<Record<string, never>, ThemeFamilyPreference>;
+export default _default;

package/dist/appearance/actions/get-theme-family.js

@@ -0,0 +1,38 @@
+import { z } from "zod";
+import { defineAction, fail } from "../../action.js";
+import { getUserSetting } from "../../settings/user-settings.js";
+import { DEFAULT_THEME_FAMILY, THEME_FAMILIES, themeFamilySettingKey, } from "../theme-family.js";
+export default defineAction({
+    description: "Read the current app's saved theme family, which is independent of light or dark color mode.",
+    schema: z.object({}),
+    http: { method: "GET" },
+    readOnly: true,
+    agentTool: false,
+    run: async (_args, ctx) => {
+        const email = ctx?.userEmail;
+        if (!email)
+            fail("Not authenticated.", { statusCode: 401 });
+        const stored = await getUserSetting(email, themeFamilySettingKey(ctx?.appId));
+        if (stored === null) {
+            return {
+                family: DEFAULT_THEME_FAMILY,
+                source: "default",
+                appId: ctx?.appId ?? null,
+            };
+        }
+        const parsed = z
+            .object({ family: z.enum(THEME_FAMILIES) })
+            .safeParse(stored);
+        if (!parsed.success) {
+            fail("The saved theme family setting is invalid and could not be read.", {
+                errorCode: "theme_family_setting_invalid",
+                statusCode: 500,
+            });
+        }
+        return {
+            family: parsed.data.family,
+            source: "user-setting",
+            appId: ctx?.appId ?? null,
+        };
+    },
+});

package/dist/appearance/actions/set-theme-family.d.ts

@@ -0,0 +1,7 @@
+declare const _default: import("../../action.js").ActionDefinition<{
+    family: "agent-native" | "original";
+}, {
+    family: "agent-native" | "original";
+    appId: string;
+}>;
+export default _default;

package/dist/appearance/actions/set-theme-family.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import { defineAction, fail } from "../../action.js";
+import { writeAppState } from "../../application-state/script-helpers.js";
+import { putUserSetting } from "../../settings/user-settings.js";
+import { THEME_FAMILIES, themeFamilyAppStateKey, themeFamilySettingKey, } from "../theme-family.js";
+export default defineAction({
+    description: "Set the current app's theme family to agent-native or original. This is separate from light or dark color mode.",
+    schema: z.object({
+        family: z
+            .enum(THEME_FAMILIES)
+            .describe("Theme family: agent-native or original."),
+    }),
+    http: { method: "POST" },
+    mcpAnnotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        openWorldHint: false,
+    },
+    run: async ({ family }, ctx) => {
+        const email = ctx?.userEmail;
+        if (!email)
+            fail("Not authenticated.", { statusCode: 401 });
+        const settingKey = themeFamilySettingKey(ctx?.appId);
+        await putUserSetting(email, settingKey, { family });
+        try {
+            await writeAppState(themeFamilyAppStateKey(ctx?.appId), { family });
+        }
+        catch {
+            fail("The theme family was saved, but the open app could not be synchronized.", { errorCode: "theme_family_sync_failed", statusCode: 503 });
+        }
+        return { family, appId: ctx?.appId ?? null };
+    },
+});

package/dist/appearance/theme-family.d.ts

@@ -0,0 +1,13 @@
+export declare const THEME_FAMILIES: readonly ["agent-native", "original"];
+export type ThemeFamily = (typeof THEME_FAMILIES)[number];
+export declare const DEFAULT_THEME_FAMILY: ThemeFamily;
+export declare const THEME_FAMILY_STORAGE_KEY = "theme-family";
+export declare const THEME_FAMILY_ATTRIBUTE = "data-theme-family";
+export declare const THEME_FAMILY_STATUS_ATTRIBUTE = "data-theme-family-status";
+export declare const THEME_FAMILY_APP_STATE_KEY = "theme-family";
+export declare const THEME_FAMILY_SETTING_PREFIX = "theme-family";
+export declare function isThemeFamily(value: unknown): value is ThemeFamily;
+export declare function themeFamilySettingKey(appId?: string): string;
+export declare function themeFamilyStorageKey(appId?: string): string;
+export declare function themeFamilyAppStateKey(appId?: string): string;
+export declare function getThemeFamilyInitScript(appId?: string | null): string;

package/dist/appearance/theme-family.js

@@ -0,0 +1,38 @@
+export const THEME_FAMILIES = ["agent-native", "original"];
+export const DEFAULT_THEME_FAMILY = "original";
+export const THEME_FAMILY_STORAGE_KEY = "theme-family";
+export const THEME_FAMILY_ATTRIBUTE = "data-theme-family";
+export const THEME_FAMILY_STATUS_ATTRIBUTE = "data-theme-family-status";
+export const THEME_FAMILY_APP_STATE_KEY = "theme-family";
+export const THEME_FAMILY_SETTING_PREFIX = "theme-family";
+export function isThemeFamily(value) {
+    return value === "agent-native" || value === "original";
+}
+export function themeFamilySettingKey(appId) {
+    // Older or standalone action contexts can genuinely omit appId. Keep their
+    // setting isolated under one stable fallback rather than borrowing another app's choice.
+    if (appId === undefined)
+        return `${THEME_FAMILY_SETTING_PREFIX}:__no_app_id__`;
+    const normalizedAppId = appId.trim().toLowerCase();
+    if (!normalizedAppId) {
+        throw new TypeError("Theme family settings require a non-empty appId.");
+    }
+    return `${THEME_FAMILY_SETTING_PREFIX}:${encodeURIComponent(normalizedAppId)}`;
+}
+export function themeFamilyStorageKey(appId) {
+    return themeFamilySettingKey(appId);
+}
+export function themeFamilyAppStateKey(appId) {
+    if (appId === undefined)
+        return `${THEME_FAMILY_APP_STATE_KEY}:__no_app_id__`;
+    const normalizedAppId = appId.trim().toLowerCase();
+    if (!normalizedAppId) {
+        throw new TypeError("Theme family application state requires a non-empty appId.");
+    }
+    const encodedAppId = Array.from(normalizedAppId, (character) => character.codePointAt(0).toString(16)).join("_");
+    return `${THEME_FAMILY_APP_STATE_KEY}:${encodedAppId}`;
+}
+export function getThemeFamilyInitScript(appId) {
+    const storageKey = themeFamilyStorageKey(appId ?? undefined);
+    return `(function(){var root=document.documentElement;var fallback=${JSON.stringify(DEFAULT_THEME_FAMILY)};try{var value=window.localStorage.getItem(${JSON.stringify(storageKey)});if(value===null){root.setAttribute(${JSON.stringify(THEME_FAMILY_ATTRIBUTE)},fallback);root.setAttribute(${JSON.stringify(THEME_FAMILY_STATUS_ATTRIBUTE)},'awaiting-app-setting');return}if(value==='agent-native'||value==='original'){root.setAttribute(${JSON.stringify(THEME_FAMILY_ATTRIBUTE)},value);root.removeAttribute(${JSON.stringify(THEME_FAMILY_STATUS_ATTRIBUTE)});return}root.setAttribute(${JSON.stringify(THEME_FAMILY_ATTRIBUTE)},fallback);root.setAttribute(${JSON.stringify(THEME_FAMILY_STATUS_ATTRIBUTE)},'invalid')}catch(e){root.setAttribute(${JSON.stringify(THEME_FAMILY_ATTRIBUTE)},fallback);root.setAttribute(${JSON.stringify(THEME_FAMILY_STATUS_ATTRIBUTE)},'unreadable')}})();`;
+}

package/dist/client/theme-family.d.ts

@@ -0,0 +1,35 @@
+import { type ThemeFamily } from "../appearance/theme-family.js";
+export { DEFAULT_THEME_FAMILY, isThemeFamily, THEME_FAMILY_APP_STATE_KEY, THEME_FAMILY_ATTRIBUTE, THEME_FAMILY_STORAGE_KEY, themeFamilyAppStateKey, themeFamilyStorageKey, type ThemeFamily, } from "../appearance/theme-family.js";
+export declare const THEME_FAMILY_CHANGE_EVENT = "agent-native:theme-family-change";
+export type ThemeFamilyStorageStatus = "valid" | "missing" | "invalid" | "unreadable";
+export type StoredThemeFamily = {
+    status: "valid";
+    family: ThemeFamily;
+} | {
+    status: "missing";
+} | {
+    status: "invalid";
+    value: string;
+} | {
+    status: "unreadable";
+    error: Error;
+};
+export interface ThemeFamilyApplyResult {
+    family: ThemeFamily;
+    storageStatus: "saved" | "unavailable";
+}
+export interface ThemeFamilyPreference {
+    family: ThemeFamily;
+    source: "default" | "user-setting";
+    appId: string | null;
+}
+export declare function readStoredThemeFamily(appId?: string | null): StoredThemeFamily;
+export declare function applyThemeFamily(family: ThemeFamily, appId?: string | null): ThemeFamilyApplyResult;
+export interface ThemeFamilyHook {
+    family: ThemeFamily;
+    status: "loading" | "success" | "error";
+    error?: Error;
+    storageStatus: ThemeFamilyStorageStatus;
+    setFamily: (family: ThemeFamily) => Promise<ThemeFamily>;
+}
+export declare function useThemeFamily(): ThemeFamilyHook;

package/dist/client/theme-family.js

@@ -0,0 +1,223 @@
+import { useCallback, useEffect, useRef, useState, useSyncExternalStore, } from "react";
+import { DEFAULT_THEME_FAMILY, isThemeFamily, THEME_FAMILY_ATTRIBUTE, THEME_FAMILY_STATUS_ATTRIBUTE, themeFamilyAppStateKey, themeFamilyStorageKey, } from "../appearance/theme-family.js";
+import { injectedAgentNativeAppId } from "./app-config.js";
+import { readClientAppState } from "./application-state.js";
+import { useActionMutation, useActionQuery } from "./use-action.js";
+import { useChangeVersion } from "./use-change-version.js";
+export { DEFAULT_THEME_FAMILY, isThemeFamily, THEME_FAMILY_APP_STATE_KEY, THEME_FAMILY_ATTRIBUTE, THEME_FAMILY_STORAGE_KEY, themeFamilyAppStateKey, themeFamilyStorageKey, } from "../appearance/theme-family.js";
+export const THEME_FAMILY_CHANGE_EVENT = "agent-native:theme-family-change";
+const familySnapshots = new Map();
+function resolvedAppId(appId) {
+    if (appId !== undefined)
+        return appId ?? undefined;
+    return injectedAgentNativeAppId() ?? undefined;
+}
+function scopeKey(appId) {
+    return themeFamilyStorageKey(resolvedAppId(appId));
+}
+function asError(error) {
+    return error instanceof Error ? error : new Error(String(error));
+}
+export function readStoredThemeFamily(appId) {
+    if (typeof window === "undefined")
+        return { status: "missing" };
+    let value;
+    try {
+        value = window.localStorage.getItem(themeFamilyStorageKey(resolvedAppId(appId)));
+    }
+    catch (error) {
+        return { status: "unreadable", error: asError(error) };
+    }
+    if (value === null)
+        return { status: "missing" };
+    if (isThemeFamily(value))
+        return { status: "valid", family: value };
+    return { status: "invalid", value };
+}
+function getFamilySnapshot(appId) {
+    return familySnapshots.get(scopeKey(appId)) ?? DEFAULT_THEME_FAMILY;
+}
+function subscribe(onChange, appId) {
+    if (typeof window === "undefined")
+        return () => { };
+    const refreshFromStorage = () => {
+        const stored = readStoredThemeFamily(appId);
+        const key = scopeKey(appId);
+        if (stored.status === "valid") {
+            familySnapshots.set(key, stored.family);
+            window.document.documentElement.setAttribute(THEME_FAMILY_ATTRIBUTE, stored.family);
+            window.document.documentElement.removeAttribute(THEME_FAMILY_STATUS_ATTRIBUTE);
+        }
+        else if (stored.status === "missing" || stored.status === "invalid") {
+            familySnapshots.set(key, DEFAULT_THEME_FAMILY);
+            window.document.documentElement.setAttribute(THEME_FAMILY_ATTRIBUTE, DEFAULT_THEME_FAMILY);
+            if (stored.status === "invalid") {
+                window.document.documentElement.setAttribute(THEME_FAMILY_STATUS_ATTRIBUTE, "invalid");
+            }
+        }
+        onChange();
+    };
+    const onStorage = (event) => {
+        if (event.key === null || event.key === scopeKey(appId)) {
+            refreshFromStorage();
+        }
+    };
+    const onFamilyChange = (event) => {
+        const storageKey = event.detail
+            ?.storageKey;
+        if (storageKey === scopeKey(appId))
+            refreshFromStorage();
+    };
+    window.addEventListener("storage", onStorage);
+    window.addEventListener(THEME_FAMILY_CHANGE_EVENT, onFamilyChange);
+    return () => {
+        window.removeEventListener("storage", onStorage);
+        window.removeEventListener(THEME_FAMILY_CHANGE_EVENT, onFamilyChange);
+    };
+}
+export function applyThemeFamily(family, appId) {
+    if (!isThemeFamily(family)) {
+        throw new TypeError(`Unknown theme family: ${String(family)}`);
+    }
+    const storageAppId = resolvedAppId(appId);
+    const key = themeFamilyStorageKey(storageAppId);
+    familySnapshots.set(key, family);
+    if (typeof window === "undefined") {
+        return { family, storageStatus: "unavailable" };
+    }
+    const root = window.document.documentElement;
+    root.setAttribute(THEME_FAMILY_ATTRIBUTE, family);
+    try {
+        window.localStorage.setItem(key, family);
+        root.removeAttribute(THEME_FAMILY_STATUS_ATTRIBUTE);
+        window.dispatchEvent(new CustomEvent(THEME_FAMILY_CHANGE_EVENT, {
+            detail: { storageKey: key },
+        }));
+        return { family, storageStatus: "saved" };
+    }
+    catch {
+        root.setAttribute(THEME_FAMILY_STATUS_ATTRIBUTE, "unreadable");
+        window.dispatchEvent(new CustomEvent(THEME_FAMILY_CHANGE_EVENT, {
+            detail: { storageKey: key },
+        }));
+        return { family, storageStatus: "unavailable" };
+    }
+}
+function storageStatusForApply(result) {
+    return result.storageStatus === "saved" ? "valid" : "unreadable";
+}
+function errorForState(value) {
+    return new Error(`The open app's theme-family state is invalid: ${JSON.stringify(value)}`);
+}
+export function useThemeFamily() {
+    const runtimeAppId = injectedAgentNativeAppId();
+    const query = useActionQuery("get-theme-family", undefined, { retry: false, queryKeyScope: ["theme-family", runtimeAppId] });
+    const mutation = useActionMutation("set-theme-family", { skipActionQueryInvalidation: true });
+    const appId = query.data === undefined ? runtimeAppId : query.data.appId;
+    const appStateKey = themeFamilyAppStateKey(appId ?? undefined);
+    const appStateVersion = useChangeVersion(`app-state:${appStateKey}`);
+    const [storageStatus, setStorageStatus] = useState(() => readStoredThemeFamily(appId).status);
+    const [mutationError, setMutationError] = useState();
+    const mutationPending = useRef(false);
+    const family = useSyncExternalStore((onChange) => subscribe(onChange, appId), () => getFamilySnapshot(appId), () => DEFAULT_THEME_FAMILY);
+    useEffect(() => {
+        if (mutationPending.current)
+            return;
+        if (query.data === undefined)
+            return;
+        if (!isThemeFamily(query.data?.family)) {
+            setMutationError(errorForState(query.data));
+            return;
+        }
+        const applied = applyThemeFamily(query.data.family, query.data.appId);
+        setStorageStatus(storageStatusForApply(applied));
+        setMutationError(undefined);
+    }, [mutationPending, query.data]);
+    useEffect(() => {
+        if (appStateVersion === 0)
+            return;
+        let current = true;
+        void readClientAppState(appStateKey)
+            .then((state) => {
+            if (!current || state === null)
+                return;
+            if (!isThemeFamily(state.family)) {
+                setMutationError(errorForState(state));
+                return;
+            }
+            const applied = applyThemeFamily(state.family, appId);
+            setStorageStatus(storageStatusForApply(applied));
+            setMutationError(undefined);
+        })
+            .catch((error) => {
+            if (current)
+                setMutationError(asError(error));
+        });
+        return () => {
+            current = false;
+        };
+    }, [appId, appStateKey, appStateVersion]);
+    const setFamily = useCallback(async (nextFamily) => {
+        if (!isThemeFamily(nextFamily)) {
+            throw new TypeError(`Unknown theme family: ${String(nextFamily)}`);
+        }
+        const previousAppId = appId;
+        const previousFamily = getFamilySnapshot(previousAppId);
+        mutationPending.current = true;
+        const optimistic = applyThemeFamily(nextFamily, previousAppId);
+        setStorageStatus(storageStatusForApply(optimistic));
+        setMutationError(undefined);
+        try {
+            const result = await mutation.mutateAsync({ family: nextFamily });
+            if (!isThemeFamily(result?.family)) {
+                throw errorForState(result);
+            }
+            if (result.appId !== null && typeof result.appId !== "string") {
+                throw errorForState(result);
+            }
+            if (result.family !== nextFamily) {
+                throw new Error("The saved theme family did not match the selection.");
+            }
+            mutationPending.current = false;
+            const applied = applyThemeFamily(result.family, result.appId);
+            setStorageStatus(storageStatusForApply(applied));
+            return result.family;
+        }
+        catch (error) {
+            const normalized = asError(error);
+            let reconciledFamily = previousFamily;
+            let reconciledAppId = previousAppId;
+            let reconciliationError;
+            try {
+                const refreshed = await query.refetch();
+                const data = refreshed.data;
+                if (refreshed.isError) {
+                    reconciliationError = asError(refreshed.error);
+                }
+                else if (!data ||
+                    !isThemeFamily(data.family) ||
+                    (data.appId !== null && typeof data.appId !== "string")) {
+                    reconciliationError = errorForState(data);
+                }
+                else {
+                    reconciledFamily = data.family;
+                    reconciledAppId = data.appId;
+                }
+            }
+            catch (refreshError) {
+                reconciliationError = asError(refreshError);
+            }
+            mutationPending.current = false;
+            const reconciled = applyThemeFamily(reconciledFamily, reconciledAppId);
+            setStorageStatus(storageStatusForApply(reconciled));
+            const failure = reconciliationError
+                ? new AggregateError([normalized, reconciliationError], "The theme family update failed and its saved value could not be reloaded.")
+                : normalized;
+            setMutationError(failure);
+            throw failure;
+        }
+    }, [appId, mutation]);
+    const error = mutationError ?? (query.isError ? asError(query.error) : undefined);
+    const status = error ? "error" : query.isSuccess ? "success" : "loading";
+    return { family, status, error, storageStatus, setFamily };
+}

package/dist/client/theme.d.ts

@@ -15,5 +15,5 @@ export interface NormalizedEmbeddedThemeUpdate {
 export declare function parseEmbeddedThemeUpdate(value: unknown): NormalizedEmbeddedThemeUpdate | null;
 export declare function buildEmbeddedThemeUpdate(theme: ResolvedTheme, vars?: Record<string, string>): EmbeddedThemeUpdate;
 export declare function applyEmbeddedThemeUpdate(root: HTMLElement, update: NormalizedEmbeddedThemeUpdate): void;
-export declare function getThemeInitScript(defaultTheme?: ThemePreference, enableSystem?: boolean): string;
+export declare function getThemeInitScript(defaultTheme?: ThemePreference, enableSystem?: boolean, appId?: string): string;
 export declare const themeInitScript: string;

package/dist/client/theme.js

@@ -1,4 +1,6 @@
+import { getThemeFamilyInitScript } from "../appearance/theme-family.js";
 import { THEME_VAR_NAMES } from "../extensions/theme.js";
+import { injectedAgentNativeAppId } from "./app-config.js";
 import { getViteDevRecoveryScript, shouldInlineViteDevRecoveryScript, } from "./vite-dev-recovery-script.js";
 export const EMBEDDED_THEME_UPDATE_MESSAGE = "agent-native-theme-update";
 export const EMBEDDED_THEME_CHANGE_EVENT = "agent-native:theme-change";
@@ -60,10 +62,11 @@ function normalizeDefaultTheme(theme) {
     }
     return "system";
 }
-export function getThemeInitScript(defaultTheme = "system", enableSystem = true) {
+export function getThemeInitScript(defaultTheme = "system", enableSystem = true, appId) {
     const safeDefaultTheme = normalizeDefaultTheme(defaultTheme);
     const systemEnabled = enableSystem ? "true" : "false";
-    const themeScript = `(function(){function m(){var d={};return{get length(){return Object.keys(d).length},key:function(i){return Object.keys(d)[i]||null},getItem:function(k){k=String(k);return Object.prototype.hasOwnProperty.call(d,k)?d[k]:null},setItem:function(k,v){d[String(k)]=String(v)},removeItem:function(k){delete d[String(k)]},clear:function(){d={}}}}function s(n){try{var x=window[n],p='__an_storage_probe__';x.setItem(p,'1');x.removeItem(p)}catch(e){try{Object.defineProperty(window,n,{configurable:true,value:m()})}catch(_){}}}s('localStorage');s('sessionStorage');try{var defaultTheme=${JSON.stringify(safeDefaultTheme)};var enableSystem=${systemEnabled};var stored=window.localStorage.getItem('theme');var valid=stored==='light'||stored==='dark'||stored==='system'||stored==='auto';var mode=valid?stored:defaultTheme;if(mode==='auto')mode='system';if(!enableSystem&&mode==='system')mode=defaultTheme==='system'?'light':defaultTheme;if(!valid){window.localStorage.removeItem('theme')}else if(stored!==mode){window.localStorage.setItem('theme',mode)}var prefersDark=enableSystem&&mode==='system'&&window.matchMedia&&window.matchMedia('(prefers-color-scheme: dark)').matches;var resolved=mode==='system'?(prefersDark?'dark':'light'):mode;var root=document.documentElement;root.classList.remove('light','dark');root.classList.add(resolved);root.setAttribute('data-theme',resolved);root.style.colorScheme=resolved;var appearance=window.localStorage.getItem('appearance');var appearanceValid=appearance==='warm'||appearance==='ocean'||appearance==='forest'||appearance==='rose'||appearance==='slate';if(appearanceValid){root.setAttribute('data-appearance',appearance)}else{root.removeAttribute('data-appearance');if(appearance!==null)window.localStorage.removeItem('appearance')}}catch(e){}})();`;
+    const themeFamilyAppId = appId ?? injectedAgentNativeAppId() ?? undefined;
+    const themeScript = `${getThemeFamilyInitScript(themeFamilyAppId)}\n(function(){function m(){var d={};return{get length(){return Object.keys(d).length},key:function(i){return Object.keys(d)[i]||null},getItem:function(k){k=String(k);return Object.prototype.hasOwnProperty.call(d,k)?d[k]:null},setItem:function(k,v){d[String(k)]=String(v)},removeItem:function(k){delete d[k]},clear:function(){d={}}}}function s(n){try{var x=window[n],p='__an_storage_probe__';x.setItem(p,'1');x.removeItem(p)}catch(e){try{Object.defineProperty(window,n,{configurable:true,value:m()})}catch(_){}}}s('localStorage');s('sessionStorage');try{var defaultTheme=${JSON.stringify(safeDefaultTheme)};var enableSystem=${systemEnabled};var stored=window.localStorage.getItem('theme');var valid=stored==='light'||stored==='dark'||stored==='system'||stored==='auto';var mode=valid?stored:defaultTheme;if(mode==='auto')mode='system';if(!enableSystem&&mode==='system')mode=defaultTheme==='system'?'light':defaultTheme;if(!valid){window.localStorage.removeItem('theme')}else if(stored!==mode){window.localStorage.setItem('theme',mode)}var prefersDark=enableSystem&&mode==='system'&&window.matchMedia&&window.matchMedia('(prefers-color-scheme: dark)').matches;var resolved=mode==='system'?(prefersDark?'dark':'light'):mode;var root=document.documentElement;root.classList.remove('light','dark');root.classList.add(resolved);root.setAttribute('data-theme',resolved);root.style.colorScheme=resolved;var appearance=window.localStorage.getItem('appearance');var appearanceValid=appearance==='warm'||appearance==='ocean'||appearance==='forest'||appearance==='rose'||appearance==='slate';if(appearanceValid){root.setAttribute('data-appearance',appearance)}else{root.removeAttribute('data-appearance');if(appearance!==null)window.localStorage.removeItem('appearance')}}catch(e){document.documentElement.setAttribute('data-theme-status','unreadable')}})();`;
     if (!shouldInlineViteDevRecoveryScript())
         return themeScript;
     return `${themeScript}\n${getViteDevRecoveryScript()}`;

package/dist/client/ui/index.d.ts

@@ -2,3 +2,4 @@ export { buildErrorReportTemplate, buildGitHubIssueUrl, type ErrorReportDebugIte
 export { getClientSurface, type ClientSurface } from "../client-surface.js";
 export { applyEmbeddedThemeUpdate, buildEmbeddedThemeUpdate, EMBEDDED_THEME_CHANGE_EVENT, EMBEDDED_THEME_UPDATE_MESSAGE, getThemeInitScript, parseEmbeddedThemeUpdate, themeInitScript, type EmbeddedThemeUpdate, type NormalizedEmbeddedThemeUpdate, type ResolvedTheme, type ThemePreference, } from "../theme.js";
 export { APPEARANCE_PRESETS, applyAppearance, getStoredAppearance, useAppearance, useAppearanceSync, type AppearancePresetId, } from "../appearance.js";
+export { applyThemeFamily, readStoredThemeFamily, THEME_FAMILY_CHANGE_EVENT, useThemeFamily, type StoredThemeFamily, type ThemeFamily, type ThemeFamilyApplyResult, type ThemeFamilyHook, type ThemeFamilyStorageStatus, } from "../theme-family.js";

package/dist/client/ui/index.js

@@ -2,3 +2,4 @@ export { buildErrorReportTemplate, buildGitHubIssueUrl, } from "../error-reporti
 export { getClientSurface } from "../client-surface.js";
 export { applyEmbeddedThemeUpdate, buildEmbeddedThemeUpdate, EMBEDDED_THEME_CHANGE_EVENT, EMBEDDED_THEME_UPDATE_MESSAGE, getThemeInitScript, parseEmbeddedThemeUpdate, themeInitScript, } from "../theme.js";
 export { APPEARANCE_PRESETS, applyAppearance, getStoredAppearance, useAppearance, useAppearanceSync, } from "../appearance.js";
+export { applyThemeFamily, readStoredThemeFamily, THEME_FAMILY_CHANGE_EVENT, useThemeFamily, } from "../theme-family.js";

package/dist/collab/awareness.d.ts

@@ -38,19 +38,19 @@ export declare const postAwareness: import("h3").EventHandlerWithFetch<import("h
     error: string;
     states?: undefined;
 } | {
+    error?: undefined;
     states: {
         clientId: number;
         state: string;
     }[];
-    error?: undefined;
 }>>;
 export declare const getActiveUsers: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
     error: string;
     users?: undefined;
 } | {
+    error?: undefined;
     users: {
         clientId: number;
         lastSeen: number;
     }[];
-    error?: undefined;
 }>>;

package/dist/collab/routes.d.ts

@@ -13,12 +13,12 @@ export declare const getCollabState: import("h3").EventHandlerWithFetch<import("
     };
 }>>;
 export declare const postCollabUpdate: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    ok?: undefined;
     error: string;
+    ok?: undefined;
 } | {
-    error?: undefined;
     liveCopy: "derived" | "not_derived" | "unchanged";
     liveCopyReason?: string;
+    error?: undefined;
     ok: boolean;
 } | {
     error?: undefined;

package/dist/collab/struct-routes.d.ts

@@ -1,6 +1,6 @@
 export declare const postCollabJson: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    ok?: undefined;
     error: string;
+    ok?: undefined;
 } | {
     error?: undefined;
     ok: boolean;