kempo-ui 0.0.80 → 0.0.82

package/.github/skills/new-component/SKILL.md

@@ -13,12 +13,13 @@ Use this skill any time you are asked to create a new component or add a new cus
 
 ## Overview
 
-Creating a component involves four steps:
+Creating a component involves five steps:
 
 1. **Choose the base component** — pick the right rendering strategy
 2. **Write the source file** in `src/components/`
 3. **Register the custom element** at the bottom of the source file
 4. **Add documentation** in `docs/components/`
+5. **Write and run unit tests** in `tests/components/`
 
 ---
 
@@ -151,7 +152,7 @@ customElements.define('k-my-component', MyComponent);
 
 ---
 
-## Step 3: Register in the Nav (if it should appear in docs)
+## Step 3: Register in the Nav and Index (if it should appear in docs)
 
 Add a link to the component in `docs/nav.inc.html` inside the `<menu>` under the appropriate section, in alphabetical order:
 
@@ -159,6 +160,17 @@ Add a link to the component in `docs/nav.inc.html` inside the `<menu>` under the
 <a href="./components/my-component.html">My Component</a>
 ```
 
+Also add a card in `docs/index.html` inside the `<div class="row -mx">` under the `<h2>Components</h2>` section, in alphabetical order:
+
+```html
+<div class="span-12 t-span-6 d-span-4 px">
+  <a href="./components/my-component.html" class="card mb no-link d-b">
+    <h3 class="tc-primary">My Component</h3>
+    <p class="tc-muted">One-sentence description of what the component does.</p>
+  </a>
+</div>
+```
+
 ---
 
 ## Step 4: Add Documentation
@@ -182,6 +194,72 @@ Key requirements:
 
 ---
 
+## Step 5: Write and Run Unit Tests
+
+Create `tests/components/MyComponent.browser-test.js`. Use an existing test file (e.g. `tests/components/Toggle.browser-test.js`) as a reference.
+
+Key conventions:
+- Import the component class at the top.
+- Define an async `createMyComponent()` helper that builds the DOM, appends it to `document.body`, awaits `el.updateComplete`, and returns `{ container, el }`.
+- Define a `cleanup(container)` helper that removes the container from the DOM.
+- Export a default plain object where each key is a test description and each value is an `async ({pass, fail}) => {}` function.
+- Always call `cleanup(container)` before every `pass()` or `fail()` call.
+- Use multi-line comments to group related tests (e.g. `/* Element Creation */`, `/* Properties */`).
+
+Tests to include at minimum:
+- Element is created and is an instance of the component class
+- Element has a shadow root
+- Default property values are correct
+- Attribute reflection works (if applicable)
+- Public methods behave correctly
+- Events are dispatched correctly (if applicable)
+
+Example skeleton:
+
+```javascript
+import MyComponent from '../../src/components/MyComponent.js';
+
+const createMyComponent = async () => {
+  const container = document.createElement('div');
+  container.innerHTML = `<k-my-component></k-my-component>`;
+  document.body.appendChild(container);
+  const el = container.querySelector('k-my-component');
+  await el.updateComplete;
+  return { container, el };
+};
+
+const cleanup = (container) => {
+  if(container && container.parentNode){
+    container.parentNode.removeChild(container);
+  }
+};
+
+export default {
+  /*
+    Element Creation
+  */
+  'should create my-component element': async ({pass, fail}) => {
+    const { container, el } = await createMyComponent();
+    if(!(el instanceof MyComponent)){
+      cleanup(container);
+      return fail('Element should be instance of MyComponent');
+    }
+    cleanup(container);
+    pass('MyComponent element created correctly');
+  },
+};
+```
+
+After writing the tests, run them to confirm they all pass:
+
+```
+npm run test -- MyComponent
+```
+
+The partial string `MyComponent` will match any test file whose path contains that string. Fix any failures before considering the component complete.
+
+---
+
 ## Component Architecture and Communication
 
 - Use **methods** to trigger actions. Events notify that something already happened; they should not be used to trigger logic.

package/dist/components/FilterItem.js

@@ -0,0 +1,8 @@
+import ShadowComponent from"./ShadowComponent.js";import{html,css}from"../lit-all.min.js";export default class FilterItem extends ShadowComponent{render(){return html`<slot></slot>`}static styles=css`
+		:host {
+			display: contents;
+		}
+		:host([hidden]) {
+			display: none !important;
+		}
+	`}customElements.define("k-filter-item",FilterItem);

package/dist/components/FilterList.js

@@ -0,0 +1,5 @@
+import ShadowComponent from"./ShadowComponent.js";import{html,css}from"../lit-all.min.js";export default class FilterList extends ShadowComponent{render(){return html`<slot></slot>`}filter(t){const e=t.toLowerCase().split(/\s+/).filter(t=>t.length>0);this.querySelectorAll("k-filter-item").forEach(t=>{const s=(t.getAttribute("filter-keywords")||"").toLowerCase();t.hidden=e.length>0&&!e.every(t=>s.includes(t))})}static styles=css`
+		:host {
+			display: block;
+		}
+	`}customElements.define("k-filter-list",FilterList);

package/docs/components/filter-list.html

@@ -0,0 +1,135 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Filter List - Components - Kempo Docs - A Web Components Solution</title>
+  <link rel="icon" type="image/png" sizes="48x48" href="../media/icon48.png">
+  <link rel="manifest" href="../manifest.json" />
+  <link rel="stylesheet" href="../kempo-vars.css" />
+  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/kempo-css@1.3.11/dist/kempo.min.css" />
+  <link rel="stylesheet" href="../kempo-hljs.css" />
+  <link rel="stylesheet" href="../styles.css" />
+  <script>window.litDisableBundleWarning = true;</script>
+</head>
+<body>
+  <k-import src="../nav-1.inc.html"></k-import>
+  <main>
+    <h1 class="ta-center">Filter List</h1>
+
+    <k-accordion persistent-id="toc" class="b r mb">
+      <k-accordion-header for-panel="toc-panel">Table of Contents</k-accordion-header>
+      <k-accordion-panel name="toc-panel">
+        <div class="m">
+          <h6>Examples</h6>
+          <a href="#basicUsage">Basic Usage</a><br />
+          <a href="#tagButtons">Tag Buttons</a><br />
+
+          <h6 class="mt"><a href="#jsRef" class="no-link">JavaScript Reference</a></h6>
+          <a href="#constructor">Constructor</a><br />
+          <a href="#requirements">Requirements</a><br />
+          <a href="#filterItem">FilterItem Attributes</a><br />
+          <a href="#methods">Methods</a><br />
+        </div>
+      </k-accordion-panel>
+    </k-accordion>
+
+    <h3 id="basicUsage"><a href="#basicUsage" class="no-link">Basic Usage</a></h3>
+    <p>Wrap items in <code>k-filter-item</code> elements with a <code>filter-keywords</code> attribute inside a <code>k-filter-list</code>. Connect an input to <code>filter()</code> using the <a href="../utils/debounce.html">debounce</a> utility to avoid filtering on every keystroke.</p>
+    <div class="row -mx">
+      <div class="col m-span-12 px">
+        <k-card label="HTML">
+          <pre><code class="hljs xml"><span class="hljs-tag">&lt;<span class="hljs-name">input</span> <span class="hljs-attr">id</span>=<span class="hljs-string">filterInput</span> <span class="hljs-attr">type</span>=<span class="hljs-string">search</span> <span class="hljs-attr">placeholder</span>=<span class="hljs-string">&#x27;Filter...&#x27;</span> /&gt;</span><br><span class="hljs-tag">&lt;<span class="hljs-name">k-filter-list</span> <span class="hljs-attr">id</span>=<span class="hljs-string">myFilterList</span>&gt;</span><br>  <span class="hljs-tag">&lt;<span class="hljs-name">k-filter-item</span> <span class="hljs-attr">class</span>=<span class="hljs-string">d-b</span> <span class="hljs-attr">filter-keywords</span>=<span class="hljs-string">&#x27;apple fruit red&#x27;</span>&gt;</span><span class="hljs-tag">&lt;<span class="hljs-name">a</span> <span class="hljs-attr">href</span>=<span class="hljs-string">#</span>&gt;</span>Apple<span class="hljs-tag">&lt;/<span class="hljs-name">a</span>&gt;</span><span class="hljs-tag">&lt;/<span class="hljs-name">k-filter-item</span>&gt;</span><br>  <span class="hljs-tag">&lt;<span class="hljs-name">k-filter-item</span> <span class="hljs-attr">class</span>=<span class="hljs-string">d-b</span> <span class="hljs-attr">filter-keywords</span>=<span class="hljs-string">&#x27;banana fruit yellow&#x27;</span>&gt;</span><span class="hljs-tag">&lt;<span class="hljs-name">a</span> <span class="hljs-attr">href</span>=<span class="hljs-string">#</span>&gt;</span>Banana<span class="hljs-tag">&lt;/<span class="hljs-name">a</span>&gt;</span><span class="hljs-tag">&lt;/<span class="hljs-name">k-filter-item</span>&gt;</span><br>  <span class="hljs-tag">&lt;<span class="hljs-name">k-filter-item</span> <span class="hljs-attr">class</span>=<span class="hljs-string">d-b</span> <span class="hljs-attr">filter-keywords</span>=<span class="hljs-string">&#x27;cherry fruit red&#x27;</span>&gt;</span><span class="hljs-tag">&lt;<span class="hljs-name">a</span> <span class="hljs-attr">href</span>=<span class="hljs-string">#</span>&gt;</span>Cherry<span class="hljs-tag">&lt;/<span class="hljs-name">a</span>&gt;</span><span class="hljs-tag">&lt;/<span class="hljs-name">k-filter-item</span>&gt;</span><br>  <span class="hljs-tag">&lt;<span class="hljs-name">k-filter-item</span> <span class="hljs-attr">class</span>=<span class="hljs-string">d-b</span> <span class="hljs-attr">filter-keywords</span>=<span class="hljs-string">&#x27;grape fruit purple&#x27;</span>&gt;</span><span class="hljs-tag">&lt;<span class="hljs-name">a</span> <span class="hljs-attr">href</span>=<span class="hljs-string">#</span>&gt;</span>Grape<span class="hljs-tag">&lt;/<span class="hljs-name">a</span>&gt;</span><span class="hljs-tag">&lt;/<span class="hljs-name">k-filter-item</span>&gt;</span><br>  <span class="hljs-tag">&lt;<span class="hljs-name">k-filter-item</span> <span class="hljs-attr">class</span>=<span class="hljs-string">d-b</span> <span class="hljs-attr">filter-keywords</span>=<span class="hljs-string">&#x27;lemon citrus yellow fruit&#x27;</span>&gt;</span><span class="hljs-tag">&lt;<span class="hljs-name">a</span> <span class="hljs-attr">href</span>=<span class="hljs-string">#</span>&gt;</span>Lemon<span class="hljs-tag">&lt;/<span class="hljs-name">a</span>&gt;</span><span class="hljs-tag">&lt;/<span class="hljs-name">k-filter-item</span>&gt;</span><br>  <span class="hljs-tag">&lt;<span class="hljs-name">k-filter-item</span> <span class="hljs-attr">class</span>=<span class="hljs-string">d-b</span> <span class="hljs-attr">filter-keywords</span>=<span class="hljs-string">&#x27;orange citrus fruit&#x27;</span>&gt;</span><span class="hljs-tag">&lt;<span class="hljs-name">a</span> <span class="hljs-attr">href</span>=<span class="hljs-string">#</span>&gt;</span>Orange<span class="hljs-tag">&lt;/<span class="hljs-name">a</span>&gt;</span><span class="hljs-tag">&lt;/<span class="hljs-name">k-filter-item</span>&gt;</span><br>  <span class="hljs-tag">&lt;<span class="hljs-name">k-filter-item</span> <span class="hljs-attr">class</span>=<span class="hljs-string">d-b</span> <span class="hljs-attr">filter-keywords</span>=<span class="hljs-string">&#x27;strawberry fruit red&#x27;</span>&gt;</span><span class="hljs-tag">&lt;<span class="hljs-name">a</span> <span class="hljs-attr">href</span>=<span class="hljs-string">#</span>&gt;</span>Strawberry<span class="hljs-tag">&lt;/<span class="hljs-name">a</span>&gt;</span><span class="hljs-tag">&lt;/<span class="hljs-name">k-filter-item</span>&gt;</span><br><span class="hljs-tag">&lt;/<span class="hljs-name">k-filter-list</span>&gt;</span><br><span class="hljs-tag">&lt;<span class="hljs-name">script</span> <span class="hljs-attr">type</span>=<span class="hljs-string">module</span>&gt;</span><span class="language-javascript"><br>  <span class="hljs-keyword">import</span> debounce <span class="hljs-keyword">from</span> <span class="hljs-string">&#x27;../src/utils/debounce.js&#x27;</span>;<br>  <span class="hljs-keyword">const</span> list = <span class="hljs-variable language_">document</span>.<span class="hljs-title function_">getElementById</span>(<span class="hljs-string">&#x27;myFilterList&#x27;</span>);<br>  <span class="hljs-variable language_">document</span>.<span class="hljs-title function_">getElementById</span>(<span class="hljs-string">&#x27;filterInput&#x27;</span>).<span class="hljs-title function_">addEventListener</span>(<span class="hljs-string">&#x27;input&#x27;</span>, <span class="hljs-title function_">debounce</span>(<span class="hljs-function"><span class="hljs-params">e</span> =&gt;</span> list.<span class="hljs-title function_">filter</span>(e.<span class="hljs-property">target</span>.<span class="hljs-property">value</span>)));<br></span><span class="hljs-tag">&lt;/<span class="hljs-name">script</span>&gt;</span></code></pre>
+        </k-card>
+      </div>
+      <div class="col m-span-12 px">
+        <k-card label="Output">
+          <input id="filterInput" type="search" placeholder="Filter..." class="mb" />
+          <k-filter-list id="myFilterList">
+            <k-filter-item class="d-b" filter-keywords="apple fruit red"><a href="#">Apple</a></k-filter-item>
+            <k-filter-item class="d-b" filter-keywords="banana fruit yellow"><a href="#">Banana</a></k-filter-item>
+            <k-filter-item class="d-b" filter-keywords="cherry fruit red"><a href="#">Cherry</a></k-filter-item>
+            <k-filter-item class="d-b" filter-keywords="grape fruit purple"><a href="#">Grape</a></k-filter-item>
+            <k-filter-item class="d-b" filter-keywords="lemon citrus yellow fruit"><a href="#">Lemon</a></k-filter-item>
+            <k-filter-item class="d-b" filter-keywords="orange citrus fruit"><a href="#">Orange</a></k-filter-item>
+            <k-filter-item class="d-b" filter-keywords="strawberry fruit red"><a href="#">Strawberry</a></k-filter-item>
+          </k-filter-list>
+          <script type="module">
+            import debounce from '../src/utils/debounce.js';
+            const list = document.getElementById('myFilterList');
+            document.getElementById('filterInput').addEventListener('input', debounce(e => list.filter(e.target.value)));
+          </script>
+        </k-card>
+      </div>
+    </div>
+
+    <h3 id="tagButtons"><a href="#tagButtons" class="no-link">Tag Buttons</a></h3>
+    <p>Use category buttons to filter the list. Each button stores its filter term in <code>data-filter</code>; clicking it activates that button and calls <code>filter()</code>. An empty string clears the filter and shows all items.</p>
+    <div class="row -mx">
+      <div class="col m-span-12 px">
+        <k-card label="HTML">
+          <pre><code class="hljs xml"><span class="hljs-tag">&lt;<span class="hljs-name">div</span> <span class="hljs-attr">class</span>=<span class="hljs-string">&#x27;d-f gap mb&#x27;</span> <span class="hljs-attr">id</span>=<span class="hljs-string">tagButtons</span>&gt;</span><span class="hljs-tag">&lt;<span class="hljs-name">button</span> <span class="hljs-attr">class</span>=<span class="hljs-string">&#x27;btn primary&#x27;</span> <span class="hljs-attr">data-filter</span>=<span class="hljs-string">&#x27;&#x27;</span>&gt;</span>All<span class="hljs-tag">&lt;/<span class="hljs-name">button</span>&gt;</span><span class="hljs-tag">&lt;<span class="hljs-name">button</span> <span class="hljs-attr">class</span>=<span class="hljs-string">btn</span> <span class="hljs-attr">data-filter</span>=<span class="hljs-string">red</span>&gt;</span>Red<span class="hljs-tag">&lt;/<span class="hljs-name">button</span>&gt;</span><span class="hljs-tag">&lt;<span class="hljs-name">button</span> <span class="hljs-attr">class</span>=<span class="hljs-string">btn</span> <span class="hljs-attr">data-filter</span>=<span class="hljs-string">yellow</span>&gt;</span>Yellow<span class="hljs-tag">&lt;/<span class="hljs-name">button</span>&gt;</span><span class="hljs-tag">&lt;<span class="hljs-name">button</span> <span class="hljs-attr">class</span>=<span class="hljs-string">btn</span> <span class="hljs-attr">data-filter</span>=<span class="hljs-string">citrus</span>&gt;</span>Citrus<span class="hljs-tag">&lt;/<span class="hljs-name">button</span>&gt;</span><span class="hljs-tag">&lt;/<span class="hljs-name">div</span>&gt;</span><br><span class="hljs-tag">&lt;<span class="hljs-name">k-filter-list</span> <span class="hljs-attr">id</span>=<span class="hljs-string">tagFilterList</span>&gt;</span><br>  <span class="hljs-tag">&lt;<span class="hljs-name">k-filter-item</span> <span class="hljs-attr">class</span>=<span class="hljs-string">d-b</span> <span class="hljs-attr">filter-keywords</span>=<span class="hljs-string">&#x27;apple fruit red&#x27;</span>&gt;</span><span class="hljs-tag">&lt;<span class="hljs-name">a</span> <span class="hljs-attr">href</span>=<span class="hljs-string">#</span>&gt;</span>Apple<span class="hljs-tag">&lt;/<span class="hljs-name">a</span>&gt;</span><span class="hljs-tag">&lt;/<span class="hljs-name">k-filter-item</span>&gt;</span><br>  <span class="hljs-tag">&lt;<span class="hljs-name">k-filter-item</span> <span class="hljs-attr">class</span>=<span class="hljs-string">d-b</span> <span class="hljs-attr">filter-keywords</span>=<span class="hljs-string">&#x27;banana fruit yellow&#x27;</span>&gt;</span><span class="hljs-tag">&lt;<span class="hljs-name">a</span> <span class="hljs-attr">href</span>=<span class="hljs-string">#</span>&gt;</span>Banana<span class="hljs-tag">&lt;/<span class="hljs-name">a</span>&gt;</span><span class="hljs-tag">&lt;/<span class="hljs-name">k-filter-item</span>&gt;</span><br>  <span class="hljs-tag">&lt;<span class="hljs-name">k-filter-item</span> <span class="hljs-attr">class</span>=<span class="hljs-string">d-b</span> <span class="hljs-attr">filter-keywords</span>=<span class="hljs-string">&#x27;cherry fruit red&#x27;</span>&gt;</span><span class="hljs-tag">&lt;<span class="hljs-name">a</span> <span class="hljs-attr">href</span>=<span class="hljs-string">#</span>&gt;</span>Cherry<span class="hljs-tag">&lt;/<span class="hljs-name">a</span>&gt;</span><span class="hljs-tag">&lt;/<span class="hljs-name">k-filter-item</span>&gt;</span><br>  <span class="hljs-tag">&lt;<span class="hljs-name">k-filter-item</span> <span class="hljs-attr">class</span>=<span class="hljs-string">d-b</span> <span class="hljs-attr">filter-keywords</span>=<span class="hljs-string">&#x27;grape fruit purple&#x27;</span>&gt;</span><span class="hljs-tag">&lt;<span class="hljs-name">a</span> <span class="hljs-attr">href</span>=<span class="hljs-string">#</span>&gt;</span>Grape<span class="hljs-tag">&lt;/<span class="hljs-name">a</span>&gt;</span><span class="hljs-tag">&lt;/<span class="hljs-name">k-filter-item</span>&gt;</span><br>  <span class="hljs-tag">&lt;<span class="hljs-name">k-filter-item</span> <span class="hljs-attr">class</span>=<span class="hljs-string">d-b</span> <span class="hljs-attr">filter-keywords</span>=<span class="hljs-string">&#x27;lemon citrus yellow fruit&#x27;</span>&gt;</span><span class="hljs-tag">&lt;<span class="hljs-name">a</span> <span class="hljs-attr">href</span>=<span class="hljs-string">#</span>&gt;</span>Lemon<span class="hljs-tag">&lt;/<span class="hljs-name">a</span>&gt;</span><span class="hljs-tag">&lt;/<span class="hljs-name">k-filter-item</span>&gt;</span><br>  <span class="hljs-tag">&lt;<span class="hljs-name">k-filter-item</span> <span class="hljs-attr">class</span>=<span class="hljs-string">d-b</span> <span class="hljs-attr">filter-keywords</span>=<span class="hljs-string">&#x27;orange citrus fruit&#x27;</span>&gt;</span><span class="hljs-tag">&lt;<span class="hljs-name">a</span> <span class="hljs-attr">href</span>=<span class="hljs-string">#</span>&gt;</span>Orange<span class="hljs-tag">&lt;/<span class="hljs-name">a</span>&gt;</span><span class="hljs-tag">&lt;/<span class="hljs-name">k-filter-item</span>&gt;</span><br>  <span class="hljs-tag">&lt;<span class="hljs-name">k-filter-item</span> <span class="hljs-attr">class</span>=<span class="hljs-string">d-b</span> <span class="hljs-attr">filter-keywords</span>=<span class="hljs-string">&#x27;strawberry fruit red&#x27;</span>&gt;</span><span class="hljs-tag">&lt;<span class="hljs-name">a</span> <span class="hljs-attr">href</span>=<span class="hljs-string">#</span>&gt;</span>Strawberry<span class="hljs-tag">&lt;/<span class="hljs-name">a</span>&gt;</span><span class="hljs-tag">&lt;/<span class="hljs-name">k-filter-item</span>&gt;</span><br><span class="hljs-tag">&lt;/<span class="hljs-name">k-filter-list</span>&gt;</span><br><span class="hljs-tag">&lt;<span class="hljs-name">script</span> <span class="hljs-attr">type</span>=<span class="hljs-string">module</span>&gt;</span><span class="language-javascript"><br>  <span class="hljs-keyword">const</span> list = <span class="hljs-variable language_">document</span>.<span class="hljs-title function_">getElementById</span>(<span class="hljs-string">&#x27;tagFilterList&#x27;</span>);<br>  <span class="hljs-variable language_">document</span>.<span class="hljs-title function_">querySelectorAll</span>(<span class="hljs-string">&#x27;#tagButtons [data-filter]&#x27;</span>).<span class="hljs-title function_">forEach</span>(<span class="hljs-function"><span class="hljs-params">btn</span> =&gt;</span> {<br>    btn.<span class="hljs-title function_">addEventListener</span>(<span class="hljs-string">&#x27;click&#x27;</span>, <span class="hljs-function">() =&gt;</span> {<br>      <span class="hljs-variable language_">document</span>.<span class="hljs-title function_">querySelectorAll</span>(<span class="hljs-string">&#x27;#tagButtons [data-filter]&#x27;</span>).<span class="hljs-title function_">forEach</span>(<span class="hljs-function"><span class="hljs-params">b</span> =&gt;</span> b.<span class="hljs-property">classList</span>.<span class="hljs-title function_">remove</span>(<span class="hljs-string">&#x27;primary&#x27;</span>));<br>      btn.<span class="hljs-property">classList</span>.<span class="hljs-title function_">add</span>(<span class="hljs-string">&#x27;primary&#x27;</span>);<br>      list.<span class="hljs-title function_">filter</span>(btn.<span class="hljs-property">dataset</span>.<span class="hljs-property">filter</span>);<br>    });<br>  });<br></span><span class="hljs-tag">&lt;/<span class="hljs-name">script</span>&gt;</span></code></pre>
+        </k-card>
+      </div>
+      <div class="col m-span-12 px">
+        <k-card label="Output">
+          <div class="d-f gap mb" id="tagButtons">
+            <button class="btn primary" data-filter="">All</button>
+            <button class="btn" data-filter="red">Red</button>
+            <button class="btn" data-filter="yellow">Yellow</button>
+            <button class="btn" data-filter="citrus">Citrus</button>
+          </div>
+          <k-filter-list id="tagFilterList">
+            <k-filter-item class="d-b" filter-keywords="apple fruit red"><a href="#">Apple</a></k-filter-item>
+            <k-filter-item class="d-b" filter-keywords="banana fruit yellow"><a href="#">Banana</a></k-filter-item>
+            <k-filter-item class="d-b" filter-keywords="cherry fruit red"><a href="#">Cherry</a></k-filter-item>
+            <k-filter-item class="d-b" filter-keywords="grape fruit purple"><a href="#">Grape</a></k-filter-item>
+            <k-filter-item class="d-b" filter-keywords="lemon citrus yellow fruit"><a href="#">Lemon</a></k-filter-item>
+            <k-filter-item class="d-b" filter-keywords="orange citrus fruit"><a href="#">Orange</a></k-filter-item>
+            <k-filter-item class="d-b" filter-keywords="strawberry fruit red"><a href="#">Strawberry</a></k-filter-item>
+          </k-filter-list>
+          <script type="module">
+            const list = document.getElementById('tagFilterList');
+            document.querySelectorAll('#tagButtons [data-filter]').forEach(btn => {
+              btn.addEventListener('click', () => {
+                document.querySelectorAll('#tagButtons [data-filter]').forEach(b => b.classList.remove('primary'));
+                btn.classList.add('primary');
+                list.filter(btn.dataset.filter);
+              });
+            });
+          </script>
+        </k-card>
+      </div>
+    </div>
+
+    <h2 id="jsRef"><a href="#jsRef" class="no-link">JavaScript Reference</a></h2>
+
+    <h3 id="constructor"><a href="#constructor" class="no-link">Constructor</a></h3>
+    <h6>Extends <a href="./shadow-component.html">ShadowComponent</a></h6>
+    <h5><code>new FilterList()</code></h5>
+    <h5><code>new FilterItem()</code></h5>
+
+    <h3 id="requirements"><a href="#requirements" class="no-link">Requirements</a></h3>
+    <ul>
+      <li><a href="./shadow-component.html">ShadowComponent</a></li>
+    </ul>
+
+    <h3 id="filterItem"><a href="#filterItem" class="no-link">FilterItem Attributes</a></h3>
+    <h5><code>filter-keywords<i>: string</i></code></h5>
+    <p>A string of keywords used to match against the search term. The <code>filter()</code> method checks if this value includes the lowercased search term as a substring.</p>
+
+    <h3 id="methods"><a href="#methods" class="no-link">Methods</a></h3>
+    <h5><code>filter(term<i>: string</i>)<i>: void</i></code></h5>
+    <p>Shows or hides each child <code>k-filter-item</code> based on whether its <code>filter-keywords</code> attribute includes <code>term</code> (case-insensitive). Passing an empty string reveals all items.</p>
+
+  </main>
+  <div style="height:33vh"></div>
+
+  <script type="module" src="../src/components/Import.js"></script>
+  <script type="module" src="../src/components/FilterList.js"></script>
+  <script type="module" src="../src/components/FilterItem.js"></script>
+  <script type="module" src="../src/components/Accordion.js"></script>
+  <script type="module" src="../src/components/Card.js"></script>
+
+</body>
+</html>

package/docs/icons/search.svg

@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 -960 960 960" ><path fill="currentColor" d="M784-120 532-372q-30 24-69 38t-83 14q-109 0-184.5-75.5T120-580q0-109 75.5-184.5T380-840q109 0 184.5 75.5T640-580q0 44-14 83t-38 69l252 252-56 56ZM380-400q75 0 127.5-52.5T560-580q0-75-52.5-127.5T380-760q-75 0-127.5 52.5T200-580q0 75 52.5 127.5T380-400Z"/></svg>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 -960 960 960"><path fill="currentColor" d="M784-120 532-372q-30 24-69 38t-83 14q-109 0-184.5-75.5T120-580q0-109 75.5-184.5T380-840q109 0 184.5 75.5T640-580q0 44-14 83t-38 69l252 252-56 56ZM380-400q75 0 127.5-52.5T560-580q0-75-52.5-127.5T380-760q-75 0-127.5 52.5T200-580q0 75 52.5 127.5T380-400Z"/></svg>

package/docs/index.html

@@ -83,6 +83,12 @@
           <p class="tc-muted">Action menus with keyboard navigation and customizable positioning.</p>
         </a>
       </div>
+      <div class="span-12 t-span-6 d-span-4 px">
+        <a href="./components/filter-list.html" class="card mb no-link d-b">
+          <h3 class="tc-primary">Filter List</h3>
+          <p class="tc-muted">Show or hide items based on a search term matching their filter keywords.</p>
+        </a>
+      </div>
       <div class="span-12 t-span-6 d-span-4 px">
         <a href="./components/focus-capture.html" class="card mb no-link d-b">
           <h3 class="tc-primary">FocusCapture</h3>

package/docs/nav-1.inc.html

@@ -15,6 +15,67 @@
     <img src="../media/icon32.png" alt="Kempo UI Icon" class="pr" />
     Kempo UI
   </a>
+  <div style="position:relative;margin:0 .25rem;align-self:center;" theme="light">
+    <input id="navSearchInput" type="search" placeholder="Search docs..." autocomplete="off" style="width:11rem;" />
+    <div id="navSearchDropdown" hidden theme="light" style="position:absolute;top:calc(100% + 4px);left:0;width:min(480px,90vw);max-height:70vh;background:var(--c_bg);border:1px solid var(--c_border);border-radius:var(--radius);overflow:auto;z-index:9999;box-shadow:0 4px 12px rgba(0,0,0,.3);">
+      <k-filter-list id="navSearchList" style="display:block;padding:.25rem 0;">
+        <k-filter-item filter-keywords="accordion components"><a href="../components/accordion.html">Accordion<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="card components"><a href="../components/card.html">Card<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="color picker colorpicker components"><a href="../components/color-picker.html">Color Picker<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="content slider components"><a href="../components/content-slider.html">Content Slider<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="dialog modal popup components"><a href="../components/dialog.html">Dialog<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="dropdown select components"><a href="../components/dropdown.html">Dropdown<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="filter list filterlist components"><a href="../components/filter-list.html">Filter List<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="focus capture focuscapture components"><a href="../components/focus-capture.html">Focus Capture<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="html editor components"><a href="../components/html-editor.html">HTML Editor<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="icon components"><a href="../components/icon.html">Icon<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="import components"><a href="../components/import.html">Import<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="photo viewer photoviewer components"><a href="../components/photo-viewer.html">Photo Viewer<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="resize components"><a href="../components/resize.html">Resize<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="show more showmore components"><a href="../components/show-more.html">Show More<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="side menu sidemenu components"><a href="../components/side-menu.html">Side Menu<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="side panel sidepanel components"><a href="../components/side-panel.html">Side Panel<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="sortable drag drop sort components"><a href="../components/sortable.html">Sortable<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="spinner loading components"><a href="../components/spinner.html">Spinner<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="split pane components"><a href="../components/split.html">Split<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="table data grid components"><a href="../components/table.html">Table<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="table controls advanced example"><a href="../components/tableControls.html">Table — Controls<br><small>Advanced Example</small></a></k-filter-item>
+        <k-filter-item filter-keywords="table custom fields advanced example"><a href="../components/tableCustomFields.html">Table — Custom Fields<br><small>Advanced Example</small></a></k-filter-item>
+        <k-filter-item filter-keywords="table fetch records advanced example"><a href="../components/tableFetchRecords.html">Table — Fetch Records<br><small>Advanced Example</small></a></k-filter-item>
+        <k-filter-item filter-keywords="table field sort hide advanced example"><a href="../components/tableFieldSortHide.html">Table — Field Sort &amp; Hide<br><small>Advanced Example</small></a></k-filter-item>
+        <k-filter-item filter-keywords="table pagination advanced example"><a href="../components/tablePagination.html">Table — Pagination<br><small>Advanced Example</small></a></k-filter-item>
+        <k-filter-item filter-keywords="table record editing advanced example"><a href="../components/tableRecordEditing.html">Table — Record Editing<br><small>Advanced Example</small></a></k-filter-item>
+        <k-filter-item filter-keywords="table record filtering advanced example"><a href="../components/tableRecordFiltering.html">Table — Record Filtering<br><small>Advanced Example</small></a></k-filter-item>
+        <k-filter-item filter-keywords="table record hiding advanced example"><a href="../components/tableRecordHiding.html">Table — Record Hiding<br><small>Advanced Example</small></a></k-filter-item>
+        <k-filter-item filter-keywords="table record searching advanced example"><a href="../components/tableRecordSearching.html">Table — Record Searching<br><small>Advanced Example</small></a></k-filter-item>
+        <k-filter-item filter-keywords="table record selection advanced example"><a href="../components/tableRecordSelection.html">Table — Record Selection<br><small>Advanced Example</small></a></k-filter-item>
+        <k-filter-item filter-keywords="table row controls advanced example"><a href="../components/tableRowControls.html">Table — Row Controls<br><small>Advanced Example</small></a></k-filter-item>
+        <k-filter-item filter-keywords="table server sync advanced example"><a href="../components/tableServerSync.html">Table — Server Sync<br><small>Advanced Example</small></a></k-filter-item>
+        <k-filter-item filter-keywords="table sorting advanced example"><a href="../components/tableSorting.html">Table — Sorting<br><small>Advanced Example</small></a></k-filter-item>
+        <k-filter-item filter-keywords="tabs tab panel components"><a href="../components/tabs.html">Tabs<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="tags tag input components"><a href="../components/tags.html">Tags<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="toast notification alert components"><a href="../components/toast.html">Toast<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="theme switcher dark light components"><a href="../components/theme-switcher.html">Theme Switcher<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="timestamp date time components"><a href="../components/timestamp.html">Timestamp<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="toggle switch checkbox components"><a href="../components/toggle.html">Toggle<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="tree treeview components"><a href="../components/tree.html">Tree<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="shadow component base"><a href="../components/shadow-component.html">Shadow Component<br><small>Base Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="light component base"><a href="../components/light-component.html">Light Component<br><small>Base Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="hybrid component base"><a href="../components/hybrid-component.html">Hybrid Component<br><small>Base Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="cookie utils utility"><a href="../utils/cookie.html">cookie<br><small>Utility</small></a></k-filter-item>
+        <k-filter-item filter-keywords="context utils utility"><a href="../utils/context.html">context<br><small>Utility</small></a></k-filter-item>
+        <k-filter-item filter-keywords="debounce utils utility"><a href="../utils/debounce.html">debounce<br><small>Utility</small></a></k-filter-item>
+        <k-filter-item filter-keywords="drag utils utility"><a href="../utils/drag.html">drag<br><small>Utility</small></a></k-filter-item>
+        <k-filter-item filter-keywords="formattimestamp timestamp format date time utils utility"><a href="../utils/formatTimestamp.html">formatTimestamp<br><small>Utility</small></a></k-filter-item>
+        <k-filter-item filter-keywords="object utils utility"><a href="../utils/object.html">object<br><small>Utility</small></a></k-filter-item>
+        <k-filter-item filter-keywords="propconverters prop converters utils utility"><a href="../utils/propConverters.html">propConverters<br><small>Utility</small></a></k-filter-item>
+        <k-filter-item filter-keywords="string utils utility"><a href="../utils/string.html">string<br><small>Utility</small></a></k-filter-item>
+        <k-filter-item filter-keywords="theme utils utility"><a href="../utils/theme.html">theme<br><small>Utility</small></a></k-filter-item>
+        <k-filter-item filter-keywords="type utils utility"><a href="../utils/type.html">type<br><small>Utility</small></a></k-filter-item>
+        <k-filter-item filter-keywords="wait async utils utility"><a href="../utils/wait.html">wait<br><small>Utility</small></a></k-filter-item>
+      </k-filter-list>
+    </div>
+  </div>
   <div class="flex"></div>
   <a href="https://github.com/dustinpoissant/kempo-ui?tab=License-1-ov-file#creative-commons-attribution-noncommercial-sharealike-20"><k-icon name="license"></k-icont></a>
   <a href="https://github.com/dustinpoissant/kempo-ui"><k-icon name="github-mark"></k-icont></a>
@@ -37,6 +98,7 @@
       <a href="../components/content-slider.html">Content Slider</a>
       <a href="../components/dialog.html">Dialog</a>
       <a href="../components/dropdown.html">Dropdown</a>
+      <a href="../components/filter-list.html">Filter List</a>
       <a href="../components/focus-capture.html">FocusCapture</a>
       <a href="../components/html-editor.html">HTML Editor</a>
       <a href="../components/icon.html">Icon</a>
@@ -82,6 +144,13 @@
     </div>
   </menu>
 </k-side-menu>
+<style>
+#navSearchList a{display:block;padding:.25rem .5rem;border-radius:var(--radius);text-decoration:none;color:var(--tc);}
+#navSearchList a:hover{background:rgba(128,128,128,.15);}
+#navSearchList a small{display:block;color:var(--tc_muted);}
+</style>
+<script src="../src/components/FilterList.js" type="module"></script>
+<script src="../src/components/FilterItem.js" type="module"></script>
 <script src="../src/components/SideMenu.js" type="module"></script>
 <script src="../src/components/Icon.js" type="module"></script>
 <script src="../src/components/ThemeSwitcher.js" type="module"></script>

package/docs/nav.inc.html

@@ -15,6 +15,67 @@
     <img src="./media/icon32.png" alt="Kempo UI Icon" class="pr" />
     Kempo UI
   </a>
+  <div style="position:relative;margin:0 .25rem;align-self:center;" theme="light">
+    <input id="navSearchInput" type="search" placeholder="Search docs..." autocomplete="off" style="width:11rem;" />
+    <div id="navSearchDropdown" hidden theme="light" style="position:absolute;top:calc(100% + 4px);left:0;width:min(480px,90vw);max-height:70vh;background:var(--c_bg);border:1px solid var(--c_border);border-radius:var(--radius);overflow:auto;z-index:9999;box-shadow:0 4px 12px rgba(0,0,0,.3);">
+      <k-filter-list id="navSearchList" style="display:block;padding:.25rem 0;">
+        <k-filter-item filter-keywords="accordion components"><a href="./components/accordion.html">Accordion<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="card components"><a href="./components/card.html">Card<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="color picker colorpicker components"><a href="./components/color-picker.html">Color Picker<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="content slider components"><a href="./components/content-slider.html">Content Slider<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="dialog modal popup components"><a href="./components/dialog.html">Dialog<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="dropdown select components"><a href="./components/dropdown.html">Dropdown<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="filter list filterlist components"><a href="./components/filter-list.html">Filter List<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="focus capture focuscapture components"><a href="./components/focus-capture.html">Focus Capture<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="html editor components"><a href="./components/html-editor.html">HTML Editor<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="icon components"><a href="./components/icon.html">Icon<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="import components"><a href="./components/import.html">Import<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="photo viewer photoviewer components"><a href="./components/photo-viewer.html">Photo Viewer<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="resize components"><a href="./components/resize.html">Resize<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="show more showmore components"><a href="./components/show-more.html">Show More<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="side menu sidemenu components"><a href="./components/side-menu.html">Side Menu<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="side panel sidepanel components"><a href="./components/side-panel.html">Side Panel<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="sortable drag drop sort components"><a href="./components/sortable.html">Sortable<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="spinner loading components"><a href="./components/spinner.html">Spinner<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="split pane components"><a href="./components/split.html">Split<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="table data grid components"><a href="./components/table.html">Table<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="table controls advanced example"><a href="./components/tableControls.html">Table — Controls<br><small>Advanced Example</small></a></k-filter-item>
+        <k-filter-item filter-keywords="table custom fields advanced example"><a href="./components/tableCustomFields.html">Table — Custom Fields<br><small>Advanced Example</small></a></k-filter-item>
+        <k-filter-item filter-keywords="table fetch records advanced example"><a href="./components/tableFetchRecords.html">Table — Fetch Records<br><small>Advanced Example</small></a></k-filter-item>
+        <k-filter-item filter-keywords="table field sort hide advanced example"><a href="./components/tableFieldSortHide.html">Table — Field Sort &amp; Hide<br><small>Advanced Example</small></a></k-filter-item>
+        <k-filter-item filter-keywords="table pagination advanced example"><a href="./components/tablePagination.html">Table — Pagination<br><small>Advanced Example</small></a></k-filter-item>
+        <k-filter-item filter-keywords="table record editing advanced example"><a href="./components/tableRecordEditing.html">Table — Record Editing<br><small>Advanced Example</small></a></k-filter-item>
+        <k-filter-item filter-keywords="table record filtering advanced example"><a href="./components/tableRecordFiltering.html">Table — Record Filtering<br><small>Advanced Example</small></a></k-filter-item>
+        <k-filter-item filter-keywords="table record hiding advanced example"><a href="./components/tableRecordHiding.html">Table — Record Hiding<br><small>Advanced Example</small></a></k-filter-item>
+        <k-filter-item filter-keywords="table record searching advanced example"><a href="./components/tableRecordSearching.html">Table — Record Searching<br><small>Advanced Example</small></a></k-filter-item>
+        <k-filter-item filter-keywords="table record selection advanced example"><a href="./components/tableRecordSelection.html">Table — Record Selection<br><small>Advanced Example</small></a></k-filter-item>
+        <k-filter-item filter-keywords="table row controls advanced example"><a href="./components/tableRowControls.html">Table — Row Controls<br><small>Advanced Example</small></a></k-filter-item>
+        <k-filter-item filter-keywords="table server sync advanced example"><a href="./components/tableServerSync.html">Table — Server Sync<br><small>Advanced Example</small></a></k-filter-item>
+        <k-filter-item filter-keywords="table sorting advanced example"><a href="./components/tableSorting.html">Table — Sorting<br><small>Advanced Example</small></a></k-filter-item>
+        <k-filter-item filter-keywords="tabs tab panel components"><a href="./components/tabs.html">Tabs<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="tags tag input components"><a href="./components/tags.html">Tags<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="toast notification alert components"><a href="./components/toast.html">Toast<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="theme switcher dark light components"><a href="./components/theme-switcher.html">Theme Switcher<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="timestamp date time components"><a href="./components/timestamp.html">Timestamp<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="toggle switch checkbox components"><a href="./components/toggle.html">Toggle<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="tree treeview components"><a href="./components/tree.html">Tree<br><small>Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="shadow component base"><a href="./components/shadow-component.html">Shadow Component<br><small>Base Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="light component base"><a href="./components/light-component.html">Light Component<br><small>Base Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="hybrid component base"><a href="./components/hybrid-component.html">Hybrid Component<br><small>Base Component</small></a></k-filter-item>
+        <k-filter-item filter-keywords="cookie utils utility"><a href="./utils/cookie.html">cookie<br><small>Utility</small></a></k-filter-item>
+        <k-filter-item filter-keywords="context utils utility"><a href="./utils/context.html">context<br><small>Utility</small></a></k-filter-item>
+        <k-filter-item filter-keywords="debounce utils utility"><a href="./utils/debounce.html">debounce<br><small>Utility</small></a></k-filter-item>
+        <k-filter-item filter-keywords="drag utils utility"><a href="./utils/drag.html">drag<br><small>Utility</small></a></k-filter-item>
+        <k-filter-item filter-keywords="formattimestamp timestamp format date time utils utility"><a href="./utils/formatTimestamp.html">formatTimestamp<br><small>Utility</small></a></k-filter-item>
+        <k-filter-item filter-keywords="object utils utility"><a href="./utils/object.html">object<br><small>Utility</small></a></k-filter-item>
+        <k-filter-item filter-keywords="propconverters prop converters utils utility"><a href="./utils/propConverters.html">propConverters<br><small>Utility</small></a></k-filter-item>
+        <k-filter-item filter-keywords="string utils utility"><a href="./utils/string.html">string<br><small>Utility</small></a></k-filter-item>
+        <k-filter-item filter-keywords="theme utils utility"><a href="./utils/theme.html">theme<br><small>Utility</small></a></k-filter-item>
+        <k-filter-item filter-keywords="type utils utility"><a href="./utils/type.html">type<br><small>Utility</small></a></k-filter-item>
+        <k-filter-item filter-keywords="wait async utils utility"><a href="./utils/wait.html">wait<br><small>Utility</small></a></k-filter-item>
+      </k-filter-list>
+    </div>
+  </div>
   <div class="flex"></div>
   <a href="https://github.com/dustinpoissant/kempo-ui?tab=License-1-ov-file#creative-commons-attribution-noncommercial-sharealike-20" target="_blank"><k-icon name="license"></k-icont></a>
   <a href="https://github.com/dustinpoissant/kempo-ui" target="_blank"><k-icon name="github-mark"></k-icont></a>
@@ -37,6 +98,7 @@
       <a href="./components/color-picker.html">ColorPicker</a>
       <a href="./components/content-slider.html">Content Slider</a>
       <a href="./components/dialog.html">Dialog</a>
+      <a href="./components/filter-list.html">Filter List</a>
       <a href="./components/focus-capture.html">FocusCapture</a>
       <a href="./components/html-editor.html">HTML Editor</a>
       <a href="./components/icon.html">Icon</a>
@@ -81,6 +143,13 @@
     </div>
   </menu>
 </k-side-menu>
+<style>
+#navSearchList a{display:block;padding:.25rem .5rem;border-radius:var(--radius);text-decoration:none;color:var(--tc);}
+#navSearchList a:hover{background:rgba(128,128,128,.15);}
+#navSearchList a small{display:block;color:var(--tc_muted);}
+</style>
+<script src="./src/components/FilterList.js" type="module"></script>
+<script src="./src/components/FilterItem.js" type="module"></script>
 <script src="./src/components/SideMenu.js" type="module"></script>
 <script src="./src/components/Icon.js" type="module"></script>
 <script src="./src/components/ThemeSwitcher.js" type="module"></script>

package/docs/nav.inc.js

@@ -1,16 +1,66 @@
+import debounce from './src/utils/debounce.js';
+
 document.getElementById('toggleNavSideMenu').addEventListener('click', async () => {
 	await window.customElements.whenDefined('k-side-menu');
 	document.getElementById('navSideMenu').toggle();
 });
+
 document.addEventListener('click', function(e) {
-	if (e.target.matches('a[href^="#"]')) {
+	if(e.target.matches('a[href^="#"]')) {
 		e.preventDefault();
 		const targetId = e.target.getAttribute('href').replace('#', '');
 		const target = document.getElementById(targetId);
-		if (target) {
+		if(target) {
 			target.scrollIntoView({ behavior: 'smooth' });
 			const url = window.location.pathname + window.location.search + '#' + targetId;
 			history.replaceState(null, '', url);
 		}
 	}
+});
+
+/*
+	Nav Search
+*/
+const searchInput = document.getElementById('navSearchInput');
+const searchDropdown = document.getElementById('navSearchDropdown');
+let navSearchList = null;
+
+const openSearch = async () => {
+	await customElements.whenDefined('k-filter-list');
+	if(!navSearchList) navSearchList = document.getElementById('navSearchList');
+	navSearchList.filter(searchInput.value);
+	searchDropdown.hidden = false;
+};
+
+const closeSearch = () => {
+	searchDropdown.hidden = true;
+};
+
+searchInput.addEventListener('focus', openSearch);
+
+searchInput.addEventListener('input', debounce(e => {
+	navSearchList?.filter(e.target.value);
+}, 150));
+
+searchInput.addEventListener('keydown', e => {
+	if(e.key === 'Escape') {
+		searchInput.value = '';
+		searchInput.blur();
+		closeSearch();
+	}
+});
+
+searchInput.addEventListener('blur', () => {
+	setTimeout(closeSearch, 150);
+});
+
+document.addEventListener('keydown', e => {
+	const active = document.activeElement;
+	const tag = active?.tagName;
+	if(tag === 'INPUT' || tag === 'TEXTAREA' || active?.isContentEditable) return;
+	if(e.metaKey || e.ctrlKey || e.altKey) return;
+	if(e.key.length === 1) {
+		searchInput.focus();
+		// Don't preventDefault — let the keystroke land in the input naturally
+	}
 });

package/docs/src/components/FilterItem.js

@@ -0,0 +1,8 @@
+import ShadowComponent from"./ShadowComponent.js";import{html,css}from"../lit-all.min.js";export default class FilterItem extends ShadowComponent{render(){return html`<slot></slot>`}static styles=css`
+		:host {
+			display: contents;
+		}
+		:host([hidden]) {
+			display: none !important;
+		}
+	`}customElements.define("k-filter-item",FilterItem);

package/docs/src/components/FilterList.js

@@ -0,0 +1,5 @@
+import ShadowComponent from"./ShadowComponent.js";import{html,css}from"../lit-all.min.js";export default class FilterList extends ShadowComponent{render(){return html`<slot></slot>`}filter(t){const e=t.toLowerCase().split(/\s+/).filter(t=>t.length>0);this.querySelectorAll("k-filter-item").forEach(t=>{const s=(t.getAttribute("filter-keywords")||"").toLowerCase();t.hidden=e.length>0&&!e.every(t=>s.includes(t))})}static styles=css`
+		:host {
+			display: block;
+		}
+	`}customElements.define("k-filter-list",FilterList);

package/icons/search.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 -960 960 960"><path fill="currentColor" d="M784-120 532-372q-30 24-69 38t-83 14q-109 0-184.5-75.5T120-580q0-109 75.5-184.5T380-840q109 0 184.5 75.5T640-580q0 44-14 83t-38 69l252 252-56 56ZM380-400q75 0 127.5-52.5T560-580q0-75-52.5-127.5T380-760q-75 0-127.5 52.5T200-580q0 75 52.5 127.5T380-400Z"/></svg>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kempo-ui",
-  "version": "0.0.80",
+  "version": "0.0.82",
   "type": "module",
   "description": "A Lit based web-component library",
   "main": "index.js",

package/src/components/FilterItem.js

@@ -0,0 +1,25 @@
+import ShadowComponent from './ShadowComponent.js';
+import { html, css } from '../lit-all.min.js';
+
+export default class FilterItem extends ShadowComponent {
+	/*
+		Rendering
+	*/
+	render() {
+		return html`<slot></slot>`;
+	}
+
+	/*
+		Styles
+	*/
+	static styles = css`
+		:host {
+			display: contents;
+		}
+		:host([hidden]) {
+			display: none !important;
+		}
+	`;
+}
+
+customElements.define('k-filter-item', FilterItem);

package/src/components/FilterList.js

@@ -0,0 +1,33 @@
+import ShadowComponent from './ShadowComponent.js';
+import { html, css } from '../lit-all.min.js';
+
+export default class FilterList extends ShadowComponent {
+	/*
+		Rendering
+	*/
+	render() {
+		return html`<slot></slot>`;
+	}
+
+	/*
+		Public Methods
+	*/
+	filter(term) {
+		const words = term.toLowerCase().split(/\s+/).filter(w => w.length > 0);
+		this.querySelectorAll('k-filter-item').forEach(item => {
+			const keywords = (item.getAttribute('filter-keywords') || '').toLowerCase();
+			item.hidden = words.length > 0 && !words.every(w => keywords.includes(w));
+		});
+	}
+
+	/*
+		Styles
+	*/
+	static styles = css`
+		:host {
+			display: block;
+		}
+	`;
+}
+
+customElements.define('k-filter-list', FilterList);

package/tests/components/FilterItem.browser-test.js

@@ -0,0 +1,104 @@
+import FilterItem from '../../src/components/FilterItem.js';
+
+const createFilterItem = async (content = 'item') => {
+	const container = document.createElement('div');
+	container.innerHTML = `<k-filter-item>${content}</k-filter-item>`;
+	document.body.appendChild(container);
+	const el = container.querySelector('k-filter-item');
+	await el.updateComplete;
+	return { container, el };
+};
+
+const cleanup = (container) => {
+	if(container && container.parentNode){
+		container.parentNode.removeChild(container);
+	}
+};
+
+export default {
+	/*
+		Element Creation
+	*/
+	'should create filter-item element': async ({pass, fail}) => {
+		const { container, el } = await createFilterItem();
+		if(!el){
+			cleanup(container);
+			return fail('k-filter-item element should be created');
+		}
+		if(!(el instanceof FilterItem)){
+			cleanup(container);
+			return fail('Element should be instance of FilterItem');
+		}
+		cleanup(container);
+		pass('FilterItem element created correctly');
+	},
+
+	'should have shadow root': async ({pass, fail}) => {
+		const { container, el } = await createFilterItem();
+		if(!el.shadowRoot){
+			cleanup(container);
+			return fail('FilterItem should have shadow root');
+		}
+		cleanup(container);
+		pass('FilterItem has shadow root');
+	},
+
+	/*
+		Visibility
+	*/
+	'should be visible by default': async ({pass, fail}) => {
+		const { container, el } = await createFilterItem();
+		if(el.hidden){
+			cleanup(container);
+			return fail('FilterItem should be visible by default');
+		}
+		cleanup(container);
+		pass('FilterItem is visible by default');
+	},
+
+	'setting hidden should hide the element': async ({pass, fail}) => {
+		const { container, el } = await createFilterItem();
+		el.hidden = true;
+		await el.updateComplete;
+		const style = getComputedStyle(el);
+		if(style.display !== 'none'){
+			cleanup(container);
+			return fail(`Expected display:none when hidden, got ${style.display}`);
+		}
+		cleanup(container);
+		pass('FilterItem is hidden when hidden attribute is set');
+	},
+
+	'removing hidden should show the element': async ({pass, fail}) => {
+		const { container, el } = await createFilterItem();
+		el.hidden = true;
+		await el.updateComplete;
+		el.hidden = false;
+		await el.updateComplete;
+		const style = getComputedStyle(el);
+		if(style.display === 'none'){
+			cleanup(container);
+			return fail('FilterItem should be visible after removing hidden');
+		}
+		cleanup(container);
+		pass('FilterItem is visible after removing hidden');
+	},
+
+	/*
+		filter-keywords attribute
+	*/
+	'should accept filter-keywords attribute': async ({pass, fail}) => {
+		const container = document.createElement('div');
+		container.innerHTML = `<k-filter-item filter-keywords="foo bar">content</k-filter-item>`;
+		document.body.appendChild(container);
+		const el = container.querySelector('k-filter-item');
+		await el.updateComplete;
+		const kw = el.getAttribute('filter-keywords');
+		if(kw !== 'foo bar'){
+			cleanup(container);
+			return fail(`Expected filter-keywords "foo bar", got "${kw}"`);
+		}
+		cleanup(container);
+		pass('filter-keywords attribute set correctly');
+	},
+};

package/tests/components/FilterList.browser-test.js

@@ -0,0 +1,162 @@
+import FilterList from '../../src/components/FilterList.js';
+import '../../src/components/FilterItem.js';
+
+const createFilterList = async (items = []) => {
+	const container = document.createElement('div');
+	container.innerHTML = `<k-filter-list>${items.map(kw => `<k-filter-item filter-keywords="${kw}">${kw}</k-filter-item>`).join('')}</k-filter-list>`;
+	document.body.appendChild(container);
+	const el = container.querySelector('k-filter-list');
+	await el.updateComplete;
+	return { container, el };
+};
+
+const cleanup = (container) => {
+	if(container && container.parentNode){
+		container.parentNode.removeChild(container);
+	}
+};
+
+export default {
+	/*
+		Element Creation
+	*/
+	'should create filter-list element': async ({pass, fail}) => {
+		const { container, el } = await createFilterList();
+		if(!el){
+			cleanup(container);
+			return fail('k-filter-list element should be created');
+		}
+		if(!(el instanceof FilterList)){
+			cleanup(container);
+			return fail('Element should be instance of FilterList');
+		}
+		cleanup(container);
+		pass('FilterList element created correctly');
+	},
+
+	'should have shadow root': async ({pass, fail}) => {
+		const { container, el } = await createFilterList();
+		if(!el.shadowRoot){
+			cleanup(container);
+			return fail('FilterList should have shadow root');
+		}
+		cleanup(container);
+		pass('FilterList has shadow root');
+	},
+
+	/*
+		filter() — empty term
+	*/
+	'filter("") should show all items': async ({pass, fail}) => {
+		const { container, el } = await createFilterList(['apple', 'banana', 'cherry']);
+		el.filter('');
+		const items = [...el.querySelectorAll('k-filter-item')];
+		const hidden = items.filter(i => i.hidden);
+		if(hidden.length !== 0){
+			cleanup(container);
+			return fail(`Expected 0 hidden items, got ${hidden.length}`);
+		}
+		cleanup(container);
+		pass('All items visible when term is empty');
+	},
+
+	/*
+		filter() — single word
+	*/
+	'filter("apple") should hide non-matching items': async ({pass, fail}) => {
+		const { container, el } = await createFilterList(['apple', 'banana', 'cherry']);
+		el.filter('apple');
+		const banana = el.querySelector('[filter-keywords="banana"]');
+		const cherry = el.querySelector('[filter-keywords="cherry"]');
+		if(!banana.hidden || !cherry.hidden){
+			cleanup(container);
+			return fail('Non-matching items should be hidden');
+		}
+		cleanup(container);
+		pass('Non-matching items are hidden');
+	},
+
+	'filter("apple") should show matching item': async ({pass, fail}) => {
+		const { container, el } = await createFilterList(['apple', 'banana', 'cherry']);
+		el.filter('apple');
+		const apple = el.querySelector('[filter-keywords="apple"]');
+		if(apple.hidden){
+			cleanup(container);
+			return fail('Matching item should not be hidden');
+		}
+		cleanup(container);
+		pass('Matching item is visible');
+	},
+
+	/*
+		filter() — multi-word (AND logic)
+	*/
+	'filter("apple pie") should require all words to match': async ({pass, fail}) => {
+		const { container, el } = await createFilterList(['apple pie', 'apple', 'pie']);
+		el.filter('apple pie');
+		const applePie = el.querySelector('[filter-keywords="apple pie"]');
+		const appleOnly = el.querySelector('[filter-keywords="apple"]');
+		const pieOnly = el.querySelector('[filter-keywords="pie"]');
+		if(applePie.hidden){
+			cleanup(container);
+			return fail('Item matching all words should be visible');
+		}
+		if(!appleOnly.hidden || !pieOnly.hidden){
+			cleanup(container);
+			return fail('Items matching only one word should be hidden');
+		}
+		cleanup(container);
+		pass('Multi-word filter requires all words to match');
+	},
+
+	/*
+		filter() — case insensitivity
+	*/
+	'filter() should be case-insensitive': async ({pass, fail}) => {
+		const { container, el } = await createFilterList(['Apple', 'banana']);
+		el.filter('APPLE');
+		const apple = el.querySelector('[filter-keywords="Apple"]');
+		if(apple.hidden){
+			cleanup(container);
+			return fail('Matching should be case-insensitive');
+		}
+		cleanup(container);
+		pass('filter() is case-insensitive');
+	},
+
+	/*
+		filter() — no keywords attribute
+	*/
+	'items with no filter-keywords should be hidden when term is provided': async ({pass, fail}) => {
+		const container = document.createElement('div');
+		container.innerHTML = `<k-filter-list><k-filter-item>no keywords</k-filter-item></k-filter-list>`;
+		document.body.appendChild(container);
+		const el = container.querySelector('k-filter-list');
+		await el.updateComplete;
+		el.filter('something');
+		const item = el.querySelector('k-filter-item');
+		if(!item.hidden){
+			cleanup(container);
+			return fail('Item with no keywords should be hidden when term is given');
+		}
+		cleanup(container);
+		pass('Item with no keywords is hidden when term is provided');
+	},
+
+	/*
+		filter() — restore all after filtering
+	*/
+	'filter("") after filtering should restore all items': async ({pass, fail}) => {
+		const { container, el } = await createFilterList(['apple', 'banana']);
+		el.filter('apple');
+		el.filter('');
+		const items = [...el.querySelectorAll('k-filter-item')];
+		const hidden = items.filter(i => i.hidden);
+		if(hidden.length !== 0){
+			cleanup(container);
+			return fail(`Expected all items visible after clearing filter, got ${hidden.length} hidden`);
+		}
+		cleanup(container);
+		pass('All items restored after clearing filter');
+	},
+};