@gjsify/storybook-core 0.38.1 → 0.40.0

package/lib/esm/category-order.js

@@ -0,0 +1 @@
+import"./_virtual/_rolldown/runtime.js";const e=[`Overview`,`Presentation`,`Boxed Lists`,`Controls`,`Buttons`,`Layout`,`View Switching`,`Navigation`,`Feedback`];function orderCategories(t){let n=new Map(e.map((e,t)=>[e,t])),r=[...t].filter(e=>n.has(e));r.sort((e,t)=>n.get(e)-n.get(t));let i=t.filter(e=>!n.has(e));return[...r,...i]}export{e as STORYBOOK_CATEGORY_ORDER,orderCategories};

package/lib/esm/controller.js

@@ -1 +1 @@
-import"./_virtual/_rolldown/runtime.js";import{StoryRegistry as e}from"./registry.js";var StorybookController=class{constructor(t,n){this._registry=new e,this._activeStory=null,this._unsubArgs=null,this._view=t,this._buildControls=n}mount(e,t=!0){this._registry.registerStories(e);let n=this._registry.createStoryInstances();if(this._view.renderSidebar(this._groupByCategory(n),e=>this.select(e)),t){let e=this._firstStory();e&&this.select(e)}}select(e){this._view.setPreviewTitle(`${e.meta.title} — ${e.story}`),this._view.showPreview(e),this._view.markSelected(e.meta.title),this._wireControls(e),this._activeStory=e}_wireControls(e){this._unsubArgs&&=(this._unsubArgs(),null);let t=this._buildControls(e),n=t.map(e=>e.refresh);this._view.renderControls(t),this._unsubArgs=e.onArgsChanged(e=>{for(let t of n)t(e)})}_groupByCategory(e){let t=new Map;for(let n of e)for(let e of n.instances??[]){let n=e.meta.title.split(`/`),r=n[0],i=n.length>1?n[1]:e.meta.title;t.has(r)||t.set(r,[]),t.get(r).push({instance:e,name:i||`Unnamed`})}return[...t].map(([e,t])=>({category:e,stories:t}))}get activeStory(){return this._activeStory}listStories(){return this._registry.getStories().flatMap(e=>(e.instances??[]).map(e=>({title:e.meta.title,story:e.story,category:e.meta.title.split(`/`)[0],controls:e.meta.controls??[]})))}openStoryByTitle(e){let t=this._findByTitle(e);return t?(this.select(t),!0):!1}getCurrentStory(){let e=this._activeStory;return e?{title:e.meta.title,story:e.story,args:e.args}:null}setActiveArg(e,t){let n=this._activeStory;return n?(n.setArg(e,t),!0):!1}_findByTitle(e){for(let t of this._registry.getStories())for(let n of t.instances??[])if(n.meta.title===e)return n;return null}_firstStory(){for(let e of this._registry.getStories()){let t=(e.instances??[])[0];if(t)return t}return null}};export{StorybookController};
+import"./_virtual/_rolldown/runtime.js";import{orderCategories as e}from"./category-order.js";import{StoryRegistry as t}from"./registry.js";var StorybookController=class{constructor(e,n){this._registry=new t,this._activeStory=null,this._unsubArgs=null,this._view=e,this._buildControls=n}mount(e,t=!0){this._registry.registerStories(e);let n=this._registry.createStoryInstances(),r=this._groupByCategory(n);if(this._view.renderSidebar(r,e=>this.select(e)),t){let e=r[0]?.stories[0]?.instance??null;e&&this.select(e)}}select(e){this._view.setPreviewTitle(`${e.meta.title} — ${e.story}`),this._view.showPreview(e),this._view.markSelected(e.meta.title),this._wireControls(e),this._activeStory=e}_wireControls(e){this._unsubArgs&&=(this._unsubArgs(),null);let t=this._buildControls(e),n=t.map(e=>e.refresh);this._view.renderControls(t),this._unsubArgs=e.onArgsChanged(e=>{for(let t of n)t(e)})}_groupByCategory(t){let n=new Map;for(let e of t)for(let t of e.instances??[]){let e=t.meta.title.split(`/`),r=e[0],i=e.length>1?e[1]:t.meta.title;n.has(r)||n.set(r,[]),n.get(r).push({instance:t,name:i||`Unnamed`})}return e([...n.keys()]).map(e=>({category:e,stories:n.get(e)}))}get activeStory(){return this._activeStory}listStories(){return this._registry.getStories().flatMap(e=>(e.instances??[]).map(e=>({title:e.meta.title,story:e.story,category:e.meta.title.split(`/`)[0],controls:e.meta.controls??[]})))}openStoryByTitle(e){let t=this._findByTitle(e);return t?(this.select(t),!0):!1}getCurrentStory(){let e=this._activeStory;return e?{title:e.meta.title,story:e.story,args:e.args}:null}setActiveArg(e,t){let n=this._activeStory;return n?(n.setArg(e,t),!0):!1}_findByTitle(e){for(let t of this._registry.getStories())for(let n of t.instances??[])if(n.meta.title===e)return n;return null}};export{StorybookController};

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";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};
+import{STORYBOOK_CATEGORY_ORDER as e,orderCategories as t}from"./category-order.js";import{StoryRegistry as n}from"./registry.js";import{StorybookController as r}from"./controller.js";import{bindControl as i}from"./controls.js";import{buildStorybookDevtoolsExtension as a}from"./devtools.js";import{collectStoryModules as o}from"./discover.js";import{StoryViewBase as s}from"./story-view-base.js";import{STORYBOOK_COLOR_SCHEMES as c,StorybookSettings as l}from"./settings.js";export*from"@gjsify/stories";export{e as STORYBOOK_CATEGORY_ORDER,c as STORYBOOK_COLOR_SCHEMES,n as StoryRegistry,s as StoryViewBase,r as StorybookController,l as StorybookSettings,i as bindControl,a as buildStorybookDevtoolsExtension,o as collectStoryModules,t as orderCategories};

package/lib/types/category-order.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The category order every storybook renders its sidebar in.
+ *
+ * A category NOT listed here still renders — it sorts after every listed one,
+ * keeping discovery order among its peers — because a storybook that drops a
+ * story on an unrecognised prefix would hide work rather than surface it. The
+ * build gate is what makes the omission visible.
+ */
+export declare const STORYBOOK_CATEGORY_ORDER: readonly string[];
+/**
+ * Order `categories` by {@link STORYBOOK_CATEGORY_ORDER}, appending unlisted ones
+ * in the order they arrived.
+ *
+ * Stable by construction: it partitions rather than sorts, so two unlisted
+ * categories keep their discovery order instead of depending on a comparator's
+ * tie-breaking.
+ */
+export declare function orderCategories(categories: readonly string[]): string[];

package/lib/types/category-order.spec.d.ts

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

package/lib/types/controller.d.ts

@@ -65,7 +65,7 @@ export declare class StorybookController<TInstance extends StoryInstanceLike> {
     constructor(view: StorybookView<TInstance>, buildControls: (instance: TInstance) => Array<ControlRow<unknown>>);
     /**
      * Register + instantiate `modules`, render the sidebar, and (when
-     * `openFirst`) select the first story.
+     * `openFirst`) select the story the sidebar lists first.
      */
     mount(modules: StoryModuleLike<TInstance, new () => TInstance>[], openFirst?: boolean): void;
     /** Select + show a story instance, wiring its controls. */
@@ -87,5 +87,4 @@ export declare class StorybookController<TInstance extends StoryInstanceLike> {
     /** Set one arg on the active story — drives the same path as the controls. */
     setActiveArg(name: string, value: StoryArgValue): boolean;
     private _findByTitle;
-    private _firstStory;
 }

package/lib/types/index.d.ts

@@ -2,6 +2,7 @@ export * from './story-view-base.js';
 export * from './registry.js';
 export * from './controls.js';
 export * from './controller.js';
+export * from './category-order.js';
 export * from './discover.js';
 export * from './devtools.js';
 export * from './settings.js';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/storybook-core",
-    "version": "0.38.1",
+    "version": "0.40.0",
     "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,12 +40,12 @@
         "stories"
     ],
     "dependencies": {
-        "@gjsify/adwaita-core": "^0.38.1",
-        "@gjsify/stories": "^0.38.1"
+        "@gjsify/adwaita-core": "^0.40.0",
+        "@gjsify/stories": "^0.40.0"
     },
     "devDependencies": {
-        "@gjsify/cli": "^0.38.1",
-        "@gjsify/unit": "^0.38.1",
+        "@gjsify/cli": "^0.40.0",
+        "@gjsify/unit": "^0.40.0",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },