@gjsify/example-gtk-adwaita-storybook 0.35.0 → 0.37.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gjsify/example-gtk-adwaita-storybook",
-  "version": "0.35.0",
+  "version": "0.37.0",
   "description": "Interactive component browser for Libadwaita widgets — a native Adwaita storybook built on @gjsify/storybook, debuggable over DBus/MCP via @gjsify/devtools",
   "type": "module",
   "main": "dist/gjs.js",
@@ -54,11 +54,11 @@
     "@girs/glib-2.0": "^4.1.0",
     "@girs/gobject-2.0": "^4.1.0",
     "@girs/gtk-4.0": "^4.1.0",
-    "@gjsify/adwaita-web": "^0.35.0",
-    "@gjsify/cli": "^0.35.0",
+    "@gjsify/adwaita-web": "^0.37.0",
+    "@gjsify/cli": "^0.37.0",
     "@gjsify/node-gi": "file:../../../packages/node-gi/node-gi",
-    "@gjsify/storybook": "^0.35.0",
-    "@gjsify/adwaita-storybook": "^0.35.0",
+    "@gjsify/storybook": "^0.37.0",
+    "@gjsify/adwaita-storybook": "^0.37.0",
     "@types/node": "^25.9.2",
     "typescript": "^6.0.3"
   },

package/src/browser/embed.ts

@@ -1,36 +1,27 @@
-// Embeddable browser target — `mount(container)` renders the Adwaita storybook
-// into any DOM element, mirroring the `mount()` contract the DOM showcases
-// expose (e.g. `@gjsify/example-dom-minimalist-browser/browser`). The gjsify
-// website uses it to embed the storybook live in its showcase pages and the
-// home-page slideshow.
+// `mount(container)` renders the storybook into any DOM element, the same contract the DOM showcases
+// expose, which is how the gjsify website embeds it live.
 //
-// The storybook's root is an `<adw-window class="sb-window">`; the website's
-// embed CSS sizes any `adw-window` to fill its slot, so the storybook fills the
-// container the same way the native window fills its toplevel. The renderer is
-// responsive (it collapses to single-pane navigation below 720px, like the
-// native `Adw.Breakpoint`), so it adapts to both the wide doc-page embed and
-// narrow mobile layouts.
+// The root is an `<adw-window>`, and the website's embed CSS sizes any `adw-window` to fill its slot,
+// so the storybook fills its container as the native window fills its toplevel. The renderer
+// collapses to single-pane navigation below 720px, mirroring the native `Adw.Breakpoint`.
 
 import { mountStorybook } from '@gjsify/adwaita-storybook';
 import { stories } from './stories.js';
 
 export interface ShowcaseHandle {
-    /** No-op: the storybook renders no animation, so there's nothing to pause. */
+    /** Inert: the storybook has no rAF loop. Present only for the slideshow's handle contract. */
     pause(): void;
     resume(): void;
     readonly isPaused: boolean;
 }
 
 export interface MountOptions {
-    /** Window title shown in the sidebar header (default "Adwaita Storybook"). */
     title?: string;
 }
 
 export function mount(container: HTMLElement, options?: MountOptions): ShowcaseHandle {
     mountStorybook(container, { title: options?.title ?? 'Adwaita Storybook', stories });
 
-    // The storybook is static (no rAF loop), so pause/resume are inert — they
-    // exist only to satisfy the slideshow's optional ShowcaseHandle contract.
     let paused = false;
     return {
         pause(): void {

package/src/browser/main.ts

@@ -1,14 +1,11 @@
-// Browser entry — mounts the Adwaita storybook as a web app built from
-// @gjsify/adwaita-web custom elements, mirroring the native GTK storybook
-// (launched via `gjsify storybook`). Each *.web.ts story shares its metadata
-// with the GTK *.story.ts twin, so the two targets expose identical controls.
-// They are NOT compared by screenshot — no such harness exists (#1052); the
-// parity that is held is behavioural, via the @gjsify/adwaita-core/conformance
-// vectors both renderer suites assert against.
+// Browser entry, mounting the storybook from @gjsify/adwaita-web custom elements as a mirror of the
+// native GTK one (`gjsify storybook`). Each *.web.ts story shares metadata with its GTK *.story.ts
+// twin, so both targets expose identical controls. Parity is BEHAVIOURAL, asserted by both renderer
+// suites against the @gjsify/adwaita-core/conformance vectors — there is no screenshot harness
+// (#1052).
 //
-// The story list lives in `./stories.ts` so the standalone entry here and the
-// embeddable `mount(container)` (`./embed.ts`, used by the gjsify website) stay
-// in lockstep.
+// The story list is in ./stories.ts so this standalone entry and the embeddable `mount(container)`
+// in ./embed.ts stay in lockstep.
 
 import { mountStorybook } from '@gjsify/adwaita-storybook';
 import { stories } from './stories.js';