@hadoku/themes 5.13.8 → 5.13.10

package/dist/index.d.ts

@@ -69,6 +69,7 @@ export type { ThemeName, ThemeFamily } from './theme-types';
 export type { HadokuThemeRootProps } from './HadokuThemeRoot';
 export { themePrefs, ThemePrefsSchema } from './themePrefs';
 export type { ThemePrefs } from './themePrefs';
+export { useSettingsTab } from './settingsTab';
 export { resolvePrefsApiBase, PREFS_API_BASE_GLOBAL } from './prefsApiBase';
 export { THEME_EFFECTS, hasAdvanced, getThemeEffects } from './effects';
 export type { AdvancedEffect, ThemeEffectMap } from './effects';

package/dist/index.js

@@ -151,6 +151,8 @@ export { HadokuThemeProvider, useHadokuTheme, useHadokuThemeOptional } from './t
 export { SunIcon, MoonIcon, StrawberryIcon, WaveIcon, ZapIcon, CoffeeIcon, FlowerIcon, HeartIcon, LeafIcon, LanternIcon } from './ThemeIcons.js';
 // Canonical theme prefs client — was copy-pasted into every child app.
 export { themePrefs, ThemePrefsSchema } from './themePrefs.js';
+// The settings popout's remembered tab, on the same shared row.
+export { useSettingsTab } from './settingsTab.js';
 // Shared by every prefs client in the ecosystem, so a dev/E2E stack can point
 // them all at a local prefs-api with one global instead of mocking the network.
 export { resolvePrefsApiBase, PREFS_API_BASE_GLOBAL } from './prefsApiBase.js';

package/dist/settingsTab.d.ts

@@ -0,0 +1,5 @@
+/**
+ * `[savedTabId, saveTabId]` for the current app. The saved id may name a tab
+ * the app no longer offers; the caller falls back to its default then.
+ */
+export declare function useSettingsTab(): [string | null, (id: string) => void];

package/dist/settingsTab.js

@@ -0,0 +1,51 @@
+/**
+ * The settings popout's remembered tab, per user and per app.
+ *
+ * Stored on the shared 'portfolio' row (themePrefs) under `settingsTabs`, keyed
+ * by the app's path prefix, so cardtable's "Sound" and the task app's "App"
+ * don't overwrite each other. User scope: the tab follows the person, not the
+ * device.
+ *
+ * Read through a subscription taken when this module evaluates, never through
+ * `themePrefs.read()`: every read() with a cached blob kicks a background GET,
+ * and the theme hook has already issued the boot read. Subscribing first means
+ * this sees the cache hydrate and that read's result without asking again.
+ */
+import { useCallback, useSyncExternalStore } from 'react';
+import { themePrefs } from './themePrefs.js';
+let tabs = {};
+const listeners = new Set();
+themePrefs.subscribe((next) => {
+    tabs = next.settingsTabs ?? {};
+    for (const l of listeners)
+        l();
+});
+function subscribe(listener) {
+    listeners.add(listener);
+    return () => {
+        listeners.delete(listener);
+    };
+}
+const getTabs = () => tabs;
+/** The app this page belongs to: its first path segment ('' at the site root). */
+function appScope() {
+    if (typeof window === 'undefined')
+        return '';
+    return window.location.pathname.split('/')[1] ?? '';
+}
+/**
+ * `[savedTabId, saveTabId]` for the current app. The saved id may name a tab
+ * the app no longer offers; the caller falls back to its default then.
+ */
+export function useSettingsTab() {
+    const all = useSyncExternalStore(subscribe, getTabs, getTabs);
+    const scope = appScope();
+    const save = useCallback((id) => {
+        themePrefs
+            .save({ settingsTabs: { ...tabs, [scope]: id } }, { scope: 'user' })
+            .catch((err) => {
+            console.error('[useSettingsTab] prefs save failed', err?.message ?? err);
+        });
+    }, [scope]);
+    return [all[scope] ?? null, save];
+}

package/dist/themePrefs.d.ts

@@ -21,9 +21,11 @@ export declare const ThemePrefsSchema: z.ZodObject<{
         simple: "simple";
         advanced: "advanced";
     }>>;
+    settingsTabs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, z.core.$strip>;
 export type ThemePrefs = z.infer<typeof ThemePrefsSchema>;
 export declare const themePrefs: import("@wolffm/prefs-client").PrefsClient<{
     theme?: string | undefined;
     themeMode?: "simple" | "advanced" | undefined;
+    settingsTabs?: Record<string, string> | undefined;
 }>;

package/dist/themePrefs.js

@@ -29,7 +29,11 @@ import { resolvePrefsApiBase } from './prefsApiBase.js';
 z.config({ jitless: true });
 export const ThemePrefsSchema = z.object({
     theme: z.string().optional(),
-    themeMode: z.enum(['simple', 'advanced']).optional()
+    themeMode: z.enum(['simple', 'advanced']).optional(),
+    // The settings popout's last-open tab, keyed by app (see ./settingsTab). The
+    // popout is platform UI, not an app's, so it shares this row — which the
+    // theme has already read at boot, so remembering the tab costs no request.
+    settingsTabs: z.record(z.string(), z.string()).optional()
 });
 export const themePrefs = createPrefsClient({
     appId: 'portfolio',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hadoku/themes",
-  "version": "5.13.8",
+  "version": "5.13.10",
   "description": "18 beautiful themes with a symmetric, WCAG-verified token set and a complete Tailwind v4 color mapping - Light, Dark, Strawberry, Ocean, Cyberpunk, Coffee, Lavender, Nature, Pink, Izakaya",
   "type": "module",
   "repository": {