lumina-slides 9.0.2 → 9.0.3

package/dist/lumina-slides.js

@@ -10099,7 +10099,7 @@ function jt(t, e, n) {
   if (i != null && typeof i == "object" && typeof i.id == "string")
     return i.id;
   const o = aT(n);
-  return o && ((s = r == null ? void 0 : r.ids) != null && s[o]) ? r.ids[o] : Sg(e, ...n);
+  return o && ((s = r == null ? void 0 : r.ids) != null && s[o]) ? r.ids[o] : (r == null ? void 0 : r.id) != null && r.id !== "" ? `${r.id}-${n.map(String).join("-")}` : Sg(e, ...n);
 }
 const lT = {
   statement: () => [["tag"], ["title"], ["subtitle"]],
@@ -47719,28 +47719,48 @@ class Zee {
     }
     return mw(this.store, this, e);
   }
+  /**
+   * Returns the element at the given path on the current slide. Shorthand for
+   * engine.element(engine.currentSlideIndex, path). Use when you don't need the slide index.
+   *
+   * @param path - Logical path (e.g. "title", "features.0", ["elements", 0, "elements", 1]).
+   * @returns ElementController for that element.
+   *
+   * @example
+   * engine.elementInCurrent("title").show();
+   * engine.elementInCurrent("features.0").animate({ from: { opacity: 0 }, to: { opacity: 1 }, duration: 0.5 });
+   *
+   * @see element
+   * @see elements
+   */
+  elementInCurrent(e) {
+    const n = this.store.state.currentIndex ?? 0;
+    return this.element(n, e);
+  }
   /**
    * Returns all element ids for a slide. Use to discover which ids exist (e.g. for
    * meta.initialElementState, or to iterate and control elements). Each id can be passed to
    * engine.element(id). Uses the same path→id logic as element(slideIndex, path); ids follow
-   * resolveId (explicit id, slide.ids, or elemId(slideIndex, ...path)).
+   * resolveId (explicit id, slide.ids, or slide.id / elemId(slideIndex, ...path) as fallback).
    *
-   * @param slideIndex - Zero-based slide index. If out of range or deck not loaded, returns [].
-   * @returns Array of id strings (e.g. ["s0-slide","s0-tag","s0-title","s0-subtitle"] for a statement slide).
+   * @param slideIndex - Zero-based slide index. Omit to use the current slide. If out of range or deck not loaded, returns [].
+   * @returns Array of id strings (e.g. ["s0-slide","s0-tag","s0-title","s0-subtitle"] or ["intro-slide","intro-tag",...] when slide.id is set).
    *
    * @example
-   * const ids = engine.elements(0);
-   * ids.forEach(id => { if (id.endsWith('-title')) engine.element(id).hide(); });
+   * engine.elements();        // current slide
+   * engine.elements(0);
+   * engine.elements().forEach(id => { if (id.endsWith('-title')) engine.element(id).hide(); });
    *
    * @see element
+   * @see elementInCurrent
    * @see getElementIds
    * @see resolveId
    * @see DeckMeta.initialElementState
    */
   elements(e) {
-    var r;
-    const n = (r = this.store.state.deck) == null ? void 0 : r.slides[e];
-    return n ? Eg(n, e) : [];
+    var i;
+    const n = e ?? this.store.state.currentIndex ?? 0, r = (i = this.store.state.deck) == null ? void 0 : i.slides[n];
+    return r ? Eg(r, n) : [];
   }
   /**
    * Hides all controlled elements of a slide. Use for blank-slide or reset-before-reveal flows.