From 0ae37f26bd5947ea253458f908dafcf5c2de8062 Mon Sep 17 00:00:00 2001
From: Ben Munoz <ben@undoneventures.com>
Date: Sun, 6 Oct 2024 16:22:10 -0400
Subject: [PATCH 1/2] feat: accordion section and accordion toggle button
 component docs

---
 .../zero-core/modules/accordion/components.md | 72 +++++++++++++++++--
 .../stores/use-zero-accordion-store.md        | 35 ---------
 .../components/zero-accordion-section.vue     | 33 ++++++++-
 .../zero-accordion-toggle-button.vue          | 25 ++++++-
 .../stores/use-zero-accordion-store.js        |  2 +-
 5 files changed, 122 insertions(+), 45 deletions(-)
 delete mode 100644 packages/docs/content/zero-core/modules/accordion/stores/use-zero-accordion-store.md

diff --git a/packages/docs/content/zero-core/modules/accordion/components.md b/packages/docs/content/zero-core/modules/accordion/components.md
index 3400fe2..df38026 100644
--- a/packages/docs/content/zero-core/modules/accordion/components.md
+++ b/packages/docs/content/zero-core/modules/accordion/components.md
@@ -2,13 +2,39 @@
 # Zero Accordion Section
 
 
-
+A single accordion section comprised of a header and content that expands and collapses when the header is clicked.
 
 ## Props
 
 | Prop | type | description | values |
 | ---- | ---- | ----------- | ------ |
-| `accordionId` | string |  |  |
+| `accordionId` | string | The ID of this section's parent accordion. |  |
+
+## Computed properties
+
+#### accordion()
+
+
+Returns the parent accordion of this section from the [accordions](/zero-core/modules/accordion/store#accordions) array in the accordion store.
+
+
+ - **returns:** `Object`  
+
+#### active()
+
+
+Returns an array of active sections in this [accordion](/zero-core/modules/accordion/components#zero-accordion). Each section is referenced by a Unique ID set from `instance.uid` where instance is given by the `getCurrentInstance()` composable.
+
+
+ - **returns:** `[number]`  
+
+#### open()
+
+
+Returns the open/expanded state of this section as a boolean; true for open, false for closed.
+
+
+ - **returns:** `boolean`  
 
 ## Slots
 
@@ -17,27 +43,57 @@
 
 **name:** `header`  **scoped:** `false`
 
+
+Header content for each section. This content is wrapped in a clickable div when will toggle the section's expanded state.
+
 #### Content
 
 
 **name:** `content`  **scoped:** `false`
 
+
+Collapsible content for each section. The content slot requires a single root HTML element to animate correctly.
+
 ## Methods
 
 #### toggle()
 
+
+Toggles the expanded state of this section using the accordion store's [toggleAccordionSection](/zero-core/modules/accordion/store#toggleaccordionsection) method.
+
 #### setHeight()
 
-# Zero Accordion Toggle Button
 
+Calculates and sets the height of the accordion section content. Called every time the [open](/zero-core/modules/accordion/components#open) state changes using a watcher.
+
+# Zero Accordion Toggle Button
 
 
+An instance of the [zeroButton](/zero-core/modules/button/components) that expands and collapses all accordion sections of its associated accordion at once.
 
 ## Props
 
 | Prop | type | description | values |
 | ---- | ---- | ----------- | ------ |
-| `accordionId` | string |  |  |
+| `accordionId` | string | The ID of the target accordion for this component. |  |
+
+## Computed properties
+
+#### accordion()
+
+
+Returns the accordion associated with this component from the [accordions](/zero-core/modules/accordion/store#accordions) array in the accordion store.
+
+
+ - **returns:** `Object`  
+
+#### allSectionsOpen()
+
+
+A boolean indicating if all the sections belonging to this component's accordion are open or not. True if all are open, false if otherwise.
+
+
+ - **returns:** `boolean`  
 
 ## Slots
 
@@ -46,14 +102,20 @@
 
 **name:** `default`  **scoped:** `true`
 
+
+Button content
+
 | binding | type | description |
 | ------- | ---- | ----------- |
-| `all-sections-open` |  |  |
+| `all-sections-open` | `mixed` | Binds the [allSectionsOpen](/zero-core/modules/accordion/components#allsectionsopen) computed prop to the slot. |
 
 ## Methods
 
 #### toggleAllAccordionSections()
 
+
+Called when the button is clicked. This method subsequently calls the [toggleAllSections](/zero-core/modules/accordion/store#toggleallsections) method from the accordion store. Sets the [zeroButton](/zero-core/modules/button/components) component instance to loading: `false`.
+
 # Zero Accordion
 
 
diff --git a/packages/docs/content/zero-core/modules/accordion/stores/use-zero-accordion-store.md b/packages/docs/content/zero-core/modules/accordion/stores/use-zero-accordion-store.md
deleted file mode 100644
index 589fa7f..0000000
--- a/packages/docs/content/zero-core/modules/accordion/stores/use-zero-accordion-store.md
+++ /dev/null
@@ -1,35 +0,0 @@
-## Functions
-
-<dl>
-<dt><a href="#setAccordion">setAccordion()</a></dt>
-<dd></dd>
-<dt><a href="#removeAccordion">removeAccordion()</a></dt>
-<dd></dd>
-<dt><a href="#setAccordionSection">setAccordionSection()</a></dt>
-<dd></dd>
-<dt><a href="#toggleAccordionSection">toggleAccordionSection()</a></dt>
-<dd></dd>
-<dt><a href="#toggleAllSections">toggleAllSections()</a></dt>
-<dd></dd>
-</dl>
-
-<a name="setAccordion"></a>
-
-## setAccordion()
-**Kind**: global function  
-<a name="removeAccordion"></a>
-
-## removeAccordion()
-**Kind**: global function  
-<a name="setAccordionSection"></a>
-
-## setAccordionSection()
-**Kind**: global function  
-<a name="toggleAccordionSection"></a>
-
-## toggleAccordionSection()
-**Kind**: global function  
-<a name="toggleAllSections"></a>
-
-## toggleAllSections()
-**Kind**: global function  
diff --git a/packages/zero-core/modules/accordion/components/zero-accordion-section.vue b/packages/zero-core/modules/accordion/components/zero-accordion-section.vue
index 4c4bb7a..0c54b73 100644
--- a/packages/zero-core/modules/accordion/components/zero-accordion-section.vue
+++ b/packages/zero-core/modules/accordion/components/zero-accordion-section.vue
@@ -8,13 +8,13 @@
       :class="['accordion-header', { open }]"
       @click="toggleSection"
       @keydown.enter="toggleSection">
-
+      <!-- @slot Header content for each section. This content is wrapped in a clickable div when will toggle the section's expanded state. -->
       <slot name="header" />
 
     </div>
 
     <div ref="content" :class="['accordion-content-wrapper', { open }]" :style="{ height }">
-      <!-- content slot requires a single root HTML element to animate correctly -->
+      <!-- @slot Collapsible content for each section. The content slot requires a single root HTML element to animate correctly. -->
       <slot name="content" />
     </div>
 
@@ -22,11 +22,17 @@
 </template>
 
 <script setup>
+/**
+ * @description A single accordion section comprised of a header and content that expands and collapses when the header is clicked.
+ */
 // ===================================================================== Imports
 import { storeToRefs } from 'pinia'
 
 // ======================================================================= Props
 const props = defineProps({
+  /**
+   * The ID of this section's parent accordion.
+   */
   accordionId: {
     type: String,
     required: true
@@ -34,7 +40,7 @@ const props = defineProps({
 })
 
 // ======================================================================= Setup
-const instance  = getCurrentInstance()
+const instance = getCurrentInstance()
 const accordionStore = useZeroAccordionStore()
 
 // ======================================================================== Data
@@ -47,9 +53,28 @@ const resize = ref(false)
 const resizeObserver = ref(false)
 
 // ==================================================================== Computed
+/**
+ * @method accordion
+ * @computed
+ * @desc Returns the parent accordion of this section from the [accordions](/zero-core/modules/accordion/store#accordions) array in the accordion store.
+ * @returns {Object}
+ */
 const accordion = computed(() => accordions.value[props.accordionId])
+
+/**
+ * @method active
+ * @computed
+ * @desc Returns an array of active sections in this [accordion](/zero-core/modules/accordion/components#zero-accordion). Each section is referenced by a Unique ID set from `instance.uid` where instance is given by the `getCurrentInstance()` composable.
+ * @returns {[number]}
+ */
 const active = computed(() => accordion.value ? accordion.value.active : false)
 
+/**
+ * @method open
+ * @computed
+ * @desc Returns the open/expanded state of this section as a boolean; true for open, false for closed.
+ * @returns {boolean}
+ */
 const open = computed(() => {
   if (Array.isArray(active.value)) {
     return active.value.includes(sectionId.value)
@@ -81,6 +106,7 @@ onBeforeUnmount(() => {
 // ===================================================================== Methods
 /**
  * @method toggle
+ * @desc Toggles the expanded state of this section using the accordion store's [toggleAccordionSection](/zero-core/modules/accordion/store#toggleaccordionsection) method.
  */
 const toggleSection = () => {
   accordionStore.toggleAccordionSection(props.accordionId, sectionId.value)
@@ -88,6 +114,7 @@ const toggleSection = () => {
 
 /**
  * @method setHeight
+ * @desc Calculates and sets the height of the accordion section content. Called every time the [open](/zero-core/modules/accordion/components#open) state changes using a watcher.
  */
 const setHeight = () => {
   if (open.value) {
diff --git a/packages/zero-core/modules/accordion/components/zero-accordion-toggle-button.vue b/packages/zero-core/modules/accordion/components/zero-accordion-toggle-button.vue
index 8cf10aa..7bcddec 100644
--- a/packages/zero-core/modules/accordion/components/zero-accordion-toggle-button.vue
+++ b/packages/zero-core/modules/accordion/components/zero-accordion-toggle-button.vue
@@ -3,18 +3,27 @@
     class="toggle-accordion-button"
     :loader="id"
     @clicked="toggleAllAccordionSections(accordionId)">
-
+    <!--
+      @slot Button content
+        @binding all-sections-open Binds the [allSectionsOpen](/zero-core/modules/accordion/components#allsectionsopen) computed prop to the slot.
+    -->
     <slot :all-sections-open="allSectionsOpen" />
 
   </ZeroButton>
 </template>
 
 <script setup>
+/**
+ * @description An instance of the [zeroButton](/zero-core/modules/button/components) that expands and collapses all accordion sections of its associated accordion at once.
+ */
 // ===================================================================== Imports
 import { storeToRefs } from 'pinia'
 
 // ======================================================================= Props
 const props = defineProps({
+  /**
+   * The ID of the target accordion for this component.
+   */
   accordionId: {
     type: String,
     required: true
@@ -30,12 +39,26 @@ const id = `${props.accordionId}Toggle`
 const { accordions } = storeToRefs(accordionStore)
 
 // ==================================================================== Computed
+/**
+ * @method accordion
+ * @computed
+ * @desc Returns the accordion associated with this component from the [accordions](/zero-core/modules/accordion/store#accordions) array in the accordion store.
+ * @returns {Object}
+ */
 const accordion = computed(() => accordions.value[props.accordionId])
+
+/**
+ * @method allSectionsOpen
+ * @computed
+ * @desc A boolean indicating if all the sections belonging to this component's accordion are open or not. True if all are open, false if otherwise.
+ * @returns {boolean}
+ */
 const allSectionsOpen = computed(() => accordion.value ? accordion.value.allSectionsOpen : false)
 
 // ===================================================================== Methods
 /**
  * @method toggleAllAccordionSections
+ * @desc Called when the button is clicked. This method subsequently calls the [toggleAllSections](/zero-core/modules/accordion/store#toggleallsections) method from the accordion store. Sets the [zeroButton](/zero-core/modules/button/components) component instance to loading: `false`.
  */
 const toggleAllAccordionSections = (accordionId) => {
   accordionStore.toggleAllSections(accordionId)
diff --git a/packages/zero-core/modules/accordion/stores/use-zero-accordion-store.js b/packages/zero-core/modules/accordion/stores/use-zero-accordion-store.js
index 2742274..7d67c5c 100644
--- a/packages/zero-core/modules/accordion/stores/use-zero-accordion-store.js
+++ b/packages/zero-core/modules/accordion/stores/use-zero-accordion-store.js
@@ -54,7 +54,7 @@ export const useZeroAccordionStore = defineStore('zero-accordion', () => {
       if(index === -1) {
         accordions.value[accordionId].active.push(sectionId)
       } else {
-        accordions.value[accordionId].active = accordions.value[accordionId].active.toSpliced(index, 1)
+        accordions.value[accordionId].active = accordions.value[accordionId].active.filter((_, i) => i !== index)
       }
     }
     if (active.length === accordions.value[accordionId].children.length) {

From e5b40bcdd4054af2e47ce313ea166cead365c4cc Mon Sep 17 00:00:00 2001
From: Ben Munoz <ben@undoneventures.com>
Date: Mon, 7 Oct 2024 10:23:42 -0400
Subject: [PATCH 2/2] feat: accordion component and store docs

---
 .../zero-core/modules/accordion/components.md |  18 ++-
 .../zero-core/modules/accordion/store.md      | 113 ++++++++++++++++++
 .../accordion/components/zero-accordion.vue   |  16 +++
 .../stores/use-zero-accordion-store.js        |  29 ++++-
 4 files changed, 171 insertions(+), 5 deletions(-)

diff --git a/packages/docs/content/zero-core/modules/accordion/components.md b/packages/docs/content/zero-core/modules/accordion/components.md
index df38026..9d5067c 100644
--- a/packages/docs/content/zero-core/modules/accordion/components.md
+++ b/packages/docs/content/zero-core/modules/accordion/components.md
@@ -119,15 +119,17 @@ Called when the button is clicked. This method subsequently calls the [toggleAll
 # Zero Accordion
 
 
+A component with child sections that can be toggled to expand and collapse. This component is relatively simple, consisting of a slot for multiple [zeroAccordionSection](/zero-core/modules/accordion/components#zero-accordion-section) components.
 
+In the `onBeforeMount` hook of this component, an instance tracking object is set in the accordion store using the store's [setAccordion](/zero-core/modules/accordion/store#setaccordion) method. When the component is mounted, if the `toggleOnLoad` and `multiple` props are set to true, the [toggleAllSections](/zero-core/modules/accordion/store#toggleallsections) method of the accordion store will be called for this accordion instance.
 
 ## Props
 
 | Prop | type | description | values |
 | ---- | ---- | ----------- | ------ |
-| `accordionId` | string |  |  |
-| `multiple`<span>(optional)</span> | boolean |  |  |
-| `toggleOnLoad`<span>(optional)</span> | boolean |  |  |
+| `accordionId` | string | A unique identifier for this accordion instance. This same prop is present in all children components and its value should match those of its children. |  |
+| `multiple`<span>(optional)</span> | boolean | A boolean indicating whether or not multiple accordion sections can be expanded at the same time. `true` if so, `false` indicates expanded section states are mutually exclusive. |  |
+| `toggleOnLoad`<span>(optional)</span> | boolean | A boolean indicating whether or not all accordion sections should be expanded upon mounting the component. **If `multiple` is set to false, this setting has no effect.** |  |
 
 ## Slots
 
@@ -136,6 +138,16 @@ Called when the button is clicked. This method subsequently calls the [toggleAll
 
 **name:** `default`  **scoped:** `false`
 
+
+[zeroAccordionSections](/zero-core/modules/accordion/components#zero-accordion-section) should be added to this slot
+
 ## Methods
 
 #### handleKeyboardNavigation()
+
+
+The keyboard event handler that is called on window `keydown` events. Used to navigate the accordion with the keyboard. It will call the accordion store's [toggleAllSections](/zero-core/modules/accordion/store#toggleallsections) method if the 'f' and meta keys are pressed.
+
+| param | type | description |
+| ----- | ---- | ----------- |
+| `e` | Object | The [KeyboardEvent](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent) object. |
diff --git a/packages/docs/content/zero-core/modules/accordion/store.md b/packages/docs/content/zero-core/modules/accordion/store.md
index 8b13789..e06ddd9 100644
--- a/packages/docs/content/zero-core/modules/accordion/store.md
+++ b/packages/docs/content/zero-core/modules/accordion/store.md
@@ -1 +1,114 @@
 
+# useZeroAccordionStore()
+
+
+A store for tracking [accordion](/zero-core/modules/accordion/components#zero-accordion) instances and their expanded/collapsed [section](/zero-core/modules/accordion/components#zero-accordion-section) states.
+
+## Data
+
+
+ - [accordions](#accordions)
+
+## Methods
+
+
+ - [setAccordion()](#setaccordion)
+ - [removeAccordion()](#removeaccordion)
+ - [setAccordionSection()](#setaccordionsection)
+ - [toggleAccordionSection()](#toggleaccordionsection)
+ - [toggleAllSections()](#toggleallsections)
+
+## All Members 
+
+#### accordions
+
+
+**type:** `Object`
+
+
+An object containing nested objects representing individual accordion instances. Each nested object exists at the root level of this object, has a key corresponding to its accordionId and should be of the following structure:
+
+```js
+
+{
+
+  accordionId: string,
+
+  multiple: boolean,
+
+  id: string,
+
+  children: Array,
+
+  active: Array|boolean,
+
+  allSectionsOpen: boolean
+
+}
+
+```
+
+
+**Kind:** inner ref of [useZeroAccordionStore](#usezeroaccordionstore)
+
+#### setAccordion()
+
+
+Adds an accordion instance tracking object to the [accordions object](/zero-core/modules/accordion/store#accordions) above.
+
+
+**Kind:** inner method of [useZeroAccordionStore](#usezeroaccordionstore)
+
+| param | type | description |
+| ----- | ---- | ----------- |
+| `payload` | Object | The tracking object. Should have the structure defined in the [accordions object](/zero-core/modules/accordion/store#accordions) above. |
+
+#### removeAccordion()
+
+
+Removes an accordion tracking object from the accordions state above.
+
+
+**Kind:** inner method of [useZeroAccordionStore](#usezeroaccordionstore)
+
+| param | type | description |
+| ----- | ---- | ----------- |
+| `accordionId` | string | The ID of the accordion to remove. |
+
+#### setAccordionSection()
+
+
+Adds a section to be tracked to the accordion tracking object in the accordions state above. This method pushes the section ID to the `children` array in the tracking above.
+
+
+**Kind:** inner method of [useZeroAccordionStore](#usezeroaccordionstore)
+
+| param | type | description |
+| ----- | ---- | ----------- |
+| `accordionId` | string | The ID of the accordion to add the section to. |
+| `sectionId` | string | The ID of the section. |
+
+#### toggleAccordionSection()
+
+
+Toggles the expanded/collapsed state of an accordion section. If the toggle results in all sections of the accordion in question being set to expanded, the `allSectionsOpen` boolean in the accordion tracking object will be set to `true`. Otherwise, it is set to `false`.
+
+
+**Kind:** inner method of [useZeroAccordionStore](#usezeroaccordionstore)
+
+| param | type | description |
+| ----- | ---- | ----------- |
+| `accordionId` | string | The ID of the accordion that the section belongs to. |
+| `sectionId` | string | The ID of the section whose expanded or collapsed state should be toggled. |
+
+#### toggleAllSections()
+
+
+Sets all sections belonging to an accordion to their expanded states.
+
+
+**Kind:** inner method of [useZeroAccordionStore](#usezeroaccordionstore)
+
+| param | type | description |
+| ----- | ---- | ----------- |
+| `accordionId` | string | The ID of the accordion in question. |
diff --git a/packages/zero-core/modules/accordion/components/zero-accordion.vue b/packages/zero-core/modules/accordion/components/zero-accordion.vue
index e450ea2..a3b39ab 100644
--- a/packages/zero-core/modules/accordion/components/zero-accordion.vue
+++ b/packages/zero-core/modules/accordion/components/zero-accordion.vue
@@ -1,23 +1,37 @@
 <template>
   <div class="accordion">
 
+    <!-- @slot [zeroAccordionSections](/zero-core/modules/accordion/components#zero-accordion-section) should be added to this slot -->
     <slot />
 
   </div>
 </template>
 
 <script setup>
+/**
+ * @description A component with child sections that can be toggled to expand and collapse. This component is relatively simple, consisting of a slot for multiple [zeroAccordionSection](/zero-core/modules/accordion/components#zero-accordion-section) components.
+ * In the `onBeforeMount` hook of this component, an instance tracking object is set in the accordion store using the store's [setAccordion](/zero-core/modules/accordion/store#setaccordion) method. When the component is mounted, if the `toggleOnLoad` and `multiple` props are set to true, the [toggleAllSections](/zero-core/modules/accordion/store#toggleallsections) method of the accordion store will be called for this accordion instance.
+ */
 // ======================================================================= Props
 const props = defineProps({
+  /**
+   * A unique identifier for this accordion instance. This same prop is present in all children components and its value should match those of its children.
+   */
   accordionId: {
     type: String,
     required: true
   },
+  /**
+   * A boolean indicating whether or not multiple accordion sections can be expanded at the same time. `true` if so, `false` indicates expanded section states are mutually exclusive.
+   */
   multiple: {
     type: Boolean,
     required: false,
     default: false
   },
+  /**
+   * A boolean indicating whether or not all accordion sections should be expanded upon mounting the component. **If `multiple` is set to false, this setting has no effect.**
+   */
   toggleOnLoad: {
     type: Boolean,
     required: false,
@@ -58,6 +72,8 @@ onBeforeUnmount(() => {
 // ===================================================================== Methods
 /**
  * @method handleKeyboardNavigation
+ * @desc The keyboard event handler that is called on window `keydown` events. Used to navigate the accordion with the keyboard. It will call the accordion store's [toggleAllSections](/zero-core/modules/accordion/store#toggleallsections) method if the 'f' and meta keys are pressed.
+ * @param {Object} e The [KeyboardEvent](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent) object.
  */
 const handleKeyboardNavigation = (e) => {
   if (e.repeat) { return }
diff --git a/packages/zero-core/modules/accordion/stores/use-zero-accordion-store.js b/packages/zero-core/modules/accordion/stores/use-zero-accordion-store.js
index 7d67c5c..30dd8ae 100644
--- a/packages/zero-core/modules/accordion/stores/use-zero-accordion-store.js
+++ b/packages/zero-core/modules/accordion/stores/use-zero-accordion-store.js
@@ -1,3 +1,7 @@
+/**
+ * @module useZeroAccordionStore
+ * @desc A store for tracking [accordion](/zero-core/modules/accordion/components#zero-accordion) instances and their expanded/collapsed [section](/zero-core/modules/accordion/components#zero-accordion-section) states.
+ */
 // ///////////////////////////////////////////////////////////////////// Imports
 // -----------------------------------------------------------------------------
 import { defineStore } from 'pinia'
@@ -7,10 +11,19 @@ import { defineStore } from 'pinia'
 export const useZeroAccordionStore = defineStore('zero-accordion', () => {
   // ===================================================================== state
   /**
-   * Expected accordion structure:
+   * @member {Object} accordions
+   * @kind ref
+   * @desc An object containing nested objects representing individual accordion instances. Each nested object exists at the root level of this object, has a key corresponding to its accordionId and should be of the following structure:
+   * ```js
    * {
-   *  sections: []
+   *   accordionId: string,
+   *   multiple: boolean,
+   *   id: string,
+   *   children: Array,
+   *   active: Array|boolean,
+   *   allSectionsOpen: boolean
    * }
+   * ```
    */
   const accordions = ref({})
 
@@ -18,6 +31,8 @@ export const useZeroAccordionStore = defineStore('zero-accordion', () => {
 
   /**
    * @method setAccordion
+   * @desc Adds an accordion instance tracking object to the [accordions object](/zero-core/modules/accordion/store#accordions) above.
+   * @param {Object} payload The tracking object. Should have the structure defined in the [accordions object](/zero-core/modules/accordion/store#accordions) above.
    */
   const setAccordion = payload => {
     accordions.value[payload.accordionId] = payload
@@ -25,6 +40,8 @@ export const useZeroAccordionStore = defineStore('zero-accordion', () => {
 
   /**
    * @method removeAccordion
+   * @desc Removes an accordion tracking object from the accordions state above.
+   * @param {string} accordionId The ID of the accordion to remove.
    */
   const removeAccordion = accordionId => {
    delete accordions.value[accordionId]
@@ -32,6 +49,9 @@ export const useZeroAccordionStore = defineStore('zero-accordion', () => {
 
   /**
    * @method setAccordionSection
+   * @desc Adds a section to be tracked to the accordion tracking object in the accordions state above. This method pushes the section ID to the `children` array in the tracking above.
+   * @param {string} accordionId The ID of the accordion to add the section to.
+   * @param {string} sectionId The ID of the section.
    */
   const setAccordionSection = (accordionId, sectionId) => {
     if (accordions.value[accordionId].children.includes(sectionId)) { return }
@@ -40,6 +60,9 @@ export const useZeroAccordionStore = defineStore('zero-accordion', () => {
 
   /**
    * @method toggleAccordionSection
+   * @desc Toggles the expanded/collapsed state of an accordion section. If the toggle results in all sections of the accordion in question being set to expanded, the `allSectionsOpen` boolean in the accordion tracking object will be set to `true`. Otherwise, it is set to `false`.
+   * @param {string} accordionId The ID of the accordion that the section belongs to.
+   * @param {string} sectionId The ID of the section whose expanded or collapsed state should be toggled.
    */
   const toggleAccordionSection = (accordionId, sectionId) => {
     const active = accordions.value[accordionId].active
@@ -64,6 +87,8 @@ export const useZeroAccordionStore = defineStore('zero-accordion', () => {
 
   /**
    * @method toggleAllSections
+   * @desc Sets all sections belonging to an accordion to their expanded states.
+   * @param {string} accordionId The ID of the accordion in question.
    */
   const toggleAllSections = accordionId => {
     if (!accordions.value[accordionId].multiple) {