@gjsify/storybook-core 0.37.0 → 0.38.1

package/lib/esm/index.js

@@ -1 +1 @@
-import{StoryRegistry as e}from"./registry.js";import{StorybookController as t}from"./controller.js";import{bindControl as n}from"./controls.js";import{buildStorybookDevtoolsExtension as r}from"./devtools.js";import{collectStoryModules as i}from"./discover.js";import{StoryViewBase as a}from"./story-view-base.js";export*from"@gjsify/stories";export{e as StoryRegistry,a as StoryViewBase,t as StorybookController,n as bindControl,r as buildStorybookDevtoolsExtension,i as collectStoryModules};
+import{StoryRegistry as e}from"./registry.js";import{StorybookController as t}from"./controller.js";import{bindControl as n}from"./controls.js";import{buildStorybookDevtoolsExtension as r}from"./devtools.js";import{collectStoryModules as i}from"./discover.js";import{StoryViewBase as a}from"./story-view-base.js";import{STORYBOOK_COLOR_SCHEMES as o,StorybookSettings as s}from"./settings.js";export*from"@gjsify/stories";export{o as STORYBOOK_COLOR_SCHEMES,e as StoryRegistry,a as StoryViewBase,t as StorybookController,s as StorybookSettings,n as bindControl,r as buildStorybookDevtoolsExtension,i as collectStoryModules};

package/lib/esm/settings.js

@@ -0,0 +1 @@
+import"./_virtual/_rolldown/runtime.js";const e=[`system`,`light`,`dark`];var StorybookSettings=class{constructor(e=()=>!1){this._colorScheme=`system`,this._accentMode=`system`,this._accent=`blue`,this._listeners=new Set,this._systemDark=e}get colorScheme(){return this._colorScheme}set colorScheme(t){!e.includes(t)||t===this._colorScheme||(this._colorScheme=t,this._notify())}get accentMode(){return this._accentMode}set accentMode(e){e!==this._accentMode&&(this._accentMode=e,this._notify())}get accent(){return this._accent}set accent(e){e!==this._accent&&(this._accent=e,this._notify())}get resolvedAccent(){return this._accentMode===`custom`?this._accent:null}get resolvedDark(){return this._colorScheme===`dark`?!0:this._colorScheme===`light`?!1:this._systemDark()}get state(){return{colorScheme:this._colorScheme,accentMode:this._accentMode,accent:this._accent}}subscribe(e){return this._listeners.add(e),()=>{this._listeners.delete(e)}}systemChanged(){this._colorScheme===`system`&&this._notify()}_notify(){let e=this.state;for(let t of[...this._listeners])try{t(e)}catch{}}};export{e as STORYBOOK_COLOR_SCHEMES,StorybookSettings};

package/lib/types/index.d.ts

@@ -4,4 +4,5 @@ export * from './controls.js';
 export * from './controller.js';
 export * from './discover.js';
 export * from './devtools.js';
+export * from './settings.js';
 export * from '@gjsify/stories';

package/lib/types/settings.d.ts

@@ -0,0 +1,80 @@
+import type { AdwAccentColorName } from '@gjsify/adwaita-core';
+/** What the user picked. `'system'` follows the desktop rather than pinning. */
+export type StorybookColorScheme = 'system' | 'light' | 'dark';
+/** Every colour-scheme choice, in the order a selector should offer them. */
+export declare const STORYBOOK_COLOR_SCHEMES: readonly StorybookColorScheme[];
+/**
+ * Whether the accent is the environment's or the storybook's own.
+ *
+ * `'system'` is the default and it is not a formality: `Adw.StyleManager:accent-color`
+ * is READ-ONLY because the desktop owns the accent, so an app that always
+ * overrode it would ignore the user's choice the moment it started. The override
+ * exists to PREVIEW the other eight, which is a storybook's job and not a
+ * default.
+ */
+export type StorybookAccentMode = 'system' | 'custom';
+/** A snapshot of the appearance settings. */
+export interface StorybookSettingsState {
+    /** The colour-scheme PREFERENCE, not the resolved value. */
+    readonly colorScheme: StorybookColorScheme;
+    /** Whether {@link accent} is applied at all. */
+    readonly accentMode: StorybookAccentMode;
+    /** The accent to override with while {@link accentMode} is `'custom'`. */
+    readonly accent: AdwAccentColorName;
+}
+/** How the renderer answers "is the system currently dark?". */
+export type SystemDarkQuery = () => boolean;
+/**
+ * The storybook's appearance settings, with change notification.
+ *
+ * Deliberately a plain observable rather than the abstract-base-plus-`applyTheme`
+ * shape: a renderer subscribing to changes can apply a scheme AND an accent
+ * through one path, where a template method would need one hook per setting and a
+ * new setting would mean a new abstract member in every target.
+ */
+export declare class StorybookSettings {
+    private _colorScheme;
+    private _accentMode;
+    private _accent;
+    private readonly _listeners;
+    private readonly _systemDark;
+    /**
+     * @param systemDark How to resolve `'system'`. Defaults to "not dark", which
+     *   is what a renderer that cannot see the desktop should report — guessing
+     *   dark would fight a light desktop on every start.
+     */
+    constructor(systemDark?: SystemDarkQuery);
+    get colorScheme(): StorybookColorScheme;
+    set colorScheme(value: StorybookColorScheme);
+    get accentMode(): StorybookAccentMode;
+    set accentMode(value: StorybookAccentMode);
+    /**
+     * The custom accent. Setting it does NOT switch {@link accentMode} on — a
+     * selector left visible-but-disabled still reports which swatch is current,
+     * and flipping the mode as a side effect of that would apply an accent the
+     * user never enabled.
+     */
+    get accent(): AdwAccentColorName;
+    set accent(value: AdwAccentColorName);
+    /** The accent to apply, or `null` to leave the environment's alone. */
+    get resolvedAccent(): AdwAccentColorName | null;
+    /** Whether dark is actually on screen — the preference, resolved. */
+    get resolvedDark(): boolean;
+    get state(): StorybookSettingsState;
+    /**
+     * Subscribe to changes; returns an unsubscribe function.
+     *
+     * Also called when the SYSTEM scheme changes underneath `'system'` — see
+     * {@link systemChanged} — because a renderer applying an accent needs to
+     * recompute the standalone colour when light↔dark flips, not only when the
+     * user picks something.
+     */
+    subscribe(listener: (state: StorybookSettingsState) => void): () => void;
+    /**
+     * Tell the settings the system scheme moved. A no-op unless the preference is
+     * `'system'`, so a renderer can wire it to the platform signal unconditionally
+     * instead of guarding at every call site.
+     */
+    systemChanged(): void;
+    private _notify;
+}

package/lib/types/settings.spec.d.ts

@@ -0,0 +1,2 @@
+declare const _default: () => Promise<void>;
+export default _default;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/storybook-core",
-    "version": "0.37.0",
+    "version": "0.38.1",
     "description": "Renderer-agnostic storybook logic (story base, registry, control binding, controller, discovery, devtools) shared by the GTK, browser and NativeScript storybook renderers",
     "type": "module",
     "module": "lib/esm/index.js",
@@ -40,11 +40,12 @@
         "stories"
     ],
     "dependencies": {
-        "@gjsify/stories": "^0.37.0"
+        "@gjsify/adwaita-core": "^0.38.1",
+        "@gjsify/stories": "^0.38.1"
     },
     "devDependencies": {
-        "@gjsify/cli": "^0.37.0",
-        "@gjsify/unit": "^0.37.0",
+        "@gjsify/cli": "^0.38.1",
+        "@gjsify/unit": "^0.38.1",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },