lumina-slides 9.0.0 → 9.0.1

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "9.0.0",
+  "version": "9.0.1",
   "homepage": "https://lumina-slides.web.app/",
   "description": "The interface layer for the agentic era. Turn text to UI with declarative JSON.",
   "type": "module",

package/src/components/site/SiteDocs.vue

@@ -352,12 +352,21 @@ engine.load(myDeckData);</code></pre>
                         <ul>
                             <li><code>theme</code> — Preset name (<code>default</code>, <code>ocean</code>, <code>midnight</code>, <code>forest</code>, <code>cyber</code>, <code>latte</code>, <code>sunset</code>, <code>monochrome</code>) or a <code>ThemeConfig</code> object.</li>
                             <li><code>loop</code> — Loop back to the first slide after the last. Default: <code>false</code>.</li>
-                            <li><code>navigation</code>, <code>keyboard</code>, <code>touch</code> — Enable/disable navigation. Defaults: <code>true</code>.</li>
                             <li><code>selector</code> — Override the mount selector (default from constructor).</li>
                             <li><code>debug</code> — Enable debug logs. Default: <code>false</code>.</li>
                             <li><code>studio</code> — Enable Studio (page builder) mode. Default: <code>false</code>.</li>
                         </ul>
 
+                        <h3>Navigation</h3>
+                        <p>Control how users move between slides (buttons, keyboard, touch):</p>
+                        <ul>
+                            <li><code>navigation</code> — Master switch. If <code>false</code>, prev/next buttons are disabled and keyboard/touch do nothing. Default: <code>true</code>.</li>
+                            <li><code>keyboard</code> — Enable keyboard shortcuts for next/prev. Only applies when <code>navigation</code> is true. Default: <code>true</code>.</li>
+                            <li><code>touch</code> — Enable touch/swipe for next/prev. Only applies when <code>navigation</code> is true. Default: <code>true</code>.</li>
+                            <li><code>ui.showControls</code> — Show or hide the prev/next (and speaker-notes) buttons in the footer. When hidden, keyboard and touch still work if enabled. Default: <code>true</code>.</li>
+                            <li><code>keys</code> — Custom key bindings: <code>keys: { next: ['ArrowRight',' ','Enter'], prev: ['ArrowLeft','Backspace'] }</code>. Use <code>KeyboardEvent.key</code> values. You can override only one side, e.g. <code>keys: { prev: ['Backspace'] }</code> keeps default <code>next</code> and only changes <code>prev</code>.</li>
+                        </ul>
+
                         <h3>elementControl</h3>
                         <p>For reveal-on-demand: <code>elementControl: { defaultVisible: false }</code> makes all elements start hidden. Override per id with <code>meta.initialElementState</code>. See <em>Element Control</em>.</p>
 
@@ -374,11 +383,8 @@ engine.load(myDeckData);</code></pre>
   <span class="text-blue-400">visible</span>: <span class="text-yellow-400">true</span>,
   <span class="text-blue-400">showProgressBar</span>: <span class="text-yellow-400">true</span>,
   <span class="text-blue-400">showSlideCount</span>: <span class="text-yellow-400">true</span>,
-  <span class="text-blue-400">showControls</span>: <span class="text-yellow-400">true</span>   <span class="text-gray-500">// Next/Prev arrows</span>
+  <span class="text-blue-400">showControls</span>: <span class="text-yellow-400">true</span>   <span class="text-gray-500">// Next/Prev + speaker-notes; hide to rely only on keyboard/touch</span>
 }</code></pre>
-
-                        <h3>keys</h3>
-                        <p>Custom key bindings: <code>keys: { next: ['ArrowRight',' '], prev: ['ArrowLeft'] }</code>.</p>
                     </div>
 
                     <!-- EVENTS -->

package/src/core/store.ts

@@ -114,10 +114,14 @@ function deepMerge(target: any, source: any) {
  * @returns A store object containing the reactive state and methods.
  */
 export function createStore(initialOptions: LuminaOptions = {}) {
+    const baseOptions = { ...DEFAULT_OPTIONS, ...initialOptions };
+    if (initialOptions && typeof initialOptions.keys === 'object') {
+        baseOptions.keys = { ...DEFAULT_OPTIONS.keys!, ...initialOptions.keys };
+    }
     const state = reactive<LuminaState>({
         deck: null,
         currentIndex: 0,
-        options: { ...DEFAULT_OPTIONS, ...initialOptions },
+        options: baseOptions,
         isReady: false,
         actionHistory: [],
         elementState: {},

package/src/core/types.ts

@@ -1273,7 +1273,10 @@ export interface ThemeConfig {
 }
 
 /**
- * Custom keyboard shortcuts.
+ * Custom key bindings for next/prev slide navigation.
+ * Values must be `KeyboardEvent.key` strings (e.g. 'ArrowRight', ' ', 'Enter', 'Backspace').
+ * When you pass `keys` in options, it is merged with defaults: you can override only
+ * `next` or only `prev` and the other keeps its default.
  */
 export interface LuminaKeyBindings {
     next: string[];
@@ -1287,7 +1290,8 @@ export interface LuminaUIOptions {
     visible?: boolean;        // Global UI visibility
     showProgressBar?: boolean;
     showSlideCount?: boolean;
-    showControls?: boolean;   // Next/Prev buttons
+    /** Show or hide the prev/next (and speaker-notes) controls in the footer. When hidden, keyboard and touch still work if `navigation` and `keyboard`/`touch` allow. Default: true. */
+    showControls?: boolean;
 }
 
 /**
@@ -1404,11 +1408,11 @@ export interface LuminaOptions {
     selector?: string;
     /** Whether to loop back to the start after the last slide. */
     loop?: boolean;
-    /** Enable/Disable keyboard navigation. */
+    /** Master switch for slide-by-slide navigation. When false, the on-screen prev/next buttons are disabled and keyboard/touch do nothing. When true, keyboard and touch can be toggled via `keyboard` and `touch`; the nav buttons are shown/hidden with `ui.showControls`. Default: true. */
     navigation?: boolean;
-    /** Enable/Disable keyboard shortcuts. */
+    /** Enable or disable keyboard shortcuts for next/prev. Only has effect when `navigation` is true. Default: true. */
     keyboard?: boolean;
-    /** Enable/Disable touch swipe gestures. */
+    /** Enable or disable touch/swipe for next/prev. Only has effect when `navigation` is true. Default: true. */
     touch?: boolean;
     /** Enable debug logs. */
     debug?: boolean;
@@ -1416,7 +1420,7 @@ export interface LuminaOptions {
     theme?: ThemeConfig | string;
     /** UI element toggles. */
     ui?: LuminaUIOptions;
-    /** Custom key bindings. */
+    /** Custom key bindings for next/prev. Example: `keys: { next: ['ArrowRight',' ','Enter'], prev: ['ArrowLeft','Backspace'] }`. Use `KeyboardEvent.key` strings. Merged with defaults at init and in `setOptions`, so you can pass e.g. `keys: { prev: ['Backspace'] }` to change only prev. */
     keys?: LuminaKeyBindings;
     /** Animation settings. */
     animation?: LuminaAnimationOptions;