@brightspot/ui 1.4.1 → 1.6.0

package/dist/storybook/assets/Popover.stories-CGkU0SGv.js

@@ -0,0 +1,431 @@
+import{g as c,x as r}from"./iframe-Dz6CxatW.js";import{o as d}from"./if-defined-CngSGyRu.js";import"./preload-helper-PPVm8Dsz.js";const{events:u,args:g,argTypes:t}=c("btu-popover"),h={title:"Components/Popover",component:"btu-popover",tags:["autodocs"],parameters:{docs:{subtitle:"Rich interactive content anchored to a trigger element",description:{component:`
+\`btu-popover\` displays rich interactive content anchored to a trigger element using CSS anchor positioning and the native Popover API.
+
+<h3>When to use:</h3>
+<ul>
+  <li>Confirmation dialogs anchored to a button</li>
+  <li>Rich preview cards on hover</li>
+  <li>Interactive forms or menus in a floating panel</li>
+</ul>
+
+<h3>When not to use:</h3>
+<ul>
+  <li>For simple text-only hints — use <a href="?path=/docs/components-tooltip--docs">Tooltip</a> instead</li>
+  <li>For status messages or inline feedback (use alerts or toasts)</li>
+</ul>
+
+<h3>Accessibility</h3>
+<ul>
+  <li><code>role="dialog"</code> on popover panel</li>
+  <li><code>aria-expanded</code> on trigger element</li>
+  <li><code>aria-controls</code> links trigger to panel</li>
+  <li>Escape key dismisses the popover</li>
+  <li>Click outside dismisses (click trigger only)</li>
+  <li>Focus restored to trigger on close</li>
+  <li>Add <code>autofocus</code> to an element inside <code>slot="content"</code> for auto-focus on open</li>
+</ul>
+        `}},actions:{handles:u},controls:{expanded:!0}},args:{...g,position:"bottom",trigger:"click",delay:300,open:!1},argTypes:{...t,position:{...t.position,control:{type:"select"},options:["top","bottom","left","right"]},trigger:{...t.trigger,control:{type:"select"},options:["click","hover","focus"]},delay:{...t.delay,control:{type:"number"},description:"Show delay in ms (hover trigger only)"},offset:{...t.offset,control:{type:"select"},options:["sm","md","lg","xl"],description:"Gap between trigger and popover (sm=4px, md=8px, lg=12px, xl=16px)"},open:{...t.open,control:{type:"boolean"},description:"Programmatic open/close (reflected)"},customBg:{name:"--popover-color-background",description:"Background color",control:{type:"color"},table:{category:"CSS Custom Properties",defaultValue:{summary:"white"}}},customTitleColor:{name:"--popover-color-title",description:"Title text color",control:{type:"color"},table:{category:"CSS Custom Properties",defaultValue:{summary:"oklch(var(--btu-theme-gray-900))"}}},customContentColor:{name:"--popover-color-content",description:"Content text color",control:{type:"color"},table:{category:"CSS Custom Properties",defaultValue:{summary:"oklch(var(--btu-theme-gray-900))"}}},customRadius:{name:"--popover-border-radius",description:"Border radius",control:{type:"select"},options:["0px","0.125rem","0.25rem","0.375rem","0.5rem","0.75rem","1rem","1.5rem","9999px"],labels:{"0px":"none (0px)","0.125rem":"sm (0.125rem)","0.25rem":"DEFAULT (0.25rem)","0.375rem":"md (0.375rem)","0.5rem":"lg (0.5rem)","0.75rem":"xl (0.75rem)","1rem":"2xl (1rem)","1.5rem":"3xl (1.5rem)","9999px":"full (9999px)"},table:{category:"CSS Custom Properties",defaultValue:{summary:"0.5rem (lg)"}}}},render:o=>{const e=[];o.customBg&&e.push(`--popover-color-background: ${o.customBg}`),o.customTitleColor&&e.push(`--popover-color-title: ${o.customTitleColor}`),o.customContentColor&&e.push(`--popover-color-content: ${o.customContentColor}`),o.customRadius&&e.push(`--popover-border-radius: ${o.customRadius}`);const a=e.length>0?e.join("; "):"";return r`
+      <div style="display: flex; justify-content: center; padding: 6rem 2rem;">
+        <div style="${a}">
+          <btu-popover
+            position="${o.position}"
+            trigger="${o.trigger}"
+            delay="${o.delay}"
+            offset="${d(o.offset)}"
+            ?no-arrow="${o.noArrow}"
+            ?open="${o.open}"
+          >
+            <button class="popover-trigger" slot="trigger">
+              ${o.trigger==="hover"?"Hover me":o.trigger==="focus"?"Focus me":"Click me"}
+            </button>
+            <div slot="content">
+              <div style="font-weight: 500; margin-bottom: 4px; color: var(--popover-color-title);">Popover Title</div>
+              <div style="color: var(--popover-color-content, oklch(var(--btu-theme-gray-900)));">
+                This is a popover with rich content.
+                ${o.trigger==="click"?"Click outside or press Escape to dismiss.":""}
+              </div>
+            </div>
+          </btu-popover>
+        </div>
+      </div>
+    `}},p=`
+  .popover-trigger {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    padding: 0.5rem 1rem;
+    border-radius: 0.375rem;
+    background-color: oklch(var(--btu-theme-gray-100));
+    color: oklch(var(--btu-theme-gray-700));
+    font-weight: 500;
+    font-size: 0.875rem;
+    cursor: pointer;
+    user-select: none;
+    border: 1px solid oklch(var(--btu-theme-gray-200));
+  }
+  .popover-trigger:hover {
+    background-color: oklch(var(--btu-theme-gray-200));
+  }
+`,n={args:{noArrow:!1,offset:void 0},decorators:[o=>r`<style>
+          ${p}</style
+        >${o()}`]},i={render:()=>r`
+    <style>
+      ${p}
+    </style>
+    <div style="display: flex; gap: 2rem; justify-content: center; padding: 6rem 2rem; flex-wrap: wrap;">
+      <btu-popover position="top">
+        <button class="popover-trigger" slot="trigger">Top</button>
+        <div slot="content">Popover positioned above the trigger</div>
+      </btu-popover>
+      <btu-popover position="bottom">
+        <button class="popover-trigger" slot="trigger">Bottom</button>
+        <div slot="content">Popover positioned below the trigger</div>
+      </btu-popover>
+      <btu-popover position="left">
+        <button class="popover-trigger" slot="trigger">Left</button>
+        <div slot="content">Popover positioned left of the trigger</div>
+      </btu-popover>
+      <btu-popover position="right">
+        <button class="popover-trigger" slot="trigger">Right</button>
+        <div slot="content">Popover positioned right of the trigger</div>
+      </btu-popover>
+    </div>
+  `,parameters:{docs:{description:{story:"Popovers support four positions: `top`, `bottom`, `left`, and `right`. Each auto-flips if constrained by the viewport."},story:{inline:!1,iframeHeight:300}}}},s={render:()=>r`
+    <style>
+      ${p} .popover-custom-content {
+        display: flex;
+        flex-direction: column;
+        gap: 12px;
+        min-width: 240px;
+      }
+      .popover-custom-content h3 {
+        margin: 0;
+        font-size: 0.9375rem;
+        font-weight: 600;
+      }
+      .popover-custom-content p {
+        margin: 0;
+        font-size: 0.8125rem;
+        color: oklch(var(--btu-theme-gray-500));
+        line-height: 1.4;
+      }
+      .popover-custom-content .actions {
+        display: flex;
+        gap: 8px;
+        justify-content: flex-end;
+        padding-top: 4px;
+        border-top: 1px solid oklch(var(--btu-theme-gray-100));
+      }
+      .legend-series {
+        display: flex;
+        flex-direction: column;
+        gap: 2px;
+      }
+      .legend-item {
+        display: flex;
+        align-items: center;
+        gap: 4px;
+        font-size: 0.75rem;
+        line-height: 1.125rem;
+        color: oklch(var(--btu-theme-gray-500));
+      }
+      .legend-dot {
+        width: 8px;
+        height: 8px;
+        border-radius: 9999px;
+        flex-shrink: 0;
+      }
+      .legend-value {
+        font-weight: 600;
+      }
+    </style>
+    <div style="display: flex; gap: 2rem; justify-content: center; padding: 6rem 2rem; flex-wrap: wrap;">
+      <btu-popover position="bottom">
+        <button class="btu-button btu-button-error" slot="trigger">Delete item</button>
+        <div slot="content">
+          <div class="popover-custom-content">
+            <h3>Confirm Delete</h3>
+            <p>Are you sure you want to delete this item? This action cannot be undone.</p>
+            <div class="actions">
+              <button class="btu-button btu-button-warning btu-button-xs">Cancel</button>
+              <button class="btu-button btu-button-error btu-button-xs btu-button-fill-none">Delete</button>
+            </div>
+          </div>
+        </div>
+      </btu-popover>
+      <btu-popover trigger="hover" delay="200" position="bottom">
+        <button class="btu-button btu-button-primary" slot="trigger">Hover for chart data</button>
+        <div slot="content">
+          <div
+            style="font-weight: 500; font-size: 0.75rem; line-height: 1.125rem; color: oklch(var(--btu-theme-gray-900)); margin-bottom: 8px;"
+          >
+            Chart Legend
+          </div>
+          <div class="legend-series">
+            <div class="legend-item">
+              <span class="legend-dot" style="background: oklch(var(--btu-theme-primary-900));"></span>
+              Series 1: <span class="legend-value">786</span>
+            </div>
+            <div class="legend-item">
+              <span class="legend-dot" style="background: oklch(var(--btu-theme-primary-700));"></span>
+              Series 2: <span class="legend-value">786</span>
+            </div>
+            <div class="legend-item">
+              <span class="legend-dot" style="background: oklch(var(--btu-theme-primary-500));"></span>
+              Series 3: <span class="legend-value">786</span>
+            </div>
+            <div class="legend-item">
+              <span class="legend-dot" style="background: oklch(var(--btu-theme-teal-700));"></span>
+              Series 4: <span class="legend-value">786</span>
+            </div>
+          </div>
+        </div>
+      </btu-popover>
+    </div>
+  `,parameters:{docs:{description:{story:"Two examples of rich popover content: a confirmation dialog with action buttons (click trigger), and a chart legend with colored series data (hover trigger)."},story:{inline:!1,iframeHeight:300}}}},l={render:()=>r`
+    <style>
+      ${p} .custom-popover-trigger {
+        display: inline-flex;
+        align-items: center;
+        justify-content: center;
+        padding: 0.5rem 1rem;
+        border-radius: 0.375rem;
+        background-color: oklch(0.35 0.1 280);
+        color: white;
+        font-weight: 500;
+        font-size: 0.875rem;
+        cursor: pointer;
+        user-select: none;
+        border: 1px solid oklch(0.45 0.1 280);
+      }
+      .custom-popover-trigger:hover {
+        background-color: oklch(0.4 0.1 280);
+      }
+    </style>
+    <div style="display: flex; justify-content: center; padding: 6rem 2rem;">
+      <div
+        style="--popover-color-background: oklch(0.25 20.05 280); --popover-color-title: oklch(0.95 0 0); --popover-color-content: oklch(0.8 120 50); --popover-border-radius: 0px;"
+      >
+        <btu-popover position="bottom" offset="lg" no-arrow>
+          <button class="custom-popover-trigger" slot="trigger">Fully customized</button>
+          <div slot="content">
+            <div style="font-weight: 600; font-size: 1rem; margin-bottom: 8px; color: var(--popover-color-title);">
+              Custom Styled Popover
+            </div>
+            <div style="line-height: 1.5; color: var(--popover-color-content);">
+              This popover overrides all available CSS custom properties: background, title color, and border radius. It
+              also uses
+              <code style="background: oklch(0.35 0.05 280); padding: 2px 6px; border-radius: 4px;">offset="lg"</code>
+              for extra spacing and
+              <code style="background: oklch(0.35 0.05 280); padding: 2px 6px; border-radius: 4px;">no-arrow</code> for
+              a clean look.
+            </div>
+          </div>
+        </btu-popover>
+      </div>
+    </div>
+  `,parameters:{docs:{description:{story:"Demonstrates full customization of all CSS custom properties. Set these on a parent element or directly on the component:\n\n- `--popover-color-background` — Background color\n- `--popover-color-title` — Title text color\n- `--popover-color-content` — Content text color\n- `--popover-border-radius` — Border radius"}}}};n.parameters={...n.parameters,docs:{...n.parameters?.docs,source:{originalSource:`{
+  args: {
+    noArrow: false,
+    offset: undefined
+  },
+  decorators: [story => html\`<style>
+          \${triggerStyle}</style
+        >\${story()}\`]
+}`,...n.parameters?.docs?.source}}};i.parameters={...i.parameters,docs:{...i.parameters?.docs,source:{originalSource:`{
+  render: () => html\`
+    <style>
+      \${triggerStyle}
+    </style>
+    <div style="display: flex; gap: 2rem; justify-content: center; padding: 6rem 2rem; flex-wrap: wrap;">
+      <btu-popover position="top">
+        <button class="popover-trigger" slot="trigger">Top</button>
+        <div slot="content">Popover positioned above the trigger</div>
+      </btu-popover>
+      <btu-popover position="bottom">
+        <button class="popover-trigger" slot="trigger">Bottom</button>
+        <div slot="content">Popover positioned below the trigger</div>
+      </btu-popover>
+      <btu-popover position="left">
+        <button class="popover-trigger" slot="trigger">Left</button>
+        <div slot="content">Popover positioned left of the trigger</div>
+      </btu-popover>
+      <btu-popover position="right">
+        <button class="popover-trigger" slot="trigger">Right</button>
+        <div slot="content">Popover positioned right of the trigger</div>
+      </btu-popover>
+    </div>
+  \`,
+  parameters: {
+    docs: {
+      description: {
+        story: 'Popovers support four positions: \`top\`, \`bottom\`, \`left\`, and \`right\`. Each auto-flips if constrained by the viewport.'
+      },
+      story: {
+        inline: false,
+        iframeHeight: 300
+      }
+    }
+  }
+}`,...i.parameters?.docs?.source}}};s.parameters={...s.parameters,docs:{...s.parameters?.docs,source:{originalSource:`{
+  render: () => html\`
+    <style>
+      \${triggerStyle} .popover-custom-content {
+        display: flex;
+        flex-direction: column;
+        gap: 12px;
+        min-width: 240px;
+      }
+      .popover-custom-content h3 {
+        margin: 0;
+        font-size: 0.9375rem;
+        font-weight: 600;
+      }
+      .popover-custom-content p {
+        margin: 0;
+        font-size: 0.8125rem;
+        color: oklch(var(--btu-theme-gray-500));
+        line-height: 1.4;
+      }
+      .popover-custom-content .actions {
+        display: flex;
+        gap: 8px;
+        justify-content: flex-end;
+        padding-top: 4px;
+        border-top: 1px solid oklch(var(--btu-theme-gray-100));
+      }
+      .legend-series {
+        display: flex;
+        flex-direction: column;
+        gap: 2px;
+      }
+      .legend-item {
+        display: flex;
+        align-items: center;
+        gap: 4px;
+        font-size: 0.75rem;
+        line-height: 1.125rem;
+        color: oklch(var(--btu-theme-gray-500));
+      }
+      .legend-dot {
+        width: 8px;
+        height: 8px;
+        border-radius: 9999px;
+        flex-shrink: 0;
+      }
+      .legend-value {
+        font-weight: 600;
+      }
+    </style>
+    <div style="display: flex; gap: 2rem; justify-content: center; padding: 6rem 2rem; flex-wrap: wrap;">
+      <btu-popover position="bottom">
+        <button class="btu-button btu-button-error" slot="trigger">Delete item</button>
+        <div slot="content">
+          <div class="popover-custom-content">
+            <h3>Confirm Delete</h3>
+            <p>Are you sure you want to delete this item? This action cannot be undone.</p>
+            <div class="actions">
+              <button class="btu-button btu-button-warning btu-button-xs">Cancel</button>
+              <button class="btu-button btu-button-error btu-button-xs btu-button-fill-none">Delete</button>
+            </div>
+          </div>
+        </div>
+      </btu-popover>
+      <btu-popover trigger="hover" delay="200" position="bottom">
+        <button class="btu-button btu-button-primary" slot="trigger">Hover for chart data</button>
+        <div slot="content">
+          <div
+            style="font-weight: 500; font-size: 0.75rem; line-height: 1.125rem; color: oklch(var(--btu-theme-gray-900)); margin-bottom: 8px;"
+          >
+            Chart Legend
+          </div>
+          <div class="legend-series">
+            <div class="legend-item">
+              <span class="legend-dot" style="background: oklch(var(--btu-theme-primary-900));"></span>
+              Series 1: <span class="legend-value">786</span>
+            </div>
+            <div class="legend-item">
+              <span class="legend-dot" style="background: oklch(var(--btu-theme-primary-700));"></span>
+              Series 2: <span class="legend-value">786</span>
+            </div>
+            <div class="legend-item">
+              <span class="legend-dot" style="background: oklch(var(--btu-theme-primary-500));"></span>
+              Series 3: <span class="legend-value">786</span>
+            </div>
+            <div class="legend-item">
+              <span class="legend-dot" style="background: oklch(var(--btu-theme-teal-700));"></span>
+              Series 4: <span class="legend-value">786</span>
+            </div>
+          </div>
+        </div>
+      </btu-popover>
+    </div>
+  \`,
+  parameters: {
+    docs: {
+      description: {
+        story: 'Two examples of rich popover content: a confirmation dialog with action buttons (click trigger), and a chart legend with colored series data (hover trigger).'
+      },
+      story: {
+        inline: false,
+        iframeHeight: 300
+      }
+    }
+  }
+}`,...s.parameters?.docs?.source}}};l.parameters={...l.parameters,docs:{...l.parameters?.docs,source:{originalSource:`{
+  render: () => html\`
+    <style>
+      \${triggerStyle} .custom-popover-trigger {
+        display: inline-flex;
+        align-items: center;
+        justify-content: center;
+        padding: 0.5rem 1rem;
+        border-radius: 0.375rem;
+        background-color: oklch(0.35 0.1 280);
+        color: white;
+        font-weight: 500;
+        font-size: 0.875rem;
+        cursor: pointer;
+        user-select: none;
+        border: 1px solid oklch(0.45 0.1 280);
+      }
+      .custom-popover-trigger:hover {
+        background-color: oklch(0.4 0.1 280);
+      }
+    </style>
+    <div style="display: flex; justify-content: center; padding: 6rem 2rem;">
+      <div
+        style="--popover-color-background: oklch(0.25 20.05 280); --popover-color-title: oklch(0.95 0 0); --popover-color-content: oklch(0.8 120 50); --popover-border-radius: 0px;"
+      >
+        <btu-popover position="bottom" offset="lg" no-arrow>
+          <button class="custom-popover-trigger" slot="trigger">Fully customized</button>
+          <div slot="content">
+            <div style="font-weight: 600; font-size: 1rem; margin-bottom: 8px; color: var(--popover-color-title);">
+              Custom Styled Popover
+            </div>
+            <div style="line-height: 1.5; color: var(--popover-color-content);">
+              This popover overrides all available CSS custom properties: background, title color, and border radius. It
+              also uses
+              <code style="background: oklch(0.35 0.05 280); padding: 2px 6px; border-radius: 4px;">offset="lg"</code>
+              for extra spacing and
+              <code style="background: oklch(0.35 0.05 280); padding: 2px 6px; border-radius: 4px;">no-arrow</code> for
+              a clean look.
+            </div>
+          </div>
+        </btu-popover>
+      </div>
+    </div>
+  \`,
+  parameters: {
+    docs: {
+      description: {
+        story: \`Demonstrates full customization of all CSS custom properties. Set these on a parent element or directly on the component:
+
+- \\\`--popover-color-background\\\` — Background color
+- \\\`--popover-color-title\\\` — Title text color
+- \\\`--popover-color-content\\\` — Content text color
+- \\\`--popover-border-radius\\\` — Border radius\`
+      }
+    }
+  }
+}`,...l.parameters?.docs?.source}}};const y=["Default","Positions","RichContent","AdvancedUsage"];export{l as AdvancedUsage,n as Default,i as Positions,s as RichContent,y as __namedExportsOrder,h as default};

package/dist/storybook/assets/ReadyMixin-3YCzoG6W.js

@@ -0,0 +1 @@
+import"./iframe-Dz6CxatW.js";const i=t=>{class n extends t{connectedCallback(){super.connectedCallback(),Promise.resolve().then(()=>this.emit("btu-element-connected",{}),e=>this.emit("btu-element-error",{error:e}))}disconnectedCallback(){super.disconnectedCallback(),this.emit("btu-element-disconnected")}emit(e,c){return this.dispatchEvent(new CustomEvent(e,{bubbles:!0,cancelable:!1,composed:!0,detail:c}))}}return n},l=t=>{class n extends t{connectedCallback(){const e=()=>{super.connectedCallback()};document.readyState!=="loading"?e():document.addEventListener("DOMContentLoaded",()=>e())}}return n};export{i as E,l as R};

package/dist/storybook/assets/{Rtc.stories-19d7WXe4.js → Rtc.stories-Y1MYTWAt.js}

@@ -1,4 +1,4 @@
-import{x as o}from"./iframe-Bl9oHz5c.js";import"./preload-helper-PPVm8Dsz.js";const r={title:"Utilities/RTC",tags:["autodocs"],parameters:{docs:{subtitle:"The `rtc` module provides real-time communication between browser tabs and the Brightspot CMS server. Uses BroadcastChannel for cross-tab coordination with leader election, and Server-Sent Events for server communication."},controls:{expanded:!0}}},e={render:()=>o`
+import{x as o}from"./iframe-Dz6CxatW.js";import"./preload-helper-PPVm8Dsz.js";const r={title:"Utilities/RTC",tags:["autodocs"],parameters:{docs:{subtitle:"The `rtc` module provides real-time communication between browser tabs and the Brightspot CMS server. Uses BroadcastChannel for cross-tab coordination with leader election, and Server-Sent Events for server communication."},controls:{expanded:!0}}},e={render:()=>o`
     <div class="space-y-6 text-sm">
       <div>
         <h3 class="mb-2 font-bold">Overview</h3>

package/dist/storybook/assets/{ScrollShadow.stories-BFjracVd.js → ScrollShadow.stories-B9kSpLT1.js}

@@ -1,4 +1,4 @@
-import{x as a}from"./iframe-Bl9oHz5c.js";import"./preload-helper-PPVm8Dsz.js";const l=({theme:e="btu-scrollshadow-25"})=>{const r=new Array(100).fill(0).map((s,t)=>`Item ${t+1}`);return a`
+import{x as a}from"./iframe-Dz6CxatW.js";import"./preload-helper-PPVm8Dsz.js";const l=({theme:e="btu-scrollshadow-25"})=>{const r=new Array(100).fill(0).map((s,t)=>`Item ${t+1}`);return a`
     <style>
       :root {
         --can-scroll:   ;

package/dist/storybook/assets/{Throttle.stories-DD6ydiVq.js → Throttle.stories-BgvLDrS3.js}

@@ -1,4 +1,4 @@
-import{x as u}from"./iframe-Bl9oHz5c.js";import"./preload-helper-PPVm8Dsz.js";function v(e,t){if(e<=0)return t;let n,o=0;return function(){if(n)return;const r=Date.now(),s=e-r+o;s<=0?(o=r,t.apply(this,[...arguments])):n=setTimeout(()=>{o=r,n=void 0,t.apply(this,[...arguments])},s)}}const x={title:"Utilities/Throttle",tags:["autodocs"],parameters:{docs:{subtitle:"The `throttle` utility function limits how often a function can execute, ensuring it runs at most once per specified interval. Useful for high-frequency events like scroll, resize, or mousemove."},controls:{expanded:!0}},argTypes:{interval:{control:{type:"number",min:0,max:2e3,step:50},description:"Throttle interval in milliseconds"}},args:{interval:200}},d={render:e=>{const t=`throttle-${Math.random().toString(36).substring(2,9)}`;let n=0,o=0;const r=()=>{const h=document.getElementById(`${t}-normal-count`),m=document.getElementById(`${t}-throttled-count`);h&&(h.textContent=String(n)),m&&(m.textContent=String(o))},s=v(e.interval,()=>{o++,r()}),a=()=>{n++,r()},l=()=>{a(),s()};return u`
+import{x as u}from"./iframe-Dz6CxatW.js";import"./preload-helper-PPVm8Dsz.js";function v(e,t){if(e<=0)return t;let n,o=0;return function(){if(n)return;const r=Date.now(),s=e-r+o;s<=0?(o=r,t.apply(this,[...arguments])):n=setTimeout(()=>{o=r,n=void 0,t.apply(this,[...arguments])},s)}}const x={title:"Utilities/Throttle",tags:["autodocs"],parameters:{docs:{subtitle:"The `throttle` utility function limits how often a function can execute, ensuring it runs at most once per specified interval. Useful for high-frequency events like scroll, resize, or mousemove."},controls:{expanded:!0}},argTypes:{interval:{control:{type:"number",min:0,max:2e3,step:50},description:"Throttle interval in milliseconds"}},args:{interval:200}},d={render:e=>{const t=`throttle-${Math.random().toString(36).substring(2,9)}`;let n=0,o=0;const r=()=>{const h=document.getElementById(`${t}-normal-count`),m=document.getElementById(`${t}-throttled-count`);h&&(h.textContent=String(n)),m&&(m.textContent=String(o))},s=v(e.interval,()=>{o++,r()}),a=()=>{n++,r()},l=()=>{a(),s()};return u`
       <div class="space-y-4">
         <div class="text-base">
           <p class="mb-2">

package/dist/storybook/assets/Tooltip.stories-POo1M-ew.js

@@ -0,0 +1,143 @@
+import{f as v,u as x,x as c,i as w}from"./iframe-Dz6CxatW.js";import{t as E}from"./custom-element-UsVr97OX.js";import{o as T}from"./if-defined-CngSGyRu.js";import{E as k,R as C}from"./ReadyMixin-3YCzoG6W.js";import"./preload-helper-PPVm8Dsz.js";const S={attribute:!0,type:String,converter:x,reflect:!1,hasChanged:v},L=(o=S,i,s)=>{const{kind:t,metadata:e}=s;let l=globalThis.litPropertyMetadata.get(e);if(l===void 0&&globalThis.litPropertyMetadata.set(e,l=new Map),t==="setter"&&((o=Object.create(o)).wrapped=!0),l.set(s.name,o),t==="accessor"){const{name:r}=s;return{set(n){const g=i.get.call(this);i.set.call(this,n),this.requestUpdate(r,g,o)},init(n){return n!==void 0&&this.C(r,void 0,o,n),n}}}if(t==="setter"){const{name:r}=s;return function(n){const g=this[r];i.call(this,n),this.requestUpdate(r,g,o)}}throw Error("Unsupported decorator location: "+t)};function p(o){return(i,s)=>typeof s=="object"?L(o,i,s):((t,e,l)=>{const r=e.hasOwnProperty(l);return e.constructor.createProperty(l,t),r?Object.getOwnPropertyDescriptor(e,l):void 0})(o,i,s)}var D=Object.defineProperty,a=(o,i,s,t)=>{for(var e=void 0,l=o.length-1,r;l>=0;l--)(r=o[l])&&(e=r(i,s,e)||e);return e&&D(i,s,e),e};const A={top:"btu-tooltip-top",bottom:"btu-tooltip-bottom",left:"btu-tooltip-left",right:"btu-tooltip-right"},_={sm:"btu-tooltip-offset-sm",md:"btu-tooltip-offset-md",lg:"btu-tooltip-offset-lg",xl:"btu-tooltip-offset-xl"},M=o=>{class i extends o{constructor(){super(...arguments),this.tooltip="",this.tooltipPosition="top",this.tooltipDelay=300,this.tooltipOffset=null,this.tooltipNoArrow=!1,this.tooltipTrigger="hover focus",this._tooltipEl=null,this._tooltipId=`btu-tooltip-${crypto.randomUUID()}`,this._anchorName=`--btu-trigger-${crypto.randomUUID()}`,this._showTimer=null,this._isVisible=!1,this._activeTriggers=new Set,this._onMouseEnter=this._handleMouseEnter.bind(this),this._onMouseLeave=this._handleMouseLeave.bind(this),this._onFocusIn=this._handleFocusIn.bind(this),this._onFocusOut=this._handleFocusOut.bind(this),this._onClick=this._handleClick.bind(this),this._onNativeToggle=this._handleNativeToggle.bind(this),this._onKeyDown=this._handleKeyDown.bind(this),this._onDocumentClick=null}connectedCallback(){super.connectedCallback(),this._bindTriggerListeners()}disconnectedCallback(){if(this._clearShowTimer(),this._removeDocumentClickListener(),this._unbindTriggerListeners(),this._tooltipEl){try{this._tooltipEl.hidePopover()}catch(t){t instanceof DOMException&&t.name==="InvalidStateError"||console.warn("[btu-tooltip] Failed to hide tooltip during disconnect:",t)}this._tooltipEl.removeEventListener("toggle",this._onNativeToggle),this._tooltipEl.remove(),this._tooltipEl=null}this._removeAriaDescribedBy(),this.style.removeProperty("anchor-name"),this._isVisible=!1,super.disconnectedCallback()}updated(t){super.updated(t),t.has("tooltipTrigger")&&(this._unbindTriggerListeners(),this._bindTriggerListeners(),this._tooltipEl&&(this._isVisible&&this._hide(),this._tooltipEl.setAttribute("popover",this._getPopoverMode()))),(t.has("tooltip")||t.has("tooltipPosition")||t.has("tooltipDelay")||t.has("tooltipOffset")||t.has("tooltipNoArrow"))&&this._syncTooltipElement()}_getPopoverMode(){return"manual"}_syncTooltipElement(){if(!this.tooltip){this._tooltipEl&&(this._hide(),this._tooltipEl.removeEventListener("toggle",this._onNativeToggle),this._tooltipEl.remove(),this._tooltipEl=null,this._removeAriaDescribedBy(),this.style.removeProperty("anchor-name"),document.removeEventListener("keydown",this._onKeyDown));return}this.style.setProperty("anchor-name",this._anchorName),this._tooltipEl||(this._tooltipEl=this._createTooltipElement(),this.appendChild(this._tooltipEl),this._appendAriaDescribedBy(),document.addEventListener("keydown",this._onKeyDown)),this._tooltipEl.textContent=this.tooltip,this._tooltipEl.className=this._buildTooltipClasses()}_createTooltipElement(){const t=document.createElement("div");return t.id=this._tooltipId,t.className=this._buildTooltipClasses(),t.setAttribute("role","tooltip"),t.setAttribute("data-tooltip-internal",""),t.setAttribute("popover",this._getPopoverMode()),t.style.setProperty("position-anchor",this._anchorName),t.textContent=this.tooltip,t.addEventListener("toggle",this._onNativeToggle),t}_buildTooltipClasses(){const t=["btu-tooltip",A[this.tooltipPosition]];return this.tooltipOffset&&_[this.tooltipOffset]&&t.push(_[this.tooltipOffset]),this.tooltipNoArrow&&t.push("btu-tooltip-no-arrow"),t.join(" ")}_hasTrigger(t){return this._activeTriggers.has(t)}_bindTriggerListeners(){const t=new Set(["hover","focus","click"]);this._activeTriggers=new Set(this.tooltipTrigger.trim().split(/\s+/));for(const e of this._activeTriggers)t.has(e)||console.warn(`[btu-tooltip] Unrecognized tooltip-trigger value: "${e}". Valid values: hover, focus, click.`);this._hasTrigger("hover")&&(this.addEventListener("mouseenter",this._onMouseEnter),this.addEventListener("mouseleave",this._onMouseLeave)),this._hasTrigger("focus")&&(this.addEventListener("focusin",this._onFocusIn),this.addEventListener("focusout",this._onFocusOut)),this._hasTrigger("click")&&this.addEventListener("click",this._onClick)}_unbindTriggerListeners(){this.removeEventListener("mouseenter",this._onMouseEnter),this.removeEventListener("mouseleave",this._onMouseLeave),this.removeEventListener("focusin",this._onFocusIn),this.removeEventListener("focusout",this._onFocusOut),this.removeEventListener("click",this._onClick),document.removeEventListener("keydown",this._onKeyDown)}_show(){if(!(this._isVisible||!this._tooltipEl)){try{this._tooltipEl.showPopover()}catch(t){t instanceof DOMException&&t.name==="InvalidStateError"||console.warn("[btu-tooltip] Failed to show tooltip:",t)}this._hasTrigger("click")&&setTimeout(()=>{this._removeDocumentClickListener(),this._onDocumentClick=t=>{const e=t.composedPath();!e.includes(this)&&(!this._tooltipEl||!e.includes(this._tooltipEl))&&this._hide()},document.addEventListener("click",this._onDocumentClick)},0)}}_hide(){if(this._clearShowTimer(),this._removeDocumentClickListener(),!(!this._isVisible||!this._tooltipEl))try{this._tooltipEl.hidePopover()}catch(t){t instanceof DOMException&&t.name==="InvalidStateError"||console.warn("[btu-tooltip] Failed to hide tooltip:",t)}}_removeDocumentClickListener(){this._onDocumentClick&&(document.removeEventListener("click",this._onDocumentClick),this._onDocumentClick=null)}_handleNativeToggle(t){const{newState:e}=t;this._isVisible=e==="open",this.dispatchEvent(new CustomEvent(this._isVisible?"btu-tooltip-show":"btu-tooltip-hide",{bubbles:!0,composed:!0}))}_handleKeyDown(t){t.key==="Escape"&&(this._clearShowTimer(),this._hide())}_clearShowTimer(){this._showTimer!==null&&(clearTimeout(this._showTimer),this._showTimer=null)}_handleMouseEnter(){this._clearShowTimer(),this._showTimer=setTimeout(()=>{this._show()},this.tooltipDelay)}_handleMouseLeave(){this._clearShowTimer(),this._hide()}_handleFocusIn(){this._clearShowTimer(),this._show()}_handleFocusOut(){this._clearShowTimer(),this._hide()}_handleClick(){this._clearShowTimer(),this._isVisible?this._hide():this._show()}_appendAriaDescribedBy(){const t=this.getAttribute("aria-describedby");t?t.includes(this._tooltipId)||this.setAttribute("aria-describedby",`${t} ${this._tooltipId}`):this.setAttribute("aria-describedby",this._tooltipId)}_removeAriaDescribedBy(){const t=this.getAttribute("aria-describedby");if(!t)return;const e=t.split(/\s+/).filter(l=>l!==this._tooltipId).join(" ").trim();e?this.setAttribute("aria-describedby",e):this.removeAttribute("aria-describedby")}}return a([p({attribute:"tooltip"})],i.prototype,"tooltip"),a([p({attribute:"tooltip-position"})],i.prototype,"tooltipPosition"),a([p({attribute:"tooltip-delay",type:Number})],i.prototype,"tooltipDelay"),a([p({attribute:"tooltip-offset"})],i.prototype,"tooltipOffset"),a([p({attribute:"tooltip-no-arrow",type:Boolean})],i.prototype,"tooltipNoArrow"),a([p({attribute:"tooltip-trigger"})],i.prototype,"tooltipTrigger"),i};var O=Object.defineProperty,P=Object.getOwnPropertyDescriptor,y=(o,i,s,t)=>{for(var e=t>1?void 0:t?P(i,s):i,l=o.length-1,r;l>=0;l--)(r=o[l])&&(e=(t?r(i,s,e):r(e))||e);return t&&e&&O(i,s,e),e};let b=class extends M(k(C(w))){constructor(){super(...arguments),this.label="Hover me",this.initialClasses=[]}connectedCallback(){super.connectedCallback(),this.className&&(this.initialClasses=this.className.split(" ").filter(o=>o.trim()))}createRenderRoot(){return this}willUpdate(){const o=[...this.initialClasses,"tooltip-demo"];this.className=o.filter(Boolean).join(" ")}render(){return c`${this.label}`}};y([p({type:String})],b.prototype,"label",2);b=y([E("tooltip-demo")],b);const f=`
+  .tooltip-demo {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    padding: 0.5rem 1rem;
+    border-radius: 0.375rem;
+    background-color: oklch(var(--btu-theme-gray-100));
+    color: oklch(var(--btu-theme-gray-700));
+    font-weight: 500;
+    font-size: 0.875rem;
+    cursor: default;
+    user-select: none;
+  }
+`,F={title:"Mixins/Tooltip",tags:["autodocs"],parameters:{docs:{subtitle:"Declarative tooltip support for any LitElement component",description:{component:`
+\`TooltipMixin\` adds declarative tooltip support to any LitElement component using CSS anchor positioning and the Popover API.
+
+<h3>Opt-in Pattern</h3>
+
+\`\`\`typescript
+class MyComponent extends TooltipMixin(EventEmitterMixin(ReadyMixin(LitElement))) {
+  // Component now supports tooltip attributes
+}
+\`\`\`
+
+\`\`\`html
+<my-component tooltip="Hello!" tooltip-position="bottom"></my-component>
+\`\`\`
+
+<h3>Accessibility</h3>
+<ul>
+  <li><code>role="tooltip"</code> on tooltip element</li>
+  <li><code>aria-describedby</code> on host links to tooltip (appends to existing value)</li>
+  <li>Shows on <code>focusin</code>, hides on <code>focusout</code> and <code>Escape</code></li>
+  <li><code>prefers-reduced-motion: reduce</code> disables slide animation</li>
+</ul>
+        `}},controls:{expanded:!0}},args:{tooltip:"This is a tooltip","tooltip-position":"top","tooltip-delay":300,"tooltip-no-arrow":!1,"tooltip-trigger":"hover focus",label:"Hover me"},argTypes:{tooltip:{control:{type:"text"},description:"Tooltip text. No tooltip rendered when empty.",table:{category:"Attributes"}},"tooltip-position":{control:{type:"select"},options:["top","bottom","left","right"],description:"Preferred placement (auto-flips if viewport constrained)",table:{category:"Attributes"}},"tooltip-delay":{control:{type:"number"},description:"Delay before showing tooltip on hover (ms)",table:{category:"Attributes"}},"tooltip-offset":{control:{type:"select"},options:["sm","md","lg","xl"],description:"Gap between trigger and tooltip (sm=4px, md=8px, lg=12px, xl=16px)",table:{category:"Attributes"}},"tooltip-no-arrow":{control:{type:"boolean"},description:"Hide the arrow pseudo-element",table:{category:"Attributes"}},"tooltip-trigger":{control:{type:"select"},options:["hover focus","hover","focus","click","hover click"],description:"How the tooltip is activated (combinable triggers)",table:{category:"Attributes"}},label:{control:{type:"text"},description:"Demo button label text",table:{category:"Demo"}},customBg:{name:"--tooltip-color-background",control:{type:"color"},description:"Background color",table:{category:"CSS Custom Properties",defaultValue:{summary:"white"}}},customTextColor:{name:"--tooltip-color-text",control:{type:"color"},description:"Text color",table:{category:"CSS Custom Properties",defaultValue:{summary:"oklch(var(--btu-theme-gray-900))"}}},customRadius:{name:"--tooltip-border-radius",control:{type:"select"},options:["0px","0.125rem","0.25rem","0.375rem","0.5rem","0.75rem","1rem","1.5rem","9999px"],labels:{"0px":"none (0px)","0.125rem":"sm (0.125rem)","0.25rem":"DEFAULT (0.25rem)","0.375rem":"md (0.375rem)","0.5rem":"lg (0.5rem)","0.75rem":"xl (0.75rem)","1rem":"2xl (1rem)","1.5rem":"3xl (1.5rem)","9999px":"full (9999px)"},description:"Border radius",table:{category:"CSS Custom Properties",defaultValue:{summary:"0.5rem (lg)"}}}},render:o=>{const i=[];o.customBg&&i.push(`--tooltip-color-background: ${o.customBg}`),o.customTextColor&&i.push(`--tooltip-color-text: ${o.customTextColor}`),o.customRadius&&i.push(`--tooltip-border-radius: ${o.customRadius}`);const s=i.length>0?i.join("; "):"";return c`
+      <style>
+        ${f}
+      </style>
+      <div style="display: flex; justify-content: center; padding: 6rem 2rem;">
+        <div style="${s}">
+          <tooltip-demo
+            tooltip="${o.tooltip}"
+            tooltip-position="${o["tooltip-position"]}"
+            tooltip-delay="${o["tooltip-delay"]}"
+            tooltip-offset="${T(o["tooltip-offset"])}"
+            ?tooltip-no-arrow="${o["tooltip-no-arrow"]}"
+            tooltip-trigger="${o["tooltip-trigger"]}"
+            label="${o.label}"
+          ></tooltip-demo>
+        </div>
+      </div>
+    `}},d={args:{}},h={render:()=>c`
+    <style>
+      ${f}
+    </style>
+    <div style="display: flex; gap: 2rem; justify-content: center; padding: 6rem 2rem; flex-wrap: wrap;">
+      <tooltip-demo tooltip="Top tooltip" tooltip-position="top" label="Top"></tooltip-demo>
+      <tooltip-demo tooltip="Bottom tooltip" tooltip-position="bottom" label="Bottom"></tooltip-demo>
+      <tooltip-demo tooltip="Left tooltip" tooltip-position="left" label="Left"></tooltip-demo>
+      <tooltip-demo tooltip="Right tooltip" tooltip-position="right" label="Right"></tooltip-demo>
+    </div>
+  `,parameters:{docs:{description:{story:"Tooltips support four positions: `top`, `bottom`, `left`, and `right`. Each position auto-flips to the opposite side if constrained by the viewport."},story:{inline:!1,iframeHeight:300}}}},m={render:()=>c`
+    <style>
+      ${f}
+    </style>
+    <div style="display: flex; gap: 2rem; justify-content: center; padding: 4rem 2rem; flex-wrap: wrap;">
+      <tooltip-demo tooltip="Small offset (4px)" tooltip-offset="sm" label="sm"></tooltip-demo>
+      <tooltip-demo tooltip="Medium offset (8px)" tooltip-offset="md" label="md"></tooltip-demo>
+      <tooltip-demo tooltip="Large offset (12px)" tooltip-offset="lg" label="lg"></tooltip-demo>
+      <tooltip-demo tooltip="Extra large offset (16px)" tooltip-offset="xl" label="xl"></tooltip-demo>
+    </div>
+  `,parameters:{docs:{description:{story:"The `tooltip-offset` attribute controls the gap between trigger and tooltip using named sizes: `sm` (4px), `md` (8px), `lg` (12px), `xl` (16px)."}}}},u={render:()=>c`
+    <style>
+      ${f}
+    </style>
+    <div style="display: flex; gap: 2rem; justify-content: center; padding: 4rem 2rem; flex-wrap: wrap;">
+      <tooltip-demo tooltip="Click-triggered tooltip" tooltip-trigger="click" label="Click me"></tooltip-demo>
+      <tooltip-demo tooltip="Hover or click" tooltip-trigger="hover click" label="Hover or click"></tooltip-demo>
+    </div>
+  `,parameters:{docs:{description:{story:"The `tooltip-trigger` attribute controls how the tooltip is activated. `click` toggles on click and dismisses on Escape. Triggers can be combined with spaces."}}}};d.parameters={...d.parameters,docs:{...d.parameters?.docs,source:{originalSource:`{
+  args: {}
+}`,...d.parameters?.docs?.source}}};h.parameters={...h.parameters,docs:{...h.parameters?.docs,source:{originalSource:`{
+  render: () => html\`
+    <style>
+      \${demoStyle}
+    </style>
+    <div style="display: flex; gap: 2rem; justify-content: center; padding: 6rem 2rem; flex-wrap: wrap;">
+      <tooltip-demo tooltip="Top tooltip" tooltip-position="top" label="Top"></tooltip-demo>
+      <tooltip-demo tooltip="Bottom tooltip" tooltip-position="bottom" label="Bottom"></tooltip-demo>
+      <tooltip-demo tooltip="Left tooltip" tooltip-position="left" label="Left"></tooltip-demo>
+      <tooltip-demo tooltip="Right tooltip" tooltip-position="right" label="Right"></tooltip-demo>
+    </div>
+  \`,
+  parameters: {
+    docs: {
+      description: {
+        story: 'Tooltips support four positions: \`top\`, \`bottom\`, \`left\`, and \`right\`. Each position auto-flips to the opposite side if constrained by the viewport.'
+      },
+      story: {
+        inline: false,
+        iframeHeight: 300
+      }
+    }
+  }
+}`,...h.parameters?.docs?.source}}};m.parameters={...m.parameters,docs:{...m.parameters?.docs,source:{originalSource:`{
+  render: () => html\`
+    <style>
+      \${demoStyle}
+    </style>
+    <div style="display: flex; gap: 2rem; justify-content: center; padding: 4rem 2rem; flex-wrap: wrap;">
+      <tooltip-demo tooltip="Small offset (4px)" tooltip-offset="sm" label="sm"></tooltip-demo>
+      <tooltip-demo tooltip="Medium offset (8px)" tooltip-offset="md" label="md"></tooltip-demo>
+      <tooltip-demo tooltip="Large offset (12px)" tooltip-offset="lg" label="lg"></tooltip-demo>
+      <tooltip-demo tooltip="Extra large offset (16px)" tooltip-offset="xl" label="xl"></tooltip-demo>
+    </div>
+  \`,
+  parameters: {
+    docs: {
+      description: {
+        story: 'The \`tooltip-offset\` attribute controls the gap between trigger and tooltip using named sizes: \`sm\` (4px), \`md\` (8px), \`lg\` (12px), \`xl\` (16px).'
+      }
+    }
+  }
+}`,...m.parameters?.docs?.source}}};u.parameters={...u.parameters,docs:{...u.parameters?.docs,source:{originalSource:`{
+  render: () => html\`
+    <style>
+      \${demoStyle}
+    </style>
+    <div style="display: flex; gap: 2rem; justify-content: center; padding: 4rem 2rem; flex-wrap: wrap;">
+      <tooltip-demo tooltip="Click-triggered tooltip" tooltip-trigger="click" label="Click me"></tooltip-demo>
+      <tooltip-demo tooltip="Hover or click" tooltip-trigger="hover click" label="Hover or click"></tooltip-demo>
+    </div>
+  \`,
+  parameters: {
+    docs: {
+      description: {
+        story: 'The \`tooltip-trigger\` attribute controls how the tooltip is activated. \`click\` toggles on click and dismisses on Escape. Triggers can be combined with spaces.'
+      }
+    }
+  }
+}`,...u.parameters?.docs?.source}}};const R=["Default","Positions","Offset","ClickTrigger"];export{u as ClickTrigger,d as Default,m as Offset,h as Positions,R as __namedExportsOrder,F as default};