@nice2dev/ui 1.0.21 → 1.0.23

package/dist/no-code.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./no-code-Bb3QFKdm.cjs");exports.NiceAPIFlow=e.NiceAPIFlow;exports.NiceCodePreview=e.NiceCodePreview;exports.NiceCodeTemplate=e.NiceCodeTemplate;exports.NiceComponentDesigner=e.NiceComponentDesigner;exports.NiceDataMapper=e.NiceDataMapper;exports.NiceEventOrchestrator=e.NiceEventOrchestrator;exports.NiceLowCodeStudio=e.NiceLowCodeStudio;exports.NicePageBuilder=e.NicePageBuilder;exports.NiceStateDesigner=e.NiceStateDesigner;exports.NiceTestBuilder=e.NiceTestBuilder;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./no-code-CHvv1KjZ.cjs");exports.NiceAPIFlow=e.NiceAPIFlow;exports.NiceCodePreview=e.NiceCodePreview;exports.NiceCodeTemplate=e.NiceCodeTemplate;exports.NiceComponentDesigner=e.NiceComponentDesigner;exports.NiceDataMapper=e.NiceDataMapper;exports.NiceEventOrchestrator=e.NiceEventOrchestrator;exports.NiceLowCodeStudio=e.NiceLowCodeStudio;exports.NicePageBuilder=e.NicePageBuilder;exports.NiceStateDesigner=e.NiceStateDesigner;exports.NiceTestBuilder=e.NiceTestBuilder;

package/dist/no-code.d.ts

@@ -1,5 +1,6 @@
 import { default as default_2 } from 'react';
 import { NiceBaseProps } from '@nice2dev/ui-core';
+import { NiceComponentTutorial } from '@nice2dev/ui-core';
 
 declare interface ActionParam {
     id: string;
@@ -447,6 +448,8 @@ export declare interface NiceComponentDesignerProps {
     theme?: 'light' | 'dark';
     /** Additional class name */
     className?: string;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 export declare const NiceDataMapper: default_2.FC<NiceDataMapperProps>;
@@ -503,6 +506,8 @@ export declare interface NiceLowCodeStudioProps {
     onSave?: (design: DesignState) => void;
     /** Additional class name */
     className?: string;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 /**
@@ -533,6 +538,8 @@ export declare interface NicePageBuilderProps {
     previewMode?: 'desktop' | 'tablet' | 'mobile';
     /** Additional class name */
     className?: string;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 export declare const NiceStateDesigner: default_2.FC<NiceStateDesignerProps>;
@@ -545,6 +552,8 @@ export declare interface NiceStateDesignerProps extends NiceBaseProps {
     onStoreChange?: (store: StoreDefinition) => void;
     onExport?: (code: string, format: ExportFormat) => void;
     onSave?: (store: StoreDefinition) => void;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 export declare const NiceTestBuilder: default_2.FC<NiceTestBuilderProps>;
@@ -560,6 +569,8 @@ export declare interface NiceTestBuilderProps extends NiceBaseProps {
     onExport?: (code: string) => void;
     onRun?: (suiteId: string) => void;
     onRunAll?: () => void;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
 }
 
 declare interface PageLayout {

package/dist/no-code.mjs

@@ -1,4 +1,4 @@
-import { N as i, a as s, b as c, c as o, d as r, e as t, f as N, g as d, h as n, i as p } from "./no-code-snLY0d6I.js";
+import { N as i, a as s, b as c, c as o, d as r, e as t, f as N, g as d, h as n, i as p } from "./no-code-CyvddsYt.js";
 export {
   i as NiceAPIFlow,
   s as NiceCodePreview,

package/dist/overlays.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const N=require("./NiceWindow-fcTJOlYf.cjs"),r=require("react/jsx-runtime"),M=require("./core-D0ElqRZA.cjs"),e=require("react"),B=require("react-dom");function Y(){const t=e.useContext(M.lr);return t?.portalTarget?t.portalTarget:typeof document<"u"?document.body:null}const H=({open:t,onClose:s,children:v,title:a,size:g="md",closeOnBackdropClick:l=!0,closeOnEscape:d=!0,disableFocusTrap:u=!1,disableBodyScroll:j=!0,zIndex:_=1e3,className:p,style:P})=>{const w=e.useRef(null);M.Ps(w,t&&!u);const y=Y();e.useEffect(()=>{if(!j&&t){const n=document.body.style.overflow;return document.body.style.overflow="hidden",()=>{document.body.style.overflow=n}}},[t,j]),e.useEffect(()=>{if(!d||!t)return;const n=x=>{x.key==="Escape"&&(x.preventDefault(),s())};return document.addEventListener("keydown",n),()=>document.removeEventListener("keydown",n)},[d,t,s]);const f=e.useCallback(n=>{l&&n.target===n.currentTarget&&s()},[l,s]);if(!t)return null;const i={sm:"nice-modal--sm",md:"nice-modal--md",lg:"nice-modal--lg",xl:"nice-modal--xl",full:"nice-modal--full"}[g];return B.createPortal(r.jsx("div",{className:"nice-modal__overlay",style:{zIndex:_},onClick:f,role:"presentation",children:r.jsx("div",{ref:w,className:`nice-modal ${i} ${p||""}`,role:"dialog","aria-modal":"true","aria-label":a,style:P,tabIndex:-1,children:v})}),y)},W=({children:t,showClose:s=!0,onClose:v,className:a})=>r.jsxs("div",{className:`nice-modal__header ${a||""}`,children:[r.jsx("div",{className:"nice-modal__title",children:t}),s&&v&&r.jsx("button",{type:"button",className:"nice-modal__close",onClick:v,"aria-label":"Close",children:r.jsx("svg",{width:"20",height:"20",viewBox:"0 0 20 20",fill:"none",stroke:"currentColor",strokeWidth:"2",children:r.jsx("path",{d:"M4 4l12 12M4 16L16 4"})})})]}),O=({children:t,className:s})=>r.jsx("div",{className:`nice-modal__body ${s||""}`,children:t}),q=({children:t,className:s})=>r.jsx("div",{className:`nice-modal__footer ${s||""}`,children:t}),K=({open:t,onClose:s,children:v,position:a="right",size:g=320,title:l,closeOnBackdropClick:d=!0,closeOnEscape:u=!0,swipeToClose:j=!0,zIndex:_=1e3,className:p,style:P})=>{const w=e.useRef(null),[y,f]=e.useState(!1),[i,n]=e.useState(0);M.Ps(w,t);const x=Y();e.useEffect(()=>{if(!u||!t)return;const o=k=>{k.key==="Escape"&&(k.preventDefault(),s())};return document.addEventListener("keydown",o),()=>document.removeEventListener("keydown",o)},[u,t,s]);const h=e.useCallback(o=>{let k=0;switch(a){case"left":k=Math.min(0,o.deltaX);break;case"right":k=Math.max(0,o.deltaX);break;case"top":k=Math.min(0,o.deltaY);break;case"bottom":k=Math.max(0,o.deltaY);break}n(k)},[a]),D=e.useCallback(o=>{let $=!1;switch(a){case"left":$=o.deltaX<-100;break;case"right":$=o.deltaX>100;break;case"top":$=o.deltaY<-100;break;case"bottom":$=o.deltaY>100;break}$&&(M.Xr("light"),s()),n(0),f(!1)},[a,s]),{ref:C}=M.ac({enabled:j&&t,onPanStart:()=>f(!0),onPan:h,onPanEnd:D}),E=e.useCallback(o=>{d&&o.target===o.currentTarget&&s()},[d,s]);if(!t)return null;const S=a==="left"||a==="right",L=S?{width:typeof g=="number"?`${g}px`:g}:{height:typeof g=="number"?`${g}px`:g},c=()=>{if(y)return S?`translateX(${i}px)`:`translateY(${i}px)`};return B.createPortal(r.jsxs(r.Fragment,{children:[r.jsx("div",{className:`nice-drawer__overlay ${t?"nice-drawer__overlay--visible":""}`,style:{zIndex:_},onClick:E}),r.jsx("div",{ref:o=>{w.current=o,C.current=o},className:`nice-drawer nice-drawer--${a} ${t?"nice-drawer--open":""} ${p||""}`,style:{...L,zIndex:_+1,transform:c(),transition:y?"none":void 0,...P},role:"dialog","aria-modal":"true","aria-label":l,tabIndex:-1,children:v})]}),x)},F=({open:t,onClose:s,children:v,title:a,showHandle:g=!0,snapPoints:l=[.5,.9],initialSnap:d=0,expandable:u=!0,closeOnBackdropClick:j=!0,closeOnEscape:_=!0,hapticFeedback:p=!0,zIndex:P=1e3,className:w,style:y})=>{const f=e.useRef(null),i=e.useRef(null),[n,x]=e.useState(d),[h,D]=e.useState(!1),[C,E]=e.useState(0),S=e.useRef(0);e.useEffect(()=>{t&&(x(d),E(0))},[t,d]),M.Ps(f,t);const L=Y();e.useEffect(()=>{if(!_||!t)return;const m=b=>{b.key==="Escape"&&(b.preventDefault(),s())};return document.addEventListener("keydown",m),()=>document.removeEventListener("keydown",m)},[_,t,s]),e.useEffect(()=>{if(t){const m=document.body.style.overflow;return document.body.style.overflow="hidden",()=>{document.body.style.overflow=m}}},[t]);const c=e.useCallback(m=>{const b=m.target.closest(".nice-bottom-sheet__handle"),I=i.current,X=!I||I.scrollTop<=0;!b&&!X||(D(!0),S.current=m.touches[0].clientY)},[]),o=e.useCallback(m=>{if(!h)return;const b=m.touches[0].clientY-S.current;(b>0||n<l.length-1)&&E(b)},[h,n,l.length]),k=e.useCallback(()=>{if(!h)return;const m=window.innerHeight;l[n]*m;const b=-C,I=m*.15;b>I&&u&&n<l.length-1?(x(n+1),p&&M.Xr("selection")):b<-I&&(n>0?(x(n-1),p&&M.Xr("selection")):(p&&M.Xr("light"),s())),D(!1),E(0)},[h,C,n,l,u,p,s]),$=e.useCallback(()=>{j&&s()},[j,s]);if(!t)return null;const R=l[n]*100,T=h?C:0;return B.createPortal(r.jsxs(r.Fragment,{children:[r.jsx("div",{className:`nice-bottom-sheet__overlay ${t?"nice-bottom-sheet__overlay--visible":""}`,style:{zIndex:P},onClick:$}),r.jsxs("div",{ref:f,className:`nice-bottom-sheet ${t?"nice-bottom-sheet--open":""} ${w||""}`,style:{zIndex:P+1,height:`${R}vh`,transform:`translateY(${Math.max(0,T)}px)`,transition:h?"none":"transform 0.3s ease-out, height 0.3s ease-out",...y},role:"dialog","aria-modal":"true","aria-label":a,tabIndex:-1,onTouchStart:c,onTouchMove:o,onTouchEnd:k,children:[g&&r.jsx("div",{className:"nice-bottom-sheet__handle","aria-hidden":"true"}),a&&r.jsx("div",{className:"nice-bottom-sheet__title",children:a}),r.jsx("div",{ref:i,className:"nice-bottom-sheet__content",children:v})]})]}),L)},z=({trigger:t,children:s,placement:v="bottom",triggerMode:a="click",open:g,onOpenChange:l,hoverDelay:d=200,offset:u=8,className:j,showArrow:_=!0})=>{const[p,P]=e.useState(!1),w=e.useRef(null),y=e.useRef(null),f=e.useRef(null),i=Y(),n=g!==void 0,x=n?g:p,h=e.useCallback(c=>{n||P(c),l?.(c)},[n,l]);M.$s(y,()=>{a!=="manual"&&x&&h(!1)});const D=e.useCallback(()=>{a==="click"&&h(!x)},[a,x,h]),C=e.useCallback(()=>{a==="hover"&&(f.current&&window.clearTimeout(f.current),f.current=window.setTimeout(()=>h(!0),d))},[a,d,h]),E=e.useCallback(()=>{a==="hover"&&(f.current&&window.clearTimeout(f.current),f.current=window.setTimeout(()=>h(!1),d))},[a,d,h]),[S,L]=e.useState({top:0,left:0});return e.useEffect(()=>{if(!x||!w.current||!y.current)return;const c=w.current.getBoundingClientRect(),o=y.current.getBoundingClientRect(),k=window.innerWidth,$=window.innerHeight;let R=0,T=0;const[m,b="center"]=v.split("-");switch(m){case"top":R=c.top-o.height-u,T=c.left+(c.width-o.width)/2;break;case"bottom":R=c.bottom+u,T=c.left+(c.width-o.width)/2;break;case"left":R=c.top+(c.height-o.height)/2,T=c.left-o.width-u;break;case"right":R=c.top+(c.height-o.height)/2,T=c.right+u;break}m==="top"||m==="bottom"?(b==="start"&&(T=c.left),b==="end"&&(T=c.right-o.width)):(b==="start"&&(R=c.top),b==="end"&&(R=c.bottom-o.height)),T=Math.max(8,Math.min(k-o.width-8,T)),R=Math.max(8,Math.min($-o.height-8,R)),L({top:R,left:T})},[x,v,u]),r.jsxs(r.Fragment,{children:[r.jsx("div",{ref:w,className:"nice-popover__trigger",onClick:D,onMouseEnter:C,onMouseLeave:E,style:{display:"inline-block"},children:t}),x&&B.createPortal(r.jsxs("div",{ref:y,className:`nice-popover nice-popover--${v} ${j||""}`,style:{position:"fixed",top:S.top,left:S.left,zIndex:1100},onMouseEnter:C,onMouseLeave:E,role:"tooltip",children:[_&&r.jsx("div",{className:"nice-popover__arrow"}),r.jsx("div",{className:"nice-popover__content",children:s})]}),i)]})},A=({items:t,children:s,onOpen:v,onClose:a,className:g})=>{const[l,d]=e.useState(!1),[u,j]=e.useState({x:0,y:0}),_=e.useRef(null),p=e.useRef(null),P=Y();M.$s(_,()=>{l&&(d(!1),a?.())});const w=e.useCallback(i=>{i.preventDefault(),j({x:i.clientX,y:i.clientY}),d(!0),v?.()},[v]),y=e.useCallback(i=>{!i.disabled&&i.onClick&&(i.onClick(),d(!1),a?.())},[a]);e.useEffect(()=>{if(!l)return;const i=n=>{n.key==="Escape"&&(d(!1),a?.())};return document.addEventListener("keydown",i),()=>document.removeEventListener("keydown",i)},[l,a]);const f=i=>r.jsx("ul",{className:"nice-context-menu__list",role:"menu",children:i.map(n=>n.divider?r.jsx("li",{className:"nice-context-menu__divider",role:"separator"},n.key):r.jsx("li",{role:"presentation",children:r.jsxs("button",{type:"button",className:`nice-context-menu__item ${n.disabled?"nice-context-menu__item--disabled":""} ${n.danger?"nice-context-menu__item--danger":""}`,role:"menuitem",disabled:n.disabled,onClick:()=>y(n),children:[n.icon&&r.jsx("span",{className:"nice-context-menu__icon",children:n.icon}),r.jsx("span",{className:"nice-context-menu__label",children:n.label})]})},n.key))});return r.jsxs(r.Fragment,{children:[r.jsx("div",{ref:p,onContextMenu:w,style:{display:"contents"},children:s}),l&&B.createPortal(r.jsx("div",{ref:_,className:`nice-context-menu ${g||""}`,style:{position:"fixed",left:u.x,top:u.y,zIndex:1200},role:"menu",children:f(t)}),P)]})};exports.NiceActionSheet=N.NiceActionSheet;exports.NiceBlockUI=N.NiceBlockUI;exports.NiceBox=N.NiceBox;exports.NiceCommandPaletteProvider=N.NiceCommandPaletteProvider;exports.NiceLoadPanel=N.NiceLoadPanel;exports.NicePopover=N.NicePopover;exports.NiceResizable=N.NiceResizable;exports.NiceResponsiveBox=N.NiceResponsiveBox;exports.NiceScrollView=N.NiceScrollView;exports.NiceTutorial=N.NiceTutorial;exports.NiceTutorialProvider=N.NiceTutorialProvider;exports.NiceWindow=N.NiceWindow;exports.NiceWindowManager=N.NiceWindowManager;exports.useCommandPalette=N.useCommandPalette;exports.useRegisterCommands=N.useRegisterCommands;exports.NiceBottomSheet=F;exports.NiceContextMenu=A;exports.NiceDrawer=K;exports.NiceModal=H;exports.NiceModalBody=O;exports.NiceModalFooter=q;exports.NiceModalHeader=W;exports.NiceOverlayPopover=z;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const N=require("./NiceWindow-BEFAUTLp.cjs"),r=require("react/jsx-runtime"),M=require("./core-CZE5v34h.cjs"),e=require("react"),B=require("react-dom");function Y(){const t=e.useContext(M.ur);return t?.portalTarget?t.portalTarget:typeof document<"u"?document.body:null}const H=({open:t,onClose:s,children:v,title:a,size:g="md",closeOnBackdropClick:l=!0,closeOnEscape:d=!0,disableFocusTrap:u=!1,disableBodyScroll:j=!0,zIndex:_=1e3,className:p,style:C})=>{const w=e.useRef(null);M.js(w,t&&!u);const y=Y();e.useEffect(()=>{if(!j&&t){const n=document.body.style.overflow;return document.body.style.overflow="hidden",()=>{document.body.style.overflow=n}}},[t,j]),e.useEffect(()=>{if(!d||!t)return;const n=x=>{x.key==="Escape"&&(x.preventDefault(),s())};return document.addEventListener("keydown",n),()=>document.removeEventListener("keydown",n)},[d,t,s]);const f=e.useCallback(n=>{l&&n.target===n.currentTarget&&s()},[l,s]);if(!t)return null;const i={sm:"nice-modal--sm",md:"nice-modal--md",lg:"nice-modal--lg",xl:"nice-modal--xl",full:"nice-modal--full"}[g];return B.createPortal(r.jsx("div",{className:"nice-modal__overlay",style:{zIndex:_},onClick:f,role:"presentation",children:r.jsx("div",{ref:w,className:`nice-modal ${i} ${p||""}`,role:"dialog","aria-modal":"true","aria-label":a,style:C,tabIndex:-1,children:v})}),y)},W=({children:t,showClose:s=!0,onClose:v,className:a})=>r.jsxs("div",{className:`nice-modal__header ${a||""}`,children:[r.jsx("div",{className:"nice-modal__title",children:t}),s&&v&&r.jsx("button",{type:"button",className:"nice-modal__close",onClick:v,"aria-label":"Close",children:r.jsx("svg",{width:"20",height:"20",viewBox:"0 0 20 20",fill:"none",stroke:"currentColor",strokeWidth:"2",children:r.jsx("path",{d:"M4 4l12 12M4 16L16 4"})})})]}),O=({children:t,className:s})=>r.jsx("div",{className:`nice-modal__body ${s||""}`,children:t}),X=({children:t,className:s})=>r.jsx("div",{className:`nice-modal__footer ${s||""}`,children:t}),K=({open:t,onClose:s,children:v,position:a="right",size:g=320,title:l,closeOnBackdropClick:d=!0,closeOnEscape:u=!0,swipeToClose:j=!0,zIndex:_=1e3,className:p,style:C})=>{const w=e.useRef(null),[y,f]=e.useState(!1),[i,n]=e.useState(0);M.js(w,t);const x=Y();e.useEffect(()=>{if(!u||!t)return;const o=k=>{k.key==="Escape"&&(k.preventDefault(),s())};return document.addEventListener("keydown",o),()=>document.removeEventListener("keydown",o)},[u,t,s]);const h=e.useCallback(o=>{let k=0;switch(a){case"left":k=Math.min(0,o.deltaX);break;case"right":k=Math.max(0,o.deltaX);break;case"top":k=Math.min(0,o.deltaY);break;case"bottom":k=Math.max(0,o.deltaY);break}n(k)},[a]),D=e.useCallback(o=>{let E=!1;switch(a){case"left":E=o.deltaX<-100;break;case"right":E=o.deltaX>100;break;case"top":E=o.deltaY<-100;break;case"bottom":E=o.deltaY>100;break}E&&(M.qr("light"),s()),n(0),f(!1)},[a,s]),{ref:P}=M.fc({enabled:j&&t,onPanStart:()=>f(!0),onPan:h,onPanEnd:D}),$=e.useCallback(o=>{d&&o.target===o.currentTarget&&s()},[d,s]);if(!t)return null;const S=a==="left"||a==="right",L=S?{width:typeof g=="number"?`${g}px`:g}:{height:typeof g=="number"?`${g}px`:g},c=()=>{if(y)return S?`translateX(${i}px)`:`translateY(${i}px)`};return B.createPortal(r.jsxs(r.Fragment,{children:[r.jsx("div",{className:`nice-drawer__overlay ${t?"nice-drawer__overlay--visible":""}`,style:{zIndex:_},onClick:$}),r.jsx("div",{ref:o=>{w.current=o,P.current=o},className:`nice-drawer nice-drawer--${a} ${t?"nice-drawer--open":""} ${p||""}`,style:{...L,zIndex:_+1,transform:c(),transition:y?"none":void 0,...C},role:"dialog","aria-modal":"true","aria-label":l,tabIndex:-1,children:v})]}),x)},V=({open:t,onClose:s,children:v,title:a,showHandle:g=!0,snapPoints:l=[.5,.9],initialSnap:d=0,expandable:u=!0,closeOnBackdropClick:j=!0,closeOnEscape:_=!0,hapticFeedback:p=!0,zIndex:C=1e3,className:w,style:y})=>{const f=e.useRef(null),i=e.useRef(null),[n,x]=e.useState(d),[h,D]=e.useState(!1),[P,$]=e.useState(0),S=e.useRef(0);e.useEffect(()=>{t&&(x(d),$(0))},[t,d]),M.js(f,t);const L=Y();e.useEffect(()=>{if(!_||!t)return;const m=b=>{b.key==="Escape"&&(b.preventDefault(),s())};return document.addEventListener("keydown",m),()=>document.removeEventListener("keydown",m)},[_,t,s]),e.useEffect(()=>{if(t){const m=document.body.style.overflow;return document.body.style.overflow="hidden",()=>{document.body.style.overflow=m}}},[t]);const c=e.useCallback(m=>{const b=m.target.closest(".nice-bottom-sheet__handle"),I=i.current,q=!I||I.scrollTop<=0;!b&&!q||(D(!0),S.current=m.touches[0].clientY)},[]),o=e.useCallback(m=>{if(!h)return;const b=m.touches[0].clientY-S.current;(b>0||n<l.length-1)&&$(b)},[h,n,l.length]),k=e.useCallback(()=>{if(!h)return;const m=window.innerHeight;l[n]*m;const b=-P,I=m*.15;b>I&&u&&n<l.length-1?(x(n+1),p&&M.qr("selection")):b<-I&&(n>0?(x(n-1),p&&M.qr("selection")):(p&&M.qr("light"),s())),D(!1),$(0)},[h,P,n,l,u,p,s]),E=e.useCallback(()=>{j&&s()},[j,s]);if(!t)return null;const R=l[n]*100,T=h?P:0;return B.createPortal(r.jsxs(r.Fragment,{children:[r.jsx("div",{className:`nice-bottom-sheet__overlay ${t?"nice-bottom-sheet__overlay--visible":""}`,style:{zIndex:C},onClick:E}),r.jsxs("div",{ref:f,className:`nice-bottom-sheet ${t?"nice-bottom-sheet--open":""} ${w||""}`,style:{zIndex:C+1,height:`${R}vh`,transform:`translateY(${Math.max(0,T)}px)`,transition:h?"none":"transform 0.3s ease-out, height 0.3s ease-out",...y},role:"dialog","aria-modal":"true","aria-label":a,tabIndex:-1,onTouchStart:c,onTouchMove:o,onTouchEnd:k,children:[g&&r.jsx("div",{className:"nice-bottom-sheet__handle","aria-hidden":"true"}),a&&r.jsx("div",{className:"nice-bottom-sheet__title",children:a}),r.jsx("div",{ref:i,className:"nice-bottom-sheet__content",children:v})]})]}),L)},F=({trigger:t,children:s,placement:v="bottom",triggerMode:a="click",open:g,onOpenChange:l,hoverDelay:d=200,offset:u=8,className:j,showArrow:_=!0})=>{const[p,C]=e.useState(!1),w=e.useRef(null),y=e.useRef(null),f=e.useRef(null),i=Y(),n=g!==void 0,x=n?g:p,h=e.useCallback(c=>{n||C(c),l?.(c)},[n,l]);M.Vs(y,()=>{a!=="manual"&&x&&h(!1)});const D=e.useCallback(()=>{a==="click"&&h(!x)},[a,x,h]),P=e.useCallback(()=>{a==="hover"&&(f.current&&window.clearTimeout(f.current),f.current=window.setTimeout(()=>h(!0),d))},[a,d,h]),$=e.useCallback(()=>{a==="hover"&&(f.current&&window.clearTimeout(f.current),f.current=window.setTimeout(()=>h(!1),d))},[a,d,h]),[S,L]=e.useState({top:0,left:0});return e.useEffect(()=>{if(!x||!w.current||!y.current)return;const c=w.current.getBoundingClientRect(),o=y.current.getBoundingClientRect(),k=window.innerWidth,E=window.innerHeight;let R=0,T=0;const[m,b="center"]=v.split("-");switch(m){case"top":R=c.top-o.height-u,T=c.left+(c.width-o.width)/2;break;case"bottom":R=c.bottom+u,T=c.left+(c.width-o.width)/2;break;case"left":R=c.top+(c.height-o.height)/2,T=c.left-o.width-u;break;case"right":R=c.top+(c.height-o.height)/2,T=c.right+u;break}m==="top"||m==="bottom"?(b==="start"&&(T=c.left),b==="end"&&(T=c.right-o.width)):(b==="start"&&(R=c.top),b==="end"&&(R=c.bottom-o.height)),T=Math.max(8,Math.min(k-o.width-8,T)),R=Math.max(8,Math.min(E-o.height-8,R)),L({top:R,left:T})},[x,v,u]),r.jsxs(r.Fragment,{children:[r.jsx("div",{ref:w,className:"nice-popover__trigger",onClick:D,onMouseEnter:P,onMouseLeave:$,style:{display:"inline-block"},children:t}),x&&B.createPortal(r.jsxs("div",{ref:y,className:`nice-popover nice-popover--${v} ${j||""}`,style:{position:"fixed",top:S.top,left:S.left,zIndex:1100},onMouseEnter:P,onMouseLeave:$,role:"tooltip",children:[_&&r.jsx("div",{className:"nice-popover__arrow"}),r.jsx("div",{className:"nice-popover__content",children:s})]}),i)]})},z=({items:t,children:s,onOpen:v,onClose:a,className:g})=>{const[l,d]=e.useState(!1),[u,j]=e.useState({x:0,y:0}),_=e.useRef(null),p=e.useRef(null),C=Y();M.Vs(_,()=>{l&&(d(!1),a?.())});const w=e.useCallback(i=>{i.preventDefault(),j({x:i.clientX,y:i.clientY}),d(!0),v?.()},[v]),y=e.useCallback(i=>{!i.disabled&&i.onClick&&(i.onClick(),d(!1),a?.())},[a]);e.useEffect(()=>{if(!l)return;const i=n=>{n.key==="Escape"&&(d(!1),a?.())};return document.addEventListener("keydown",i),()=>document.removeEventListener("keydown",i)},[l,a]);const f=i=>r.jsx("ul",{className:"nice-context-menu__list",role:"menu",children:i.map(n=>n.divider?r.jsx("li",{className:"nice-context-menu__divider",role:"separator"},n.key):r.jsx("li",{role:"presentation",children:r.jsxs("button",{type:"button",className:`nice-context-menu__item ${n.disabled?"nice-context-menu__item--disabled":""} ${n.danger?"nice-context-menu__item--danger":""}`,role:"menuitem",disabled:n.disabled,onClick:()=>y(n),children:[n.icon&&r.jsx("span",{className:"nice-context-menu__icon",children:n.icon}),r.jsx("span",{className:"nice-context-menu__label",children:n.label})]})},n.key))});return r.jsxs(r.Fragment,{children:[r.jsx("div",{ref:p,onContextMenu:w,style:{display:"contents"},children:s}),l&&B.createPortal(r.jsx("div",{ref:_,className:`nice-context-menu ${g||""}`,style:{position:"fixed",left:u.x,top:u.y,zIndex:1200},role:"menu",children:f(t)}),C)]})};exports.NiceActionSheet=N.NiceActionSheet;exports.NiceBlockUI=N.NiceBlockUI;exports.NiceBox=N.NiceBox;exports.NiceCommandPaletteProvider=N.NiceCommandPaletteProvider;exports.NiceLoadPanel=N.NiceLoadPanel;exports.NicePopover=N.NicePopover;exports.NiceResizable=N.NiceResizable;exports.NiceResponsiveBox=N.NiceResponsiveBox;exports.NiceScrollView=N.NiceScrollView;exports.NiceTutorial=N.NiceTutorial;exports.NiceTutorialProvider=N.NiceTutorialProvider;exports.NiceWindow=N.NiceWindow;exports.NiceWindowManager=N.NiceWindowManager;exports.useCommandPalette=N.useCommandPalette;exports.useRegisterCommands=N.useRegisterCommands;exports.NiceBottomSheet=V;exports.NiceContextMenu=z;exports.NiceDrawer=K;exports.NiceModal=H;exports.NiceModalBody=O;exports.NiceModalFooter=X;exports.NiceModalHeader=W;exports.NiceOverlayPopover=F;

package/dist/overlays.d.ts

@@ -421,6 +421,14 @@ export declare interface NiceTutorialProps {
         finish?: string;
         skip?: string;
         stepOf?: string;
+        /** Play autoplay button (default "Play"). */
+        play?: string;
+        /** Pause autoplay button (default "Pause"). */
+        pause?: string;
+        /** Aria-label for the speed slider (default "Speed"). */
+        speed?: string;
+        /** Aria-label / tooltip for the tooltip close icon (default "Close"). */
+        close?: string;
     };
     /** Animation duration in ms (default 300) */
     animationDuration?: number;
@@ -428,6 +436,36 @@ export declare interface NiceTutorialProps {
     overlayOpacity?: number;
     /** Z-index for the overlay (default 10000) */
     zIndex?: number;
+    /**
+     * Where the control buttons (skip / prev / next / play) sit.
+     * - `'floating-bottom'` (default): fixed strip at bottom-center of the
+     *   viewport. The buttons never move between steps and never overlap with
+     *   the tooltip body.
+     * - `'inline'`: inside the tooltip footer (legacy behaviour — buttons
+     *   re-position with each step).
+     */
+    buttonsPlacement?: 'floating-bottom' | 'inline';
+    /**
+     * How control buttons render.
+     * - `'icon'` (default): round icon-only buttons.
+     * - `'icon-text'`: icon with the label next to it.
+     * - `'text'`: text label only (legacy).
+     */
+    buttonsDisplay?: 'icon' | 'icon-text' | 'text';
+    /**
+     * Show the PLAY/PAUSE button + progress bar + speed slider. Default `true`.
+     * Disable to hide all autoplay controls.
+     */
+    showAutoplay?: boolean;
+    /** Initial autoplay interval in ms-per-step. Default `5000`. */
+    autoplayInterval?: number;
+    /** Min/max range for the speed slider in ms-per-step. Defaults `{ min: 2000, max: 15000 }`. */
+    autoplaySpeedRange?: {
+        min: number;
+        max: number;
+    };
+    /** Called whenever autoplay state changes. */
+    onAutoplayChange?: (playing: boolean) => void;
 }
 
 export declare const NiceTutorialProvider: default_2.FC<NiceTutorialProviderProps>;

package/dist/overlays.mjs

@@ -1,10 +1,10 @@
-import { N as se, a as de, b as ue, c as he, d as fe, e as me, f as ve, g as ge, h as we, i as be, j as ye, k as pe, l as _e, u as Ne, m as ke } from "./NiceWindow-C677O__r.js";
-import { jsxs as H, Fragment as O, jsx as a } from "react/jsx-runtime";
-import { P as j, X as K, a as z, b as U, l as V } from "./core-BFu5opn6.js";
-import { useRef as E, useState as P, useEffect as Y, useCallback as b, useContext as q } from "react";
-import { createPortal as C } from "react-dom";
-function W() {
-  const e = q(V);
+import { N as se, a as de, b as ue, c as he, d as fe, e as me, f as ve, g as ge, h as we, i as be, j as ye, k as pe, l as _e, u as Ne, m as ke } from "./NiceWindow-5VCSBJrc.js";
+import { jsxs as H, Fragment as K, jsx as a } from "react/jsx-runtime";
+import { j as O, q as W, V, f as z, u as A } from "./core-CT5vpy5U.js";
+import { useRef as E, useState as D, useEffect as Y, useCallback as b, useContext as U } from "react";
+import { createPortal as X } from "react-dom";
+function j() {
+  const e = U(A);
   return e?.portalTarget ? e.portalTarget : typeof document < "u" ? document.body : null;
 }
 const F = ({
@@ -22,8 +22,8 @@ const F = ({
   style: M
 }) => {
   const y = E(null);
-  j(y, e && !d);
-  const p = W();
+  O(y, e && !d);
+  const p = j();
   Y(() => {
     if (!x && e) {
       const t = document.body.style.overflow;
@@ -54,7 +54,7 @@ const F = ({
     xl: "nice-modal--xl",
     full: "nice-modal--full"
   }[v];
-  return C(
+  return X(
     /* @__PURE__ */ a(
       "div",
       {
@@ -112,9 +112,9 @@ const F = ({
   className: k,
   style: M
 }) => {
-  const y = E(null), [p, u] = P(!1), [c, t] = P(0);
-  j(y, e);
-  const g = W();
+  const y = E(null), [p, u] = D(!1), [c, t] = D(0);
+  O(y, e);
+  const g = j();
   Y(() => {
     if (!d || !e)
       return;
@@ -160,15 +160,15 @@ const F = ({
           R = n.deltaY > 100;
           break;
       }
-      R && (K("light"), o()), t(0), u(!1);
+      R && (W("light"), o()), t(0), u(!1);
     },
     [r, o]
-  ), { ref: D } = U({
+  ), { ref: L } = z({
     enabled: x && e,
     onPanStart: () => u(!0),
     onPan: h,
     onPanEnd: S
-  }), L = b(
+  }), P = b(
     (n) => {
       s && n.target === n.currentTarget && o();
     },
@@ -176,29 +176,29 @@ const F = ({
   );
   if (!e)
     return null;
-  const I = r === "left" || r === "right", X = I ? { width: typeof v == "number" ? `${v}px` : v } : { height: typeof v == "number" ? `${v}px` : v }, i = () => {
+  const I = r === "left" || r === "right", B = I ? { width: typeof v == "number" ? `${v}px` : v } : { height: typeof v == "number" ? `${v}px` : v }, i = () => {
     if (p)
       return I ? `translateX(${c}px)` : `translateY(${c}px)`;
   };
-  return C(
-    /* @__PURE__ */ H(O, { children: [
+  return X(
+    /* @__PURE__ */ H(K, { children: [
       /* @__PURE__ */ a(
         "div",
         {
           className: `nice-drawer__overlay ${e ? "nice-drawer__overlay--visible" : ""}`,
           style: { zIndex: N },
-          onClick: L
+          onClick: P
         }
       ),
       /* @__PURE__ */ a(
         "div",
         {
           ref: (n) => {
-            y.current = n, D.current = n;
+            y.current = n, L.current = n;
           },
           className: `nice-drawer nice-drawer--${r} ${e ? "nice-drawer--open" : ""} ${k || ""}`,
           style: {
-            ...X,
+            ...B,
             zIndex: N + 1,
             transform: i(),
             transition: p ? "none" : void 0,
@@ -230,11 +230,11 @@ const F = ({
   className: y,
   style: p
 }) => {
-  const u = E(null), c = E(null), [t, g] = P(s), [h, S] = P(!1), [D, L] = P(0), I = E(0);
+  const u = E(null), c = E(null), [t, g] = D(s), [h, S] = D(!1), [L, P] = D(0), I = E(0);
   Y(() => {
-    e && (g(s), L(0));
-  }, [e, s]), j(u, e);
-  const X = W();
+    e && (g(s), P(0));
+  }, [e, s]), O(u, e);
+  const B = j();
   Y(() => {
     if (!N || !e)
       return;
@@ -251,14 +251,14 @@ const F = ({
     }
   }, [e]);
   const i = b((f) => {
-    const w = f.target.closest(".nice-bottom-sheet__handle"), B = c.current, A = !B || B.scrollTop <= 0;
-    !w && !A || (S(!0), I.current = f.touches[0].clientY);
+    const w = f.target.closest(".nice-bottom-sheet__handle"), C = c.current, q = !C || C.scrollTop <= 0;
+    !w && !q || (S(!0), I.current = f.touches[0].clientY);
   }, []), n = b(
     (f) => {
       if (!h)
         return;
       const w = f.touches[0].clientY - I.current;
-      (w > 0 || t < l.length - 1) && L(w);
+      (w > 0 || t < l.length - 1) && P(w);
     },
     [h, t, l.length]
   ), _ = b(() => {
@@ -266,16 +266,16 @@ const F = ({
       return;
     const f = window.innerHeight;
     l[t] * f;
-    const w = -D, B = f * 0.15;
-    w > B && d && t < l.length - 1 ? (g(t + 1), k && K("selection")) : w < -B && (t > 0 ? (g(t - 1), k && K("selection")) : (k && K("light"), o())), S(!1), L(0);
-  }, [h, D, t, l, d, k, o]), R = b(() => {
+    const w = -L, C = f * 0.15;
+    w > C && d && t < l.length - 1 ? (g(t + 1), k && W("selection")) : w < -C && (t > 0 ? (g(t - 1), k && W("selection")) : (k && W("light"), o())), S(!1), P(0);
+  }, [h, L, t, l, d, k, o]), R = b(() => {
     x && o();
   }, [x, o]);
   if (!e)
     return null;
-  const T = l[t] * 100, $ = h ? D : 0;
-  return C(
-    /* @__PURE__ */ H(O, { children: [
+  const T = l[t] * 100, $ = h ? L : 0;
+  return X(
+    /* @__PURE__ */ H(K, { children: [
       /* @__PURE__ */ a(
         "div",
         {
@@ -311,7 +311,7 @@ const F = ({
         }
       )
     ] }),
-    X
+    B
   );
 }, ae = ({
   trigger: e,
@@ -325,22 +325,22 @@ const F = ({
   className: x,
   showArrow: N = !0
 }) => {
-  const [k, M] = P(!1), y = E(null), p = E(null), u = E(null), c = W(), t = v !== void 0, g = t ? v : k, h = b(
+  const [k, M] = D(!1), y = E(null), p = E(null), u = E(null), c = j(), t = v !== void 0, g = t ? v : k, h = b(
     (i) => {
       t || M(i), l?.(i);
     },
     [t, l]
   );
-  z(p, () => {
+  V(p, () => {
     r !== "manual" && g && h(!1);
   });
   const S = b(() => {
     r === "click" && h(!g);
-  }, [r, g, h]), D = b(() => {
+  }, [r, g, h]), L = b(() => {
     r === "hover" && (u.current && window.clearTimeout(u.current), u.current = window.setTimeout(() => h(!0), s));
-  }, [r, s, h]), L = b(() => {
+  }, [r, s, h]), P = b(() => {
     r === "hover" && (u.current && window.clearTimeout(u.current), u.current = window.setTimeout(() => h(!1), s));
-  }, [r, s, h]), [I, X] = P({ top: 0, left: 0 });
+  }, [r, s, h]), [I, B] = D({ top: 0, left: 0 });
   return Y(() => {
     if (!g || !y.current || !p.current)
       return;
@@ -361,21 +361,21 @@ const F = ({
         T = i.top + (i.height - n.height) / 2, $ = i.right + d;
         break;
     }
-    f === "top" || f === "bottom" ? (w === "start" && ($ = i.left), w === "end" && ($ = i.right - n.width)) : (w === "start" && (T = i.top), w === "end" && (T = i.bottom - n.height)), $ = Math.max(8, Math.min(_ - n.width - 8, $)), T = Math.max(8, Math.min(R - n.height - 8, T)), X({ top: T, left: $ });
-  }, [g, m, d]), /* @__PURE__ */ H(O, { children: [
+    f === "top" || f === "bottom" ? (w === "start" && ($ = i.left), w === "end" && ($ = i.right - n.width)) : (w === "start" && (T = i.top), w === "end" && (T = i.bottom - n.height)), $ = Math.max(8, Math.min(_ - n.width - 8, $)), T = Math.max(8, Math.min(R - n.height - 8, T)), B({ top: T, left: $ });
+  }, [g, m, d]), /* @__PURE__ */ H(K, { children: [
     /* @__PURE__ */ a(
       "div",
       {
         ref: y,
         className: "nice-popover__trigger",
         onClick: S,
-        onMouseEnter: D,
-        onMouseLeave: L,
+        onMouseEnter: L,
+        onMouseLeave: P,
         style: { display: "inline-block" },
         children: e
       }
     ),
-    g && C(
+    g && X(
       /* @__PURE__ */ H(
         "div",
         {
@@ -387,8 +387,8 @@ const F = ({
             left: I.left,
             zIndex: 1100
           },
-          onMouseEnter: D,
-          onMouseLeave: L,
+          onMouseEnter: L,
+          onMouseLeave: P,
           role: "tooltip",
           children: [
             N && /* @__PURE__ */ a("div", { className: "nice-popover__arrow" }),
@@ -406,8 +406,8 @@ const F = ({
   onClose: r,
   className: v
 }) => {
-  const [l, s] = P(!1), [d, x] = P({ x: 0, y: 0 }), N = E(null), k = E(null), M = W();
-  z(N, () => {
+  const [l, s] = D(!1), [d, x] = D({ x: 0, y: 0 }), N = E(null), k = E(null), M = j();
+  V(N, () => {
     l && (s(!1), r?.());
   });
   const y = b(
@@ -443,9 +443,9 @@ const F = ({
       ]
     }
   ) }, t.key)) });
-  return /* @__PURE__ */ H(O, { children: [
+  return /* @__PURE__ */ H(K, { children: [
     /* @__PURE__ */ a("div", { ref: k, onContextMenu: y, style: { display: "contents" }, children: o }),
-    l && C(
+    l && X(
       /* @__PURE__ */ a(
         "div",
         {