@ixfx/components 0.2.4 → 0.2.5

package/dist/tickled-styles-Bg3QbcrD.js

@@ -0,0 +1,327 @@
+import { css } from "lit";
+//#region src/interaction/tickled-controller.ts
+/**
+* ReactiveController that manages "tickled" state for interactive lists.
+*
+* A "tickled" item is one that is under active attention via hover (mouse mode)
+* or keyboard focus (keyboard mode). Only one item can be tickled at a time.
+*
+* The input mode determines which mechanism controls tickled state:
+* - Mouse mode: hover controls tickled, keyboard navigation ignored
+* - Keyboard mode: keyboard navigation controls tickled, hover ignored
+*
+* Last interaction wins - any mouse hover switches to mouse mode, any keyboard
+* navigation switches to keyboard mode.
+*
+* ## Global Mouse Tracking
+*
+* This controller uses a singleton global `pointermove` listener to track actual
+* mouse movement. This prevents `pointerenter` events caused by content scrolling
+* from incorrectly switching to mouse mode when the user is actually using keyboard
+* navigation.
+*
+* @example
+* ```ts
+* class MyList extends LitElement {
+*   private tickled = new TickledController(this, {
+*     getItems: () => this.items.map((item, i) => ({ id: i, enabled: !item.disabled })),
+*     onTickle: (id) => {
+*       // Optional: perform side effect when item is tickled
+*       console.log('Tickled item:', id);
+*     }
+*   });
+*
+*   render() {
+*     return html`
+*       <ul @pointerleave=${(e) => this.tickled.handlePointerLeave(e)}>
+*         ${this.items.map((item, i) => html`
+*           <li
+*             class="item ${this.tickled.isTickled(i) ? 'tickled' : ''}"
+*             @pointerenter=${() => this.tickled.handlePointerEnter(i)}
+*           >${item.label}</li>
+*         `)}
+*       </ul>
+*     `;
+*   }
+*
+*   private handleKeyDown(e: KeyboardEvent) {
+*     if (e.key === 'ArrowDown') {
+*       this.tickled.handleKeyboardNavigation('next');
+*     } else if (e.key === 'ArrowUp') {
+*       this.tickled.handleKeyboardNavigation('previous');
+*     }
+*   }
+* }
+* ```
+*/
+var TickledController = class TickledController {
+	static {
+		this._lastMouseClientX = NaN;
+	}
+	static {
+		this._lastMouseClientY = NaN;
+	}
+	static {
+		this._mouseMovedSinceKeyboard = true;
+	}
+	static {
+		this._globalListenerAttached = false;
+	}
+	constructor(host, config) {
+		this._tickledId = void 0;
+		this.host = host;
+		this.config = config;
+		this._inputMode = config.initialInputMode ?? `mouse`;
+		host.addController(this);
+	}
+	hostConnected() {
+		if (!TickledController._globalListenerAttached) {
+			document.addEventListener(`pointermove`, (e) => {
+				TickledController.handleGlobalPointerMove(e.clientX, e.clientY);
+			}, { passive: true });
+			TickledController._globalListenerAttached = true;
+		}
+	}
+	hostDisconnected() {}
+	/**
+	* Get the current input mode
+	*/
+	get inputMode() {
+		return this._inputMode;
+	}
+	/**
+	* Get the currently tickled item id
+	*/
+	get tickledId() {
+		return this._tickledId;
+	}
+	/**
+	* Check if a specific item is tickled
+	*/
+	isTickled(id) {
+		return this._tickledId === id;
+	}
+	/**
+	* Handle global pointer move event.
+	* Called automatically by the global listener.
+	* Tracks mouse movement to distinguish real hover from content scrolling.
+	*/
+	static handleGlobalPointerMove(clientX, clientY) {
+		if (!Number.isNaN(TickledController._lastMouseClientX)) {
+			if (clientX !== TickledController._lastMouseClientX || clientY !== TickledController._lastMouseClientY) TickledController._mouseMovedSinceKeyboard = true;
+		}
+		TickledController._lastMouseClientX = clientX;
+		TickledController._lastMouseClientY = clientY;
+	}
+	/**
+	* Check if actual mouse movement has occurred since last keyboard interaction.
+	* Used to distinguish real hover/leave from content-scrolling-induced events.
+	*/
+	static get hasMouseMovedSinceKeyboard() {
+		return TickledController._mouseMovedSinceKeyboard;
+	}
+	/**
+	* Handle pointer enter event on an item (mouse hover).
+	* Only processes if actual mouse movement is detected (not content scrolling).
+	* Switches to mouse mode and tickles the item.
+	*/
+	handlePointerEnter(id) {
+		if (!TickledController._mouseMovedSinceKeyboard) return;
+		const item = this.config.getItems().find((item) => item.id === id);
+		if (item && item.enabled === false) return;
+		const modeChanged = this._inputMode !== `mouse`;
+		this._inputMode = `mouse`;
+		const previousId = this._tickledId;
+		this._tickledId = id;
+		this.host.requestUpdate();
+		if (previousId !== id && this.config.onTickle) this.config.onTickle(id);
+		if ((previousId !== id || modeChanged) && this.config.onStateChange) this.config.onStateChange();
+	}
+	/**
+	* Handle pointer leave event on an item.
+	* Only clears tickled state if actual mouse movement is detected.
+	* @param _e The pointer event (not used, but kept for API compatibility)
+	*/
+	handlePointerLeave(_e) {
+		if (TickledController._mouseMovedSinceKeyboard) this.clearTickled();
+	}
+	/**
+	* Handle keyboard navigation.
+	* Switches to keyboard mode and moves tickled state.
+	*
+	* @param direction - 'next', 'previous', 'first', 'last', or specific id
+	*/
+	handleKeyboardNavigation(direction) {
+		const modeChanged = this._inputMode !== `keyboard`;
+		this._inputMode = `keyboard`;
+		const enabledItems = this.config.getItems().filter((item) => item.enabled !== false);
+		if (enabledItems.length === 0) return;
+		let newId;
+		if (direction === `first`) newId = enabledItems[0].id;
+		else if (direction === `last`) newId = enabledItems.at(-1)?.id;
+		else if (direction === `next` || direction === `previous`) {
+			const currentIndex = enabledItems.findIndex((item) => item.id === this._tickledId);
+			if (currentIndex === -1) newId = direction === `next` ? enabledItems[0].id : enabledItems.at(-1)?.id;
+			else {
+				const newIndex = currentIndex + (direction === `next` ? 1 : -1);
+				if (newIndex >= 0 && newIndex < enabledItems.length) newId = enabledItems[newIndex].id;
+			}
+		} else {
+			const item = enabledItems.find((item) => item.id === direction);
+			if (item) newId = item.id;
+		}
+		if (newId !== void 0) {
+			const previousId = this._tickledId;
+			this._tickledId = newId;
+			this.host.requestUpdate();
+			if (previousId !== newId && this.config.onTickle) this.config.onTickle(newId);
+			if ((previousId !== newId || modeChanged) && this.config.onStateChange) this.config.onStateChange();
+		}
+	}
+	/**
+	* Manually set the tickled item (useful for programmatic control).
+	* Does NOT change input mode.
+	*/
+	setTickled(id) {
+		const previousId = this._tickledId;
+		this._tickledId = id;
+		this.host.requestUpdate();
+		if (previousId !== id && this.config.onTickle) this.config.onTickle(id);
+		if (previousId !== id && this.config.onStateChange) this.config.onStateChange();
+	}
+	/**
+	* Clear the tickled state (e.g., on pointer leave).
+	* Note: For pointer leave events, prefer using handlePointerLeave() which
+	* checks for actual mouse movement.
+	*/
+	clearTickled() {
+		if (this._tickledId !== void 0) {
+			this._tickledId = void 0;
+			this.host.requestUpdate();
+			if (this.config.onTickle) this.config.onTickle(void 0);
+			if (this.config.onStateChange) this.config.onStateChange();
+		}
+	}
+	/**
+	* Manually set the input mode.
+	* When switching to keyboard mode, resets the mouse movement tracking.
+	*/
+	setInputMode(mode) {
+		if (this._inputMode !== mode) {
+			this._inputMode = mode;
+			this.host.requestUpdate();
+			if (mode === `keyboard`) TickledController._mouseMovedSinceKeyboard = false;
+			if (this.config.onStateChange) this.config.onStateChange();
+		}
+	}
+};
+//#endregion
+//#region src/interaction/tickled-styles.ts
+/**
+* Shared CSS styles for tickled interaction pattern.
+*
+* Tickled state is controlled via the `.tickled` CSS class (applied by TickledController).
+* The `tickledItemStyles` provides base styling that all tickled components should use.
+*
+* ## CSS Variable Contract
+*
+* **Style variables (default values defined in `tickledItemStyles`):**
+* - `--item-bg`: Default background (default: transparent)
+* - `--item-bg-tickled`: Background when tickled (default: rgba(0, 0, 0, 0.06))
+* - `--item-bg-selected`: Background when selected (default: rgba(25, 118, 210, 1))
+* - `--item-bg-selected-tickled`: Background when selected AND tickled (default: rgba(21, 101, 192, 1))
+* - `--item-border`: Border style (default: 1px solid transparent)
+* - `--item-border-tickled`: Border when tickled (default: 1px solid var(--accent))
+* - `--item-border-selected`: Border when selected (default: 1px solid rgba(25, 118, 210, 1))
+* - `--item-text-tickled`: Text color when tickled (default: inherit)
+* - `--item-text-selected`: Text color when selected (default: #fff)
+* - `--item-padding`: Item padding (default: 4px 8px)
+* - `--item-border-radius`: Border radius (default: 4px)
+* - `--item-icon-spacing`: Gap between icon and text (default: 4px)
+*
+* ## Usage
+*
+* Components should import both `tickledStyles` and `tickledItemStyles`:
+*
+* ```ts
+* import { tickledStyles, tickledItemStyles } from '../interaction/index.js';
+*
+* class MyComponent extends LitElement {
+*   static styles = [
+*     tickledStyles,
+*     tickledItemStyles,
+*     css`
+*       :host {
+*         --item-bg-tickled: #e0e0e0;
+*         --item-bg-selected: #1976d2;
+*       }
+*     `
+*   ];
+* }
+* ```
+*/
+const tickledStyles = css`
+  /**
+   * No suppression needed - tickled styling is always active.
+   */
+`;
+/**
+* Shared item styling for tickled components.
+*
+* Provides base styles for interactive items with tickled and selected states.
+* Components should import this in addition to `tickledStyles` and can override
+* CSS variables to customize appearance.
+*/
+const tickledItemStyles = css`
+  :host {
+    --item-bg: transparent;
+    --item-bg-tickled: rgba(0, 0, 0, 0.06);
+    --item-bg-selected: rgba(25, 118, 210, 1);
+    --item-bg-selected-tickled: rgba(21, 101, 192, 1);
+    --item-border: 1px solid transparent;
+    --item-border-tickled: 1px solid var(--accent);
+    --item-border-selected: 1px solid rgba(25, 118, 210, 1);
+    --item-text: inherit;
+    --item-text-tickled: inherit;
+    --item-text-selected: #fff;
+    --item-padding: 4px 8px;
+    --item-border-radius: 4px;
+    --item-icon-spacing: 4px;
+  }
+
+  .item {
+    display: inline-flex;
+    align-items: center;
+    gap: var(--item-icon-spacing);
+    padding: var(--item-padding);
+    background: var(--item-bg);
+    border: var(--item-border);
+    border-radius: var(--item-border-radius);
+    cursor: pointer;
+    user-select: none;
+    white-space: nowrap;
+    transition: background var(--transition, 0.1s ease-out), border-color var(--transition, 0.1s ease-out);
+  }
+
+  .item.tickled {
+    background: var(--item-bg-tickled);
+    border-color: var(--item-border-tickled);
+    color: var(--item-text-tickled);
+  }
+
+  .item.selected {
+    background: var(--item-bg-selected);
+    border-color: var(--item-border-selected);
+    color: var(--item-text-selected);
+  }
+
+  .item.selected.tickled {
+    background: var(--item-bg-selected-tickled);
+    outline: 2px dashed var(--surface-3);
+    outline-offset: -2px;
+  }
+`;
+//#endregion
+export { tickledStyles as n, TickledController as r, tickledItemStyles as t };
+
+//# sourceMappingURL=tickled-styles-Bg3QbcrD.js.map

package/dist/tickled-styles-Bg3QbcrD.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tickled-styles-Bg3QbcrD.js","names":[],"sources":["../src/interaction/tickled-controller.ts","../src/interaction/tickled-styles.ts"],"sourcesContent":["import type { ReactiveController, ReactiveControllerHost } from 'lit';\n\n/**\n * Represents an item that can be tickled (highlighted via hover or keyboard navigation)\n */\nexport type TickledItem<T = unknown> = {\n  /**\n   * Unique identifier for the item (e.g., index, id, path)\n   */\n  readonly id: T;\n\n  /**\n   * Whether the item is currently enabled/interactive\n   */\n  readonly enabled?: boolean;\n};\n\n/**\n * Input mode determines which mechanism controls the tickled state\n */\nexport type InputMode = `keyboard` | `mouse`;\n\n/**\n * Configuration for TickledController\n */\nexport type TickledControllerConfig<T> = {\n  /**\n   * Function to retrieve all items that can be tickled\n   */\n  getItems: () => ReadonlyArray<TickledItem<T>>;\n\n  /**\n   * Optional callback when an item becomes tickled\n   * Use this for side effects like opening submenus\n   * @param id - The id of the newly tickled item, or undefined if nothing is tickled\n   */\n  onTickle?: (id: T | undefined) => void;\n\n  /**\n   * Optional callback fired after any state change (tickled id or input mode)\n   * Use this to sync DOM attributes for slotted content that can't use reactive rendering\n   *\n   * For components that render items directly, this is usually not needed as\n   * Lit's reactive rendering will handle updates automatically via requestUpdate()\n   *\n   * @example\n   * ```ts\n   * onStateChange: () => {\n   *   // Sync data-tickled attributes for slotted items\n   *   const items = this.getItems();\n   *   items.forEach((item, i) => {\n   *     if (this.tickled.isTickled(i)) {\n   *       item.setAttribute('data-tickled', '');\n   *     } else {\n   *       item.removeAttribute('data-tickled');\n   *     }\n   *   });\n   * }\n   * ```\n   */\n  onStateChange?: () => void;\n\n  /**\n   * Optional initial input mode (defaults to 'mouse')\n   */\n  initialInputMode?: InputMode;\n};\n\n/**\n * ReactiveController that manages \"tickled\" state for interactive lists.\n *\n * A \"tickled\" item is one that is under active attention via hover (mouse mode)\n * or keyboard focus (keyboard mode). Only one item can be tickled at a time.\n *\n * The input mode determines which mechanism controls tickled state:\n * - Mouse mode: hover controls tickled, keyboard navigation ignored\n * - Keyboard mode: keyboard navigation controls tickled, hover ignored\n *\n * Last interaction wins - any mouse hover switches to mouse mode, any keyboard\n * navigation switches to keyboard mode.\n *\n * ## Global Mouse Tracking\n *\n * This controller uses a singleton global `pointermove` listener to track actual\n * mouse movement. This prevents `pointerenter` events caused by content scrolling\n * from incorrectly switching to mouse mode when the user is actually using keyboard\n * navigation.\n *\n * @example\n * ```ts\n * class MyList extends LitElement {\n *   private tickled = new TickledController(this, {\n *     getItems: () => this.items.map((item, i) => ({ id: i, enabled: !item.disabled })),\n *     onTickle: (id) => {\n *       // Optional: perform side effect when item is tickled\n *       console.log('Tickled item:', id);\n *     }\n *   });\n *\n *   render() {\n *     return html`\n *       <ul @pointerleave=${(e) => this.tickled.handlePointerLeave(e)}>\n *         ${this.items.map((item, i) => html`\n *           <li\n *             class=\"item ${this.tickled.isTickled(i) ? 'tickled' : ''}\"\n *             @pointerenter=${() => this.tickled.handlePointerEnter(i)}\n *           >${item.label}</li>\n *         `)}\n *       </ul>\n *     `;\n *   }\n *\n *   private handleKeyDown(e: KeyboardEvent) {\n *     if (e.key === 'ArrowDown') {\n *       this.tickled.handleKeyboardNavigation('next');\n *     } else if (e.key === 'ArrowUp') {\n *       this.tickled.handleKeyboardNavigation('previous');\n *     }\n *   }\n * }\n * ```\n */\nexport class TickledController<T = number> implements ReactiveController {\n  private host: ReactiveControllerHost;\n  private config: TickledControllerConfig<T>;\n  private _tickledId: T | undefined = undefined;\n  private _inputMode: InputMode;\n\n  private static _lastMouseClientX: number = Number.NaN;\n  private static _lastMouseClientY: number = Number.NaN;\n  private static _mouseMovedSinceKeyboard: boolean = true;\n  private static _globalListenerAttached: boolean = false;\n\n  constructor(host: ReactiveControllerHost, config: TickledControllerConfig<T>) {\n    this.host = host;\n    this.config = config;\n    this._inputMode = config.initialInputMode ?? `mouse`;\n    host.addController(this);\n  }\n\n  hostConnected(): void {\n    if (!TickledController._globalListenerAttached) {\n      document.addEventListener(`pointermove`, (e: PointerEvent) => {\n        TickledController.handleGlobalPointerMove(e.clientX, e.clientY);\n      }, { passive: true });\n      TickledController._globalListenerAttached = true;\n    }\n  }\n\n  hostDisconnected(): void {\n    // No-op: global listener persists for the lifetime of the page\n  }\n\n  /**\n   * Get the current input mode\n   */\n  get inputMode(): InputMode {\n    return this._inputMode;\n  }\n\n  /**\n   * Get the currently tickled item id\n   */\n  get tickledId(): T | undefined {\n    return this._tickledId;\n  }\n\n  /**\n   * Check if a specific item is tickled\n   */\n  isTickled(id: T): boolean {\n    return this._tickledId === id;\n  }\n\n  /**\n   * Handle global pointer move event.\n   * Called automatically by the global listener.\n   * Tracks mouse movement to distinguish real hover from content scrolling.\n   */\n  private static handleGlobalPointerMove(clientX: number, clientY: number): void {\n    if (!Number.isNaN(TickledController._lastMouseClientX)) {\n      if (\n        clientX !== TickledController._lastMouseClientX\n        || clientY !== TickledController._lastMouseClientY\n      ) {\n        TickledController._mouseMovedSinceKeyboard = true;\n      }\n    }\n    TickledController._lastMouseClientX = clientX;\n    TickledController._lastMouseClientY = clientY;\n  }\n\n  /**\n   * Check if actual mouse movement has occurred since last keyboard interaction.\n   * Used to distinguish real hover/leave from content-scrolling-induced events.\n   */\n  static get hasMouseMovedSinceKeyboard(): boolean {\n    return TickledController._mouseMovedSinceKeyboard;\n  }\n\n  /**\n   * Handle pointer enter event on an item (mouse hover).\n   * Only processes if actual mouse movement is detected (not content scrolling).\n   * Switches to mouse mode and tickles the item.\n   */\n  handlePointerEnter(id: T): void {\n    if (!TickledController._mouseMovedSinceKeyboard) {\n      return;\n    }\n\n    const items = this.config.getItems();\n    const item = items.find(item => item.id === id);\n    if (item && item.enabled === false) {\n      return;\n    }\n\n    const modeChanged = this._inputMode !== `mouse`;\n    this._inputMode = `mouse`;\n\n    const previousId = this._tickledId;\n    this._tickledId = id;\n\n    this.host.requestUpdate();\n\n    if (previousId !== id && this.config.onTickle) {\n      this.config.onTickle(id);\n    }\n\n    if ((previousId !== id || modeChanged) && this.config.onStateChange) {\n      this.config.onStateChange();\n    }\n  }\n\n  /**\n   * Handle pointer leave event on an item.\n   * Only clears tickled state if actual mouse movement is detected.\n   * @param _e The pointer event (not used, but kept for API compatibility)\n   */\n  handlePointerLeave(_e: PointerEvent): void {\n    if (TickledController._mouseMovedSinceKeyboard) {\n      this.clearTickled();\n    }\n  }\n\n  /**\n   * Handle keyboard navigation.\n   * Switches to keyboard mode and moves tickled state.\n   *\n   * @param direction - 'next', 'previous', 'first', 'last', or specific id\n   */\n  handleKeyboardNavigation(direction: `next` | `previous` | `first` | `last` | T): void {\n    const modeChanged = this._inputMode !== `keyboard`;\n    this._inputMode = `keyboard`;\n\n    const items = this.config.getItems();\n    const enabledItems = items.filter(item => item.enabled !== false);\n\n    if (enabledItems.length === 0) {\n      return;\n    }\n\n    let newId: T | undefined;\n\n    if (direction === `first`) {\n      newId = enabledItems[0].id;\n    } else if (direction === `last`) {\n      newId = enabledItems.at(-1)?.id;\n    } else if (direction === `next` || direction === `previous`) {\n      const currentIndex = enabledItems.findIndex(item => item.id === this._tickledId);\n\n      if (currentIndex === -1) {\n        newId = direction === `next` ? enabledItems[0].id : enabledItems.at(-1)?.id;\n      } else {\n        const delta = direction === `next` ? 1 : -1;\n        const newIndex = currentIndex + delta;\n\n        if (newIndex >= 0 && newIndex < enabledItems.length) {\n          newId = enabledItems[newIndex].id;\n        }\n        // If newIndex is out of bounds, keep current tickled item\n      }\n    } else {\n      const item = enabledItems.find(item => item.id === direction);\n      if (item) {\n        newId = item.id;\n      }\n    }\n\n    if (newId !== undefined) {\n      const previousId = this._tickledId;\n      this._tickledId = newId;\n      this.host.requestUpdate();\n\n      if (previousId !== newId && this.config.onTickle) {\n        this.config.onTickle(newId);\n      }\n\n      if ((previousId !== newId || modeChanged) && this.config.onStateChange) {\n        this.config.onStateChange();\n      }\n    }\n  }\n\n  /**\n   * Manually set the tickled item (useful for programmatic control).\n   * Does NOT change input mode.\n   */\n  setTickled(id: T | undefined): void {\n    const previousId = this._tickledId;\n    this._tickledId = id;\n    this.host.requestUpdate();\n\n    if (previousId !== id && this.config.onTickle) {\n      this.config.onTickle(id);\n    }\n\n    if (previousId !== id && this.config.onStateChange) {\n      this.config.onStateChange();\n    }\n  }\n\n  /**\n   * Clear the tickled state (e.g., on pointer leave).\n   * Note: For pointer leave events, prefer using handlePointerLeave() which\n   * checks for actual mouse movement.\n   */\n  clearTickled(): void {\n    if (this._tickledId !== undefined) {\n      this._tickledId = undefined;\n      this.host.requestUpdate();\n\n      if (this.config.onTickle) {\n        this.config.onTickle(undefined);\n      }\n\n      if (this.config.onStateChange) {\n        this.config.onStateChange();\n      }\n    }\n  }\n\n  /**\n   * Manually set the input mode.\n   * When switching to keyboard mode, resets the mouse movement tracking.\n   */\n  setInputMode(mode: InputMode): void {\n    if (this._inputMode !== mode) {\n      this._inputMode = mode;\n      this.host.requestUpdate();\n\n      if (mode === `keyboard`) {\n        TickledController._mouseMovedSinceKeyboard = false;\n      }\n\n      if (this.config.onStateChange) {\n        this.config.onStateChange();\n      }\n    }\n  }\n}\n","import { css } from 'lit';\n\n/**\n * Shared CSS styles for tickled interaction pattern.\n *\n * Tickled state is controlled via the `.tickled` CSS class (applied by TickledController).\n * The `tickledItemStyles` provides base styling that all tickled components should use.\n *\n * ## CSS Variable Contract\n *\n * **Style variables (default values defined in `tickledItemStyles`):**\n * - `--item-bg`: Default background (default: transparent)\n * - `--item-bg-tickled`: Background when tickled (default: rgba(0, 0, 0, 0.06))\n * - `--item-bg-selected`: Background when selected (default: rgba(25, 118, 210, 1))\n * - `--item-bg-selected-tickled`: Background when selected AND tickled (default: rgba(21, 101, 192, 1))\n * - `--item-border`: Border style (default: 1px solid transparent)\n * - `--item-border-tickled`: Border when tickled (default: 1px solid var(--accent))\n * - `--item-border-selected`: Border when selected (default: 1px solid rgba(25, 118, 210, 1))\n * - `--item-text-tickled`: Text color when tickled (default: inherit)\n * - `--item-text-selected`: Text color when selected (default: #fff)\n * - `--item-padding`: Item padding (default: 4px 8px)\n * - `--item-border-radius`: Border radius (default: 4px)\n * - `--item-icon-spacing`: Gap between icon and text (default: 4px)\n *\n * ## Usage\n *\n * Components should import both `tickledStyles` and `tickledItemStyles`:\n *\n * ```ts\n * import { tickledStyles, tickledItemStyles } from '../interaction/index.js';\n *\n * class MyComponent extends LitElement {\n *   static styles = [\n *     tickledStyles,\n *     tickledItemStyles,\n *     css`\n *       :host {\n *         --item-bg-tickled: #e0e0e0;\n *         --item-bg-selected: #1976d2;\n *       }\n *     `\n *   ];\n * }\n * ```\n */\n\nexport const tickledStyles = css`\n  /**\n   * No suppression needed - tickled styling is always active.\n   */\n`;\n\n/**\n * Shared item styling for tickled components.\n *\n * Provides base styles for interactive items with tickled and selected states.\n * Components should import this in addition to `tickledStyles` and can override\n * CSS variables to customize appearance.\n */\nexport const tickledItemStyles = css`\n  :host {\n    --item-bg: transparent;\n    --item-bg-tickled: rgba(0, 0, 0, 0.06);\n    --item-bg-selected: rgba(25, 118, 210, 1);\n    --item-bg-selected-tickled: rgba(21, 101, 192, 1);\n    --item-border: 1px solid transparent;\n    --item-border-tickled: 1px solid var(--accent);\n    --item-border-selected: 1px solid rgba(25, 118, 210, 1);\n    --item-text: inherit;\n    --item-text-tickled: inherit;\n    --item-text-selected: #fff;\n    --item-padding: 4px 8px;\n    --item-border-radius: 4px;\n    --item-icon-spacing: 4px;\n  }\n\n  .item {\n    display: inline-flex;\n    align-items: center;\n    gap: var(--item-icon-spacing);\n    padding: var(--item-padding);\n    background: var(--item-bg);\n    border: var(--item-border);\n    border-radius: var(--item-border-radius);\n    cursor: pointer;\n    user-select: none;\n    white-space: nowrap;\n    transition: background var(--transition, 0.1s ease-out), border-color var(--transition, 0.1s ease-out);\n  }\n\n  .item.tickled {\n    background: var(--item-bg-tickled);\n    border-color: var(--item-border-tickled);\n    color: var(--item-text-tickled);\n  }\n\n  .item.selected {\n    background: var(--item-bg-selected);\n    border-color: var(--item-border-selected);\n    color: var(--item-text-selected);\n  }\n\n  .item.selected.tickled {\n    background: var(--item-bg-selected-tickled);\n    outline: 2px dashed var(--surface-3);\n    outline-offset: -2px;\n  }\n`;"],"mappings":"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"}