@gjsify/storybook-core 0.36.0 → 0.37.0

package/lib/types/controller.d.ts

@@ -32,10 +32,8 @@ export interface StorySummary {
     controls: unknown[];
 }
 /**
- * The render seams the controller drives — each is a renderer-specific view
- * operation. The breakpoint/fold is NOT here (adapter-owned).
- *
- * @typeParam TInstance the renderer's story-instance type.
+ * The renderer-specific view operations the controller drives. The breakpoint/fold is
+ * adapter-owned and deliberately not among them.
  */
 export interface StorybookView<TInstance> {
     /** Build the category-grouped story list; `onSelect(instance)` selects a story. */
@@ -50,10 +48,8 @@ export interface StorybookView<TInstance> {
     renderControls(rows: Array<ControlRow<unknown>>): void;
 }
 /**
- * Drives a storybook: registers + instantiates modules, groups them, shows a
- * story and wires its controls, and exposes the MCP/devtools control surface.
- *
- * @typeParam TInstance the renderer's story-instance type.
+ * Drives a storybook: registers and instantiates modules, groups them, shows a story and
+ * wires its controls, and exposes the MCP/devtools control surface.
  */
 export declare class StorybookController<TInstance extends StoryInstanceLike> {
     private _registry;

package/lib/types/registry.d.ts

@@ -1,10 +1,6 @@
 /**
- * A story module — a group of related story constructors plus optional
- * module-level decorators wrapping each story's `initialize()`.
- *
- * @typeParam TInstance the renderer's story-instance type (it must expose
- *                      `initialize()`).
- * @typeParam TCtor     the zero-arg constructor producing `TInstance`.
+ * A group of related story constructors plus optional module-level decorators wrapping
+ * each story's `initialize()`.
  */
 export interface StoryModuleLike<TInstance extends {
     initialize(): void;
@@ -16,12 +12,7 @@ export interface StoryModuleLike<TInstance extends {
     /** Decorators applied around every story's `initialize()` in this module. */
     decorators?: Array<(build: () => void, instance: TInstance) => void>;
 }
-/**
- * Collects story modules and instantiates their stories. One per storybook run
- * (no shared singleton).
- *
- * @typeParam TInstance the renderer's story-instance type.
- */
+/** Collects story modules and instantiates their stories. One per storybook run. */
 export declare class StoryRegistry<TInstance extends {
     initialize(): void;
 }> {

package/lib/types/story-view-base.d.ts

@@ -19,11 +19,10 @@ export interface StoryChrome<TNode> {
     setChromeText(title: string, description: string): void;
 }
 /**
- * Base class for a single story's view, parameterised by the renderer's node
- * type. A renderer's story base (`StoryWidget` / `StoryElement` / `StoryView`)
- * extends this, implements {@link createChrome}, and calls {@link initBase} from
- * its own constructor (a base constructor cannot call an abstract method before
- * the subclass's field initialisers have run, so init is explicit).
+ * Base class for a single story's view. A renderer extends it, implements
+ * {@link createChrome} and calls {@link initBase} from its own constructor — init is
+ * explicit because a base constructor cannot call an abstract method before the
+ * subclass's field initialisers have run.
  *
  * @typeParam TNode the renderer's view-node type.
  */
@@ -40,9 +39,8 @@ export declare abstract class StoryViewBase<TNode> {
      */
     protected abstract createChrome(meta: StoryMeta, customRoot?: TNode): StoryChrome<TNode>;
     /**
-     * Initialise the base state + chrome. Call from the subclass constructor
-     * (NOT the base constructor — an abstract `createChrome` must not run before
-     * the subclass's own fields are initialised).
+     * Initialise base state + chrome from the SUBCLASS constructor: an abstract
+     * `createChrome` must not run before the subclass's own fields exist.
      */
     protected initBase(meta: StoryMeta, story: string, customRoot?: TNode): void;
     get meta(): StoryMeta;
@@ -52,9 +50,8 @@ export declare abstract class StoryViewBase<TNode> {
     get root(): TNode;
     set args(value: StoryArgs);
     /**
-     * Notify args listeners. Overridable so a renderer can ALSO fire its own
-     * change signal (e.g. the GTK adapter's GObject `notify('args')`) in the
-     * same path.
+     * Notify args listeners. Overridable so a renderer can fire its own change signal
+     * (the GTK adapter's GObject `notify('args')`) in the same path.
      */
     protected emitArgs(value: StoryArgs): void;
     /** Subscribe to args changes; returns an unsubscribe function. */

package/package.json

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