kempo-ui 0.0.3 → 0.0.5

package/docs/components/accordion.html

@@ -7,8 +7,10 @@
   <link rel="stylesheet" href="../src/kempo-vars.css" /><link rel="stylesheet" href="../kempo.min.css" />
   <link rel="stylesheet" href="../src/kempo-hljs.css" />`n  <link rel="stylesheet" href="../styles.css" />
   <script type="module">
+    import ShadowComponent from '../src/components/ShadowComponent.js';
     import Import from '../src/components/Import.js';
     import Icon from '../src/components/Icon.js';
+    ShadowComponent.stylesheetPath = '../kempo.min.css';
     Import.replacements.root = '../';
     Icon.pathToIcons = ['../icons'];
   </script>
@@ -28,9 +30,9 @@
         <h6 class="mt">JavaScript Reference</h6>
         <a href="#constructor">Constructor</a><br />
         <a href="#requirements">Requirements</a><br />
-        <a href="#attributes">Attributes</a><br />
         <a href="#properties">Properties</a><br />
         <a href="#methods">Methods</a><br />
+        <a href="#events">Events</a><br />
       </div>
     </details>
 
@@ -79,43 +81,85 @@
     <h2 id="jsRef">JavaScript Reference</h2>
 
     <h3 id="constructor"><a href="#constructor" class="no-link">Constructor</a></h3>
-    <h6>Extends <a href="./component.html">Component</a></h6>
+    <h6>Extends <a href="./component.html">ShadowComponent</a></h6>
     <h5>
       <code>new Accordion()</code><br />
     </h5>
 
     <h3 id="requirements"><a href="#requirements" class="no-link">Requirements</a></h3>
     <ul>
-      <li><a href="../utils/element.html">utils/element.js</a></li>
+      <li><a href="./component.html">ShadowComponent</a></li>
     </ul>
 
-    <h3 id="attributes"><a href="#attributes" class="no-link">Attributes</a></h3>
-    <h5><code>forPanel: string</code></h5>
-    <p>Specifies the panel associated with the header.</p>
-    <h5><code>active: boolean</code></h5>
-    <p>Indicates whether the panel or header is active.</p>
-    <h5><code>transitioning: boolean</code></h5>
-    <p>Indicates whether the panel is in the process of transitioning.</p>
-
     <h3 id="properties"><a href="#properties" class="no-link">Properties</a></h3>
-    <h5><code>activeHeader: HTMLElement</code></h5>
-    <p>Returns the currently active header element.</p>
-    <h5><code>activePanel: HTMLElement</code></h5>
-    <p>Returns the currently active panel element.</p>
+    
+    <h4>Accordion (Main Component)</h4>
+    <h5><code>activeHeader<i>: HTMLElement | null</i></code></h5>
+    <p>Returns the currently active header element, or <code>null</code> if no panel is open.</p>
+    <h5><code>activePanel<i>: HTMLElement | null</i></code></h5>
+    <p>Returns the currently active panel element, or <code>null</code> if no panel is open.</p>
+
+    <h4>AccordionHeader</h4>
+    <h5><code>forPanel<i>: string</i></code></h5>
+    <p>The panel name that this header controls. Syncs with the <code>for-panel</code> attribute.</p>
+    <h5><code>active<i>: boolean</i></code></h5>
+    <p>Whether this header is currently active (its associated panel is open). Syncs with the <code>active</code> attribute.</p>
+    <h5><code>accordion<i>: Accordion | null</i></code></h5>
+    <p>Returns the parent accordion component, or <code>null</code> if not inside an accordion.</p>
+
+    <h4>AccordionPanel</h4>
+    <h5><code>name<i>: string</i></code></h5>
+    <p>Unique identifier for this panel. Must match the <code>for-panel</code> attribute of its associated header. Syncs with the <code>name</code> attribute.</p>
+    <h5><code>active<i>: boolean</i></code></h5>
+    <p>Whether this panel is currently open. Syncs with the <code>active</code> attribute.</p>
+    <h5><code>transitioning<i>: boolean</i></code></h5>
+    <p>Whether this panel is currently animating (opening or closing). Syncs with the <code>transitioning</code> attribute.</p>
+    <h5><code>accordion<i>: Accordion | null</i></code></h5>
+    <p>Returns the parent accordion component, or <code>null</code> if not inside an accordion.</p>
 
     <h3 id="methods"><a href="#methods" class="no-link">Methods</a></h3>
-    <h5><code>getHeader(panelName: string): HTMLElement</code></h5>
-    <p>Returns the header element associated with the specified panel name.</p>
-    <h5><code>getPanel(panelName: string): HTMLElement</code></h5>
-    <p>Returns the panel element associated with the specified panel name.</p>
-    <h5><code>openPanel(panelName: string): void</code></h5>
-    <p>Opens the panel associated with the specified panel name.</p>
-    <h5><code>closePanel(panelName: string): void</code></h5>
-    <p>Closes the panel associated with the specified panel name.</p>
-    <h5><code>togglePanel(panelName: string): void</code></h5>
-    <p>Toggles the panel associated with the specified panel name.</p>
+    
+    <h4>Accordion (Main Component)</h4>
+    <h5><code>getHeader(panelName)<i>: HTMLElement | null</i></code></h5>
+    <p>Returns the header element associated with the specified panel name, or <code>null</code> if not found.</p>
+    <ul>
+      <li><strong>panelName</strong> <code>string</code> - The name of the panel whose header to retrieve</li>
+    </ul>
+
+    <h5><code>getPanel(panelName)<i>: HTMLElement | null</i></code></h5>
+    <p>Returns the panel element with the specified name, or <code>null</code> if not found.</p>
+    <ul>
+      <li><strong>panelName</strong> <code>string</code> - The name of the panel to retrieve</li>
+    </ul>
+
+    <h5><code>openPanel(panelName)<i>: void</i></code></h5>
+    <p>Opens the panel with the specified name. Closes any currently open panel first. Dispatches an <code>openpanel</code> event.</p>
+    <ul>
+      <li><strong>panelName</strong> <code>string</code> - The name of the panel to open</li>
+    </ul>
+
+    <h5><code>closePanel(panelName)<i>: void</i></code></h5>
+    <p>Closes the panel with the specified name. Dispatches a <code>closepanel</code> event.</p>
+    <ul>
+      <li><strong>panelName</strong> <code>string</code> - The name of the panel to close</li>
+    </ul>
+
+    <h5><code>togglePanel(panelName)<i>: void</i></code></h5>
+    <p>Toggles the panel with the specified name (opens if closed, closes if open). Dispatches a <code>togglepanel</code> event.</p>
+    <ul>
+      <li><strong>panelName</strong> <code>string</code> - The name of the panel to toggle</li>
+    </ul>
+
+    <h3 id="events"><a href="#events" class="no-link">Events</a></h3>
+    <h5><code>openpanel</code></h5>
+    <p>Fired when a panel is opened. The event detail contains <code>{ panelName }</code>.</p>
+    <h5><code>closepanel</code></h5>
+    <p>Fired when a panel is closed. The event detail contains <code>{ panelName }</code>.</p>
+    <h5><code>togglepanel</code></h5>
+    <p>Fired when a panel is toggled. The event detail contains <code>{ panelName }</code>.</p>
     
   </main>
+  <div style="height:33vh"></div>
   <script type="module" src="../src/components/Import.js"></script>
   <script type="module" src="../src/components/Accordion.js"></script>
 </body>

package/docs/components/card.html

@@ -7,8 +7,10 @@
   <link rel="stylesheet" href="../src/kempo-vars.css" /><link rel="stylesheet" href="../kempo.min.css" />
   <link rel="stylesheet" href="../src/kempo-hljs.css" />`n  <link rel="stylesheet" href="../styles.css" />
   <script type="module">
+    import ShadowComponent from '../src/components/ShadowComponent.js';
     import Import from '../src/components/Import.js';
     import Icon from '../src/components/Icon.js';
+    ShadowComponent.stylesheetPath = '../kempo.min.css';
     Import.replacements.root = '../';
     Icon.pathToIcons = ['../icons'];
   </script>
@@ -26,7 +28,6 @@
         <h6 class="mt">JavaScript Reference</h6>
         <a href="#constructor">Constructor</a><br />
         <a href="#requirements">Requirements</a><br />
-        <a href="#attributes">Attributes</a><br />
         <a href="#properties">Properties</a><br />
         <a href="#methods">Methods</a><br />
       </div>
@@ -60,7 +61,7 @@
     <h2 id="jsRef">JavaScript Reference</h2>
 
     <h3 id="constructor"><a href="#constructor" class="no-link">Constructor</a></h3>
-    <h6>Extends <a href="./component.html">Component</a></h6>
+    <h6>Extends <a href="./shadow-component.html">ShadowComponent</a></h6>
     <h5>
       <code>new Card()</code><br />
       <code>new Card(<i>string</i> label)</code>
@@ -72,12 +73,12 @@
 
     <h3 id="requirements"><a href="#requirements" class="no-link">Requirements</a></h3>
     <ul>
-      <li><a href="./component.html">Component</a></li>
+      <li><a href="./shadow-component.html">ShadowComponent</a></li>
     </ul>
 
-    <h3 id="attributes"><a href="#attributes" class="no-link">Attributes</a></h3>
+    <h3 id="properties"><a href="#properties" class="no-link">Properties</a></h3>
     <h5><code>label<i>: string</i></code></h5>
-    <p>The label for the card.</p>
+    <p>The label for the card. Syncs with the <code>label</code> attribute.</p>
 
     <h3 id="methods"><a href="#methods" class="no-link">Methods</a></h3>
     <h5><code>setLabel(<i>string</i> label)<i>: void</i></code></h5>

package/docs/components/collapsible.html

@@ -0,0 +1,198 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Collapsible - Components - Kempo Docs - A Web Components Solution</title>
+  <link rel="stylesheet" href="../src/kempo-vars.css" /><link rel="stylesheet" href="../kempo.min.css" />
+  <link rel="stylesheet" href="../src/kempo-hljs.css" />`n  <link rel="stylesheet" href="../styles.css" />
+  <script type="module">
+    import ShadowComponent from '../src/components/ShadowComponent.js';
+    import Import from '../src/components/Import.js';
+    import Icon from '../src/components/Icon.js';
+    ShadowComponent.stylesheetPath = '../kempo.min.css';
+    Import.replacements.root = '../';
+    Icon.pathToIcons = ['../icons'];
+  </script>
+</head>
+<body>
+  <k-import src="../nav.inc.html"></k-import>
+  <h1 class="ta-center">Collapsible</h1>
+  <main>
+    <details class="b r mb">
+      <summary class="p">Table of Contents</summary>
+      <div class="m mt0 pl">
+        <h6>Examples</h6>
+        <a href="#basicUsage">Basic Usage</a><br />
+        <a href="#defaultOpen">Default Open</a><br />
+        <a href="#customLabel">Custom Label</a><br />
+        <a href="#customIcon">Custom Icon</a><br />
+        
+        <h6 class="mt">JavaScript Reference</h6>
+        <a href="#constructor">Constructor</a><br />
+        <a href="#requirements">Requirements</a><br />
+        <a href="#properties">Properties</a><br />
+        <a href="#methods">Methods</a><br />
+        <a href="#events">Events</a><br />
+        <a href="#slots">Slots</a><br />
+      </div>
+    </details>
+
+    <h3>Description</h3>
+    <p>The Collapsible component provides a way to show/hide content with a clickable label header. It features a rotating chevron icon and smooth transitions. The component extends the <a href="./component.html">ShadowComponent</a> class and supports customizable labels and icons through slots.</p>
+
+    <h3 id="basicUsage"><a href="#basicUsage" class="no-link">Basic Usage</a></h3>
+    <p>Use the collapsible component to create expandable content sections. Click the label to toggle the content visibility.</p>
+    
+    <div class="row -mx mb">
+      <div class="col d-span-6 m-span-12 px">
+        <k-card label="HTML">
+          <pre><code class="hljs xml"><span class="hljs-tag">&lt;<span class="hljs-name">k-collapsible</span>&gt;</span>
+  <span class="hljs-tag">&lt;<span class="hljs-name">span</span> <span class="hljs-attr">slot</span>=<span class="hljs-string">"label"</span>&gt;</span>Click to expand<span class="hljs-tag">&lt;/<span class="hljs-name">span</span>&gt;</span>
+  <span class="hljs-tag">&lt;<span class="hljs-name">p</span>&gt;</span>This content can be collapsed or expanded.<span class="hljs-tag">&lt;/<span class="hljs-name">p</span>&gt;</span>
+  <span class="hljs-tag">&lt;<span class="hljs-name">p</span>&gt;</span>Add any content here that you want to show/hide.<span class="hljs-tag">&lt;/<span class="hljs-name">p</span>&gt;</span>
+<span class="hljs-tag">&lt;/<span class="hljs-name">k-collapsible</span>&gt;</span></code></pre>
+        </k-card>
+      </div>
+      <div class="col d-span-6 m-span-12 px">
+        <k-card label="Output">
+          <k-collapsible>
+            <span slot="label">Click to expand</span>
+            <p>This content can be collapsed or expanded.</p>
+            <p>Add any content here that you want to show/hide.</p>
+          </k-collapsible>
+        </k-card>
+      </div>
+    </div>
+
+    <h3 id="defaultOpen"><a href="#defaultOpen" class="no-link">Default Open</a></h3>
+    <p>Set the <code>opened</code> attribute to have the collapsible start in an expanded state.</p>
+    
+    <div class="row -mx mb">
+      <div class="col d-span-6 m-span-12 px">
+        <k-card label="HTML">
+          <pre><code class="hljs xml"><span class="hljs-tag">&lt;<span class="hljs-name">k-collapsible</span> <span class="hljs-attr">opened</span>=<span class="hljs-string">"true"</span>&gt;</span>
+  <span class="hljs-tag">&lt;<span class="hljs-name">span</span> <span class="hljs-attr">slot</span>=<span class="hljs-string">"label"</span>&gt;</span>Already expanded<span class="hljs-tag">&lt;/<span class="hljs-name">span</span>&gt;</span>
+  <span class="hljs-tag">&lt;<span class="hljs-name">p</span>&gt;</span>This collapsible starts in an open state.<span class="hljs-tag">&lt;/<span class="hljs-name">p</span>&gt;</span>
+<span class="hljs-tag">&lt;/<span class="hljs-name">k-collapsible</span>&gt;</span></code></pre>
+        </k-card>
+      </div>
+      <div class="col d-span-6 m-span-12 px">
+        <k-card label="Output">
+          <k-collapsible opened="true">
+            <span slot="label">Already expanded</span>
+            <p>This collapsible starts in an open state.</p>
+          </k-collapsible>
+        </k-card>
+      </div>
+    </div>
+
+    <h3 id="customLabel"><a href="#customLabel" class="no-link">Custom Label</a></h3>
+    <p>You can put any content in the label slot, including formatted text, icons, or even other components.</p>
+    
+    <div class="row -mx mb">
+      <div class="col d-span-6 m-span-12 px">
+        <k-card label="HTML">
+          <pre><code class="hljs xml"><span class="hljs-tag">&lt;<span class="hljs-name">k-collapsible</span>&gt;</span>
+  <span class="hljs-tag">&lt;<span class="hljs-name">div</span> <span class="hljs-attr">slot</span>=<span class="hljs-string">"label"</span>&gt;</span>
+    <span class="hljs-tag">&lt;<span class="hljs-name">strong</span>&gt;</span>Advanced Settings<span class="hljs-tag">&lt;/<span class="hljs-name">strong</span>&gt;</span>
+    <span class="hljs-tag">&lt;<span class="hljs-name">small</span> <span class="hljs-attr">class</span>=<span class="hljs-string">"opacity-50 ml"</span>&gt;</span>(Optional)<span class="hljs-tag">&lt;/<span class="hljs-name">small</span>&gt;</span>
+  <span class="hljs-tag">&lt;/<span class="hljs-name">div</span>&gt;</span>
+  <span class="hljs-tag">&lt;<span class="hljs-name">p</span>&gt;</span>Configure advanced options here.<span class="hljs-tag">&lt;/<span class="hljs-name">p</span>&gt;</span>
+<span class="hljs-tag">&lt;/<span class="hljs-name">k-collapsible</span>&gt;</span></code></pre>
+        </k-card>
+      </div>
+      <div class="col d-span-6 m-span-12 px">
+        <k-card label="Output">
+          <k-collapsible>
+            <div slot="label">
+              <strong>Advanced Settings</strong>
+              <small class="opacity-50 ml">(Optional)</small>
+            </div>
+            <p>Configure advanced options here.</p>
+          </k-collapsible>
+        </k-card>
+      </div>
+    </div>
+
+    <h3 id="customIcon"><a href="#customIcon" class="no-link">Custom Icon</a></h3>
+    <p>Replace the default chevron icon with your own content using the <code>labelIcon</code> slot.</p>
+    
+    <div class="row -mx mb">
+      <div class="col d-span-6 m-span-12 px">
+        <k-card label="HTML">
+          <pre><code class="hljs xml"><span class="hljs-tag">&lt;<span class="hljs-name">k-collapsible</span>&gt;</span>
+  <span class="hljs-tag">&lt;<span class="hljs-name">span</span> <span class="hljs-attr">slot</span>=<span class="hljs-string">"label"</span>&gt;</span>Custom Icon<span class="hljs-tag">&lt;/<span class="hljs-name">span</span>&gt;</span>
+  <span class="hljs-tag">&lt;<span class="hljs-name">span</span> <span class="hljs-attr">slot</span>=<span class="hljs-string">"labelIcon"</span>&gt;</span>▼<span class="hljs-tag">&lt;/<span class="hljs-name">span</span>&gt;</span>
+  <span class="hljs-tag">&lt;<span class="hljs-name">p</span>&gt;</span>Using a custom arrow icon.<span class="hljs-tag">&lt;/<span class="hljs-name">p</span>&gt;</span>
+<span class="hljs-tag">&lt;/<span class="hljs-name">k-collapsible</span>&gt;</span></code></pre>
+        </k-card>
+      </div>
+      <div class="col d-span-6 m-span-12 px">
+        <k-card label="Output">
+          <k-collapsible>
+            <span slot="label">Custom Icon</span>
+            <span slot="labelIcon">▼</span>
+            <p>Using a custom arrow icon.</p>
+          </k-collapsible>
+        </k-card>
+      </div>
+    </div>
+
+    <h2 id="jsRef">JavaScript Reference</h2>
+
+    <h3 id="constructor"><a href="#constructor" class="no-link">Constructor</a></h3>
+    <h6>Extends <a href="./component.html">ShadowComponent</a></h6>
+    <h5>
+      <code>new Collapsible()</code>
+    </h5>
+
+    <h3 id="requirements"><a href="#requirements" class="no-link">Requirements</a></h3>
+    <ul>
+      <li><a href="./component.html">ShadowComponent</a></li>
+      <li><a href="./icon.html">Icon</a></li>
+    </ul>
+
+    <h3 id="properties"><a href="#properties" class="no-link">Properties</a></h3>
+    <h5><code>opened<i>: boolean</i></code></h5>
+    <p>Gets or sets whether the collapsible is currently expanded. Changing this property will trigger the appropriate events and visual state changes. Syncs to <code>opened</code> attribute. Default value is <code>false</code>.</p>
+
+    <h3 id="methods"><a href="#methods" class="no-link">Methods</a></h3>
+    <h5><code>open()<i>: void</i></code></h5>
+    <p>Expands the collapsible to show its content. Sets <code>opened</code> to <code>true</code>.</p>
+
+    <h5><code>close()<i>: void</i></code></h5>
+    <p>Collapses the collapsible to hide its content. Sets <code>opened</code> to <code>false</code>.</p>
+    
+    <h5><code>toggle()<i>: void</i></code></h5>
+    <p>Toggles the collapsible state (expands if collapsed, collapses if expanded). Dispatches an <code>openedtoggled</code> event.</p>
+
+    <h3 id="events"><a href="#events" class="no-link">Events</a></h3>
+    <h5><code>openedchanged</code></h5>
+    <p>Fired when the opened state changes. The event detail contains the string <code>"open"</code> or <code>"close"</code>.</p>
+    
+    <h5><code>open</code></h5>
+    <p>Fired when the collapsible is expanded.</p>
+    
+    <h5><code>close</code></h5>
+    <p>Fired when the collapsible is collapsed.</p>
+    
+    <h5><code>openedtoggled</code></h5>
+    <p>Fired when the <code>toggle()</code> method is called (typically when the label is clicked).</p>
+
+    <h3 id="slots"><a href="#slots" class="no-link">Slots</a></h3>
+    <h5><code>Default Slot</code></h5>
+    <p>The main content area that can be collapsed or expanded.</p>
+    
+    <h5><code>label</code></h5>
+    <p>The clickable label content. This is what users click to toggle the collapsible state.</p>
+    
+    <h5><code>labelIcon</code></h5>
+    <p>Custom content for the toggle icon. Defaults to a right-pointing chevron that rotates when expanded. The icon automatically gets hover effects and rotation animations.</p>
+    
+  </main>
+	<div style="height:33vh"></div>
+  <script type="module" src="../src/components/Import.js"></script> 
+  <script type="module" src="../src/components/Collapsible.js"></script> 
+</body>
+</html>

package/docs/components/content-slider.html

@@ -7,8 +7,10 @@
   <link rel="stylesheet" href="../src/kempo-vars.css" /><link rel="stylesheet" href="../kempo.min.css" />
   <link rel="stylesheet" href="../src/kempo-hljs.css" />`n  <link rel="stylesheet" href="../styles.css" />
   <script type="module">
+    import ShadowComponent from '../src/components/ShadowComponent.js';
     import Import from '../src/components/Import.js';
     import Icon from '../src/components/Icon.js';
+    ShadowComponent.stylesheetPath = '../kempo.min.css';
     Import.replacements.root = '../';
     Icon.pathToIcons = ['../icons'];
   </script>
@@ -31,14 +33,15 @@
         <h6 class="mt">JavaScript Reference</h6>
         <a href="#constructor">Constructor</a><br />
         <a href="#requirements">Requirements</a><br />
-        <a href="#attributes">Attributes</a><br />
         <a href="#properties">Properties</a><br />
         <a href="#methods">Methods</a><br />
+        <a href="#events">Events</a><br />
+        <a href="#slots">Slots</a><br />
       </div>
     </details>
 
     <h3>Description</h3>
-    <p>description</p>
+    <p>The ContentSlider component provides a way to display multiple content slides with navigation controls. Users can navigate through slides using previous/next buttons, keyboard arrows, or programmatically. It extends the <a href="./component.html">ShadowComponent</a> class and supports looping, keyboard controls, and customizable navigation.</p>
 
     <h3 id="basicUsage"><a href="#basicUsage" class="no-link">Basic Usage</a></h3>
     <div class="row -mx">
@@ -141,50 +144,77 @@
     <h2 id="jsRef">JavaScript Refrerence</h2>
 
     <h3 id="constructor"><a href="#constructor" class="no-link">Constructor</a></h3>
-    <h6>Extends <a href="./lazy-component.html">LazyComponent</a></h6>
+    <h6>Extends <a href="./component.html">ShadowComponent</a></h6>
     <h5>
-      <code>new ContentSlider()</code><br />
-      <code>new ContentSlider(<i>&lt;Array>HTMLElement</i> content)</code><br/>
-      <code>new ContentSlider(<i>&lt;Array>HTMLElement</i> content, <i>Object</i> init_attrs)</code>
+      <code>new ContentSlider()</code>
     </h5>
 
-    <h4>Paramters</h4>
-    <h5><code>content<i>: &lt;Array>HTMLElement></i></code></h5>
-    <p>An array of <a href="https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement" target="_blank">HTMLElement</a>s that will be the contents of this slider.</p>
-    <h5><code>init_attrs<i>: Object</i></code></h5>
-    <p>An options object that may contain the initial values of the attributes (see attributes below).</p>
-
     <h3 id="requirements"><a href="#requirements" class="no-link">Requirements</a></h3>
     <ul>
-      <li><a href="">LazyComponent Class</a></li>
-      <li><a href="">elements.js Util</a></li>
+      <li><a href="./component.html">ShadowComponent</a></li>
+      <li><a href="./icon.html">Icon</a></li>
     </ul>
 
-    <h3 id="attributes"><a href="#attributes" class="no-link">Attributes</a></h3>
+    <h3 id="properties"><a href="#properties" class="no-link">Properties</a></h3>
     <h5><code>index<i>: number</i></code></h5>
-    <p>The index of the currently active slide (base <code>0</code>). The default value is <code>0</code>.</p>
+    <p>Gets or sets the current slide index. Automatically validates to stay within bounds. Syncs to <code>index</code> attribute. Default value is <code>0</code>.</p>
 
     <h5><code>controls<i>: boolean</i></code></h5>
-    <p>A boolean that indicates if the control buttons should be shown. The default value is <code>true</code>.</p>
+    <p>Gets or sets whether control buttons are visible. Syncs to <code>controls</code> attribute. Default value is <code>true</code>.</p>
 
     <h5><code>keyboardControls<i>: boolean</i></code></h5>
-    <p>A boolean that indicates if the left and right arrows should be used to control the slider. The default value is <code>true</code>.</p>
+    <p>Gets or sets whether keyboard controls are enabled. Syncs to <code>keyboard-controls</code> attribute. Default value is <code>true</code>.</p>
 
     <h5><code>globalControls<i>: boolean</i></code></h5>
-    <p>A boolean that indicates if the left and right arrows should be used to control the slider even when it is not focused (the listener is on the window). The default value is <code>false</code>.</p>
+    <p>Gets or sets whether global keyboard controls are enabled. Use with caution - recommended only for prominent sliders. Syncs to <code>global-controls</code> attribute. Default value is <code>false</code>.</p>
 
     <h5><code>loop<i>: boolean</i></code></h5>
-    <p>A boolean that indicates index should loop. When true, after the last side it will go back to the first, and when on the first slide the previous slide will be the last. The default value is <code>false</code>.</p>
+    <p>Gets or sets whether the slider loops continuously (after the last slide, go to the first; before the first slide, go to the last). Syncs to <code>loop</code> attribute. Default value is <code>false</code>.</p>
+
+    <h5><code>content<i>: Array&lt;HTMLElement&gt;</i></code></h5>
+    <p>Array of child elements that serve as slides. Automatically updated when the component is connected.</p>
 
     <h3 id="methods"><a href="#methods" class="no-link">Methods</a></h3>
-    <h5><code>previous()<i>: undefined</i></code></h5>
-    <p>Goes to the previous slide.</p>
+    <h5><code>previous()<i>: void</i></code></h5>
+    <p>Navigates to the previous slide. If <code>loop</code> is enabled and currently on the first slide, goes to the last slide. Dispatches a <code>previous</code> event.</p>
 
-    <h5><code>next()<i>: undefined</i></code></h5>
-    <p>Goes to the next slide.</p>
+    <h5><code>next()<i>: void</i></code></h5>
+    <p>Navigates to the next slide. If <code>loop</code> is enabled and currently on the last slide, goes to the first slide. Dispatches a <code>next</code> event.</p>
+    
+    <h5><code>goto(index)<i>: void</i></code></h5>
+    <p>Navigates to the slide at the specified index. Index is automatically validated to stay within bounds. Dispatches a <code>goto</code> event.</p>
+    <ul>
+      <li><strong>index</strong> <code>number</code> - The zero-based index of the slide to navigate to</li>
+    </ul>
+
+    <h3 id="events"><a href="#events" class="no-link">Events</a></h3>
+    <h5><code>change</code></h5>
+    <p>Fired when the active slide changes. The event detail contains <code>{ index }</code>.</p>
+    
+    <h5><code>previous</code></h5>
+    <p>Fired when the previous button is clicked or previous navigation is triggered. The event detail contains <code>{ index }</code> of the target slide.</p>
+    
+    <h5><code>next</code></h5>
+    <p>Fired when the next button is clicked or next navigation is triggered. The event detail contains <code>{ index }</code> of the target slide.</p>
+    
+    <h5><code>goto</code></h5>
+    <p>Fired when programmatic navigation to a specific slide occurs. The event detail contains <code>{ index }</code> of the target slide.</p>
+    
+    <h5><code>keyleft</code></h5>
+    <p>Fired when the left arrow key is pressed (before triggering previous navigation).</p>
+    
+    <h5><code>keyright</code></h5>
+    <p>Fired when the right arrow key is pressed (before triggering next navigation).</p>
+
+    <h3 id="slots"><a href="#slots" class="no-link">Slots</a></h3>
+    <h5><code>Default Slot</code></h5>
+    <p>The main content area where slide elements are placed. Each direct child element becomes a slide.</p>
+    
+    <h5><code>prev</code></h5>
+    <p>Custom content for the previous button. Defaults to a left chevron icon if not provided.</p>
     
-    <h5><code>goto(<i>number<i> index)<i>: undefined</i></code></h5>
-    <p>Goes to the specified slide. If the index is more than the number of slides the last side will be shown. If the index is below 0, the first slide will be shown.</p>
+    <h5><code>next</code></h5>
+    <p>Custom content for the next button. Defaults to a right chevron icon if not provided.</p>
     
   </main>
   <script type="module" src="../src/components/Import.js"></script>