@hachther/akilio-widget 0.6.1 → 0.6.5

package/README.md

@@ -8,9 +8,9 @@ styles do not leak into the surrounding page.
 
 ```tsx
 <AkilioWidget
-  apiBaseUrl="https://app.akilio-ai.com"
-  projectKey="your-project-key"
-  styleIsolation="shadow"
+  apiBaseUrl='https://app.akilio-ai.com'
+  projectKey='your-project-key'
+  styleIsolation='shadow'
 />
 ```
 
@@ -28,8 +28,8 @@ citations, products, and suggestions).
 
 ```tsx
 <AkilioWidget
-  apiBaseUrl="https://app.akilio-ai.com"
-  projectKey="your-project-key"
+  apiBaseUrl='https://app.akilio-ai.com'
+  projectKey='your-project-key'
   streaming
 />
 ```
@@ -105,6 +105,33 @@ Lifecycle events are dispatched on `window`: `akilio:ready`, `akilio:open`,
 `akilio:answer-start`, `akilio:answer-delta`, `akilio:answer-complete`,
 `akilio:error`, and `akilio:reset`.
 
+## Launcher coachmark
+
+The default launcher includes a dependency-free, one-time discovery coachmark.
+It appears after a short delay, never submits or opens the widget automatically,
+and is dismissed when the visitor closes it, opens the widget, or presses
+Escape. Dismissal is stored per project and tour version.
+
+```tsx
+<AkilioWidget
+  enableTour
+  tourDelayMs={3000}
+  tourVersion="v1"
+/>
+```
+
+Standalone attributes are `data-enable-tour`, `data-tour-delay-ms`, and
+`data-tour-version`. Set `enableTour={false}` to disable it. To replay the
+coachmark programmatically, dispatch:
+
+```js
+window.dispatchEvent(new Event('akilio:start-tour'));
+```
+
+The coachmark stays inside the widget’s style boundary, does not darken or block
+the host page, does not steal keyboard focus, and respects reduced-motion
+preferences.
+
 Production React and standalone JavaScript widget for the Akilio backend.
 
 ## Included modes
@@ -365,8 +392,8 @@ When the chat API returns a `commerce` capability, the widget automatically disp
 
 ```tsx
 <AkilioWidget
-  apiBaseUrl="https://api.example.com"
-  projectKey="public-project-key"
+  apiBaseUrl='https://api.example.com'
+  projectKey='public-project-key'
   onProductClick={(product, variant) => {
     console.log('Product selected', product, variant);
   }}
@@ -381,9 +408,9 @@ Use `assistantMode` to pass the optional `assistant_mode` routing hint to the ch
 
 ```tsx
 <AkilioWidget
-  apiBaseUrl="https://api.example.com"
-  projectKey="public-project-key"
-  assistantMode="ecommerce"
+  apiBaseUrl='https://api.example.com'
+  projectKey='public-project-key'
+  assistantMode='ecommerce'
 />
 ```
 

package/dist/AkilioWidget.d.ts

@@ -1,4 +1,4 @@
-import type { AkilioWidgetProps } from './types';
+import { AkilioWidgetProps } from './types';
 /**
  * Public widget boundary. By default the application and its stylesheet are
  * rendered into a ShadowRoot, preventing CSS resets and component rules from