@solid2-aria/stately 0.0.0-stage → 0.0.1

package/dist/tokenfield/token-field-value.js

@@ -0,0 +1,327 @@
+/*
+ * Copyright 2026 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+/*
+ * Derived from Adobe React Spectrum: packages/react-stately/src/tokenfield/TokenFieldValue.ts.
+ * Modified for Solid Aria: adapted imports, collection descriptors, and reactive state APIs for Solid 2.
+ * Licensed under Apache-2.0. See LICENSES/Apache-2.0.txt and NOTICE.txt at the repository root.
+ */
+import { requireValue } from "../utils/require-value.js";
+// src/tokenfield/token-field-value.ts
+/** Represents a text selection in a TokenField. */
+var SelectedRange = class {
+	/** The anchor position. */
+	anchor;
+	/** The current (i.e. caret) position. */
+	current;
+	/**
+	* Creates a new selection range. If only a single position is provided, the selection is
+	* collapsed.
+	*/
+	constructor(anchor, current = anchor) {
+		this.anchor = anchor;
+		this.current = current;
+	}
+	/** Whether the selection is collapsed to a single caret position. */
+	get isCollapsed() {
+		return this.anchor.index === this.current.index && this.anchor.offset === this.current.offset;
+	}
+	/** The side of the selection closest to the start of the value. */
+	get start() {
+		return compare(this.anchor, this.current) < 0 ? this.anchor : this.current;
+	}
+	/** The side of the selection closest to the end of the value. */
+	get end() {
+		return compare(this.anchor, this.current) < 0 ? this.current : this.anchor;
+	}
+	/** Returns whether this selection is equal to another. */
+	isEqual(other) {
+		if (this === other) return true;
+		return this.anchor.index === other.anchor.index && this.anchor.offset === other.anchor.offset && this.current.index === other.current.index && this.current.offset === other.current.offset;
+	}
+};
+function compare(a, b) {
+	if (a.index === b.index) return a.offset - b.offset;
+	return a.index - b.index;
+}
+var Direction = /* @__PURE__ */ function(Direction) {
+	Direction[Direction["Forward"] = 1] = "Forward";
+	Direction[Direction["Backward"] = -1] = "Backward";
+	return Direction;
+}(Direction || {});
+/**
+* A list of segments containing editable text and non-editable tokens.
+*/
+var TokenFieldValue = class TokenFieldValue {
+	static Direction = Direction;
+	static SelectedRange = SelectedRange;
+	/** The text and token segments in the list. */
+	segments;
+	/** The selected range. */
+	selectedRange;
+	previous = null;
+	next = null;
+	isCoalescing = true;
+	/** Create a new list with the given segments. */
+	constructor(tokens, options) {
+		this.segments = tokens;
+		this.selectedRange = options?.selectedRange ?? new SelectedRange({
+			index: 0,
+			offset: 0
+		});
+	}
+	createFieldValue(segments) {
+		const Constructor = this.constructor;
+		return new Constructor(segments);
+	}
+	get caretPosition() {
+		return this.selectedRange.current;
+	}
+	/** Create a new list with the caret position set to the given position. */
+	withSelectedRange(selectedRange) {
+		if (this.selectedRange.isEqual(selectedRange)) return this;
+		const result = this.createFieldValue(this.segments);
+		result.selectedRange = selectedRange;
+		result.previous = this.previous;
+		result.next = this.next;
+		result.isCoalescing = this.isCoalescing;
+		return result;
+	}
+	withCaretPosition(position) {
+		return this.withSelectedRange(new SelectedRange(position));
+	}
+	static splitSegment(segment, offset) {
+		if (!segment) {
+			const empty = TokenFieldValue.createTextSegment("");
+			return [offset > 0 ? empty : null, offset > 0 ? null : empty];
+		}
+		if (segment.type === "token") return [offset > 0 ? { ...segment } : null, offset > 0 ? null : { ...segment }];
+		return [offset > 0 ? {
+			text: segment.text.slice(0, offset),
+			type: "text"
+		} : null, offset < segment.text.length ? TokenFieldValue.createTextSegment(segment.text.slice(offset)) : null];
+	}
+	static createTextSegment(text) {
+		return {
+			text,
+			type: "text"
+		};
+	}
+	tokenize(text) {
+		return [TokenFieldValue.createTextSegment(text)];
+	}
+	clampPosition(position) {
+		if (this.segments.length === 0) return {
+			index: 0,
+			offset: 0
+		};
+		if (this.segments.length > 0 && position.index >= this.segments.length) return {
+			index: this.segments.length - 1,
+			offset: requireValue(this.segments.at(-1), "Expected this.segments.at(-1) to exist.").text.length
+		};
+		if (position.index < 0) return {
+			index: 0,
+			offset: 0
+		};
+		return position;
+	}
+	/** Replace the text between two positions with new text. */
+	replaceRange(start, end, text, coalesce = true) {
+		return this.replaceRangeWithSegments(start, end, text.length > 0 ? [TokenFieldValue.createTextSegment(text)] : [], coalesce);
+	}
+	/** Replace the text between two positions with new segments. */
+	replaceRangeWithSegments(initialStart, initialEnd, insert, coalesce = true) {
+		let start = initialStart;
+		let end = initialEnd;
+		start = this.clampPosition(start);
+		end = this.clampPosition(end);
+		const startSegment = this.segments[start.index];
+		const endSegment = this.segments[end.index];
+		const [startSplit] = TokenFieldValue.splitSegment(startSegment, start.offset);
+		const [, endSplit] = TokenFieldValue.splitSegment(endSegment, end.offset);
+		const newSegments = this.segments.slice(0, start.index);
+		if (startSplit) appendSegments(newSegments, [startSplit]);
+		if (insert.length) appendSegments(newSegments, insert, (text) => this.tokenize(text));
+		const lastSegment = newSegments.at(-1);
+		const lastIsText = lastSegment && lastSegment.type === "text";
+		const caret = {
+			index: lastIsText === true ? newSegments.length - 1 : newSegments.length,
+			offset: lastIsText === true ? lastSegment.text.length : 0
+		};
+		if (endSplit) appendSegments(newSegments, [endSplit]);
+		appendSegments(newSegments, this.segments.slice(end.index + 1));
+		const segments = this.createFieldValue(newSegments);
+		segments.selectedRange = new SelectedRange(caret);
+		segments.isCoalescing = coalesce;
+		if (this.isCoalescing && coalesce && this.previous) {
+			segments.previous = this.previous;
+			segments.previous.next = segments;
+		} else {
+			segments.previous = this;
+			this.selectedRange = new SelectedRange(start, end);
+			this.next = segments;
+		}
+		return segments;
+	}
+	/** Find the boundary before or after a position using an Intl.Segmenter. */
+	findBoundaryWithSegmenter(initialPosition, segmenter, direction) {
+		let position = initialPosition;
+		position = this.clampPosition(position);
+		for (let i = position.index; i >= 0 && i < this.segments.length; i += direction) {
+			const segment = requireValue(this.segments[i], "Token traversal must stay within its segments.");
+			switch (segment.type) {
+				case "token":
+					if (i !== position.index || (direction === -1 ? position.offset > 0 : position.offset === 0)) {
+						const index = i + direction;
+						return {
+							index: Math.max(index, 0),
+							offset: direction === -1 && index >= 0 ? requireValue(this.segments[index], "Expected this.segments[index] to exist.").text.length : 0
+						};
+					}
+					continue;
+				case "text": {
+					let offset = direction === -1 ? segment.text.length : 0;
+					if (i === position.index) ({offset} = position);
+					if (direction === -1) offset -= 1;
+					if (offset < 0 || offset >= segment.text.length) continue;
+					let part = segmenter.segment(segment.text).containing(offset);
+					while (part && part.isWordLike === false) {
+						offset += direction;
+						part = segmenter.segment(segment.text).containing(offset);
+					}
+					if (part) return {
+						index: i,
+						offset: direction === -1 ? part.index : part.index + part.segment.length
+					};
+					continue;
+				}
+			}
+		}
+		return null;
+	}
+	/** Find a line boundary before or after a position. */
+	findLineBoundary(position, direction) {
+		const res = this.findText(position, direction, "\n");
+		if (res) return res;
+		return direction === -1 ? {
+			index: 0,
+			offset: 0
+		} : {
+			index: Math.max(0, this.segments.length - 1),
+			offset: this.segments.at(-1)?.text.length ?? 0
+		};
+	}
+	/** Find a string or regular expression match before or after a position. */
+	findText(position, direction, search) {
+		if (this.segments.length === 0) return null;
+		for (let i = position.index; i >= 0 && i < this.segments.length; i += direction) {
+			const segment = requireValue(this.segments[i], "Token traversal must stay within its segments.");
+			if (segment.type !== "text") continue;
+			const offset = findInText(segment.text, search, direction, i === position.index ? position.offset : void 0);
+			if (offset >= 0) return {
+				index: i,
+				offset
+			};
+		}
+		return null;
+	}
+	/** Delete text at a position using a segmenter. */
+	delete(position, segmenter, direction, coalesce = true) {
+		const boundary = this.findBoundaryWithSegmenter(position, segmenter, direction);
+		if (boundary) return this.replaceRange(direction === -1 ? boundary : position, direction === -1 ? position : boundary, "", coalesce);
+		return this.withSelectedRange(new SelectedRange(position));
+	}
+	/** Delete text to the next or previous line break. */
+	deleteLine(position, direction, coalesce = true) {
+		if (this.segments.length === 0) return this;
+		const boundary = this.findLineBoundary(position, direction);
+		if (boundary) return this.replaceRange(direction === -1 ? boundary : position, direction === -1 ? position : boundary, "", coalesce);
+		return this.withSelectedRange(new SelectedRange(position));
+	}
+	/** Create a new list containing a subset of the segments. */
+	slice(initialStart, initialEnd) {
+		let start = initialStart;
+		let end = initialEnd;
+		start = this.clampPosition(start);
+		end = this.clampPosition(end);
+		if (start.index === end.index && start.offset === end.offset) return this.createFieldValue([]);
+		if (start.index === end.index) {
+			const segment = requireValue(this.segments[start.index], "A token slice must reference an existing segment.");
+			if (segment.type === "text") return this.createFieldValue([{
+				text: segment.text.slice(start.offset, end.offset),
+				type: "text"
+			}]);
+			return this.createFieldValue([segment]);
+		}
+		const startSegment = this.segments[start.index];
+		const endSegment = this.segments[end.index];
+		const [, startSplit] = TokenFieldValue.splitSegment(startSegment, start.offset);
+		const [endSplit] = TokenFieldValue.splitSegment(endSegment, end.offset);
+		const result = [];
+		if (startSplit) result.push(startSplit);
+		result.push(...this.segments.slice(start.index + 1, end.index));
+		if (endSplit) result.push(endSplit);
+		return this.createFieldValue(result);
+	}
+	/** Convert the list to a string. */
+	toString() {
+		return this.segments.map((seg) => seg.text).join("");
+	}
+	/** Returns the previous list in the undo history. */
+	undo() {
+		return this.previous ?? this;
+	}
+	/** Returns the next list in the redo history. */
+	redo() {
+		return this.next ?? this;
+	}
+	/** End coalescing undo/redo history. */
+	endCoalescing() {
+		this.isCoalescing = false;
+	}
+};
+function findInText(text, search, direction, fromOffset) {
+	if (typeof search === "string") {
+		if (direction === -1) return text.lastIndexOf(search, fromOffset === void 0 ? text.length - 1 : fromOffset - 1);
+		return text.indexOf(search, fromOffset ?? 0);
+	}
+	if (direction === 1) {
+		const start = fromOffset ?? 0;
+		const index = text.slice(start).search(search);
+		return index >= 0 ? start + index : -1;
+	}
+	const limit = fromOffset ?? text.length;
+	if (limit < 0) return -1;
+	const re = search.flags.includes("g") ? search : new RegExp(search.source, `${search.flags}g`);
+	return [...text.slice(0, limit).matchAll(re)].at(-1)?.index ?? -1;
+}
+function appendSegments(segments, insert, tokenize) {
+	for (const segment of insert) {
+		if (segment.type === "text" && segment.text.length === 0) continue;
+		const last = segments.at(-1);
+		if (last && last.type === "text" && segment.type === "text") {
+			if (tokenize) {
+				const tokenized = tokenize(last.text + segment.text);
+				segments.splice(-1, 1, ...tokenized);
+			} else segments[segments.length - 1] = {
+				text: last.text + segment.text,
+				type: "text"
+			};
+		} else if (tokenize && segment.type === "text") {
+			const tokenized = tokenize(segment.text);
+			segments.push(...tokenized);
+		} else segments.push(segment);
+	}
+	return segments;
+}
+export { SelectedRange, TokenFieldValue };
+
+//# sourceMappingURL=token-field-value.js.map

package/dist/tokenfield/token-field-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-field-value.js","names":[],"sources":["../../src/tokenfield/token-field-value.ts"],"sourcesContent":["/*\n * Copyright 2026 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n/*\n * Derived from Adobe React Spectrum: packages/react-stately/src/tokenfield/TokenFieldValue.ts.\n * Modified for Solid Aria: adapted imports, collection descriptors, and reactive state APIs for Solid 2.\n * Licensed under Apache-2.0. See LICENSES/Apache-2.0.txt and NOTICE.txt at the repository root.\n */\n\nimport { requireValue } from \"../utils/require-value\";\n\nexport type TokenFieldSegment<T = unknown> = TextSegment | TokenSegment<T>;\n\nexport interface TextSegment {\n  type: \"text\";\n  text: string;\n}\n\nexport interface TokenSegment<T = unknown> {\n  type: \"token\";\n  text: string;\n  /** An arbitrary value associated with the token. */\n  value?: T;\n}\n\nexport interface Position {\n  /** Index of the segment in the list. */\n  index: number;\n  /** Text offset within the segment in UTF-16 code units. */\n  offset: number;\n}\n\n/** Represents a text selection in a TokenField. */\nexport class SelectedRange {\n  /** The anchor position. */\n  anchor: Position;\n  /** The current (i.e. caret) position. */\n  current: Position;\n  /**\n   * Creates a new selection range. If only a single position is provided, the selection is\n   * collapsed.\n   */\n  constructor(anchor: Position, current: Position = anchor) {\n    this.anchor = anchor;\n    this.current = current;\n  }\n  /** Whether the selection is collapsed to a single caret position. */\n  get isCollapsed() {\n    return (\n      this.anchor.index === this.current.index &&\n      this.anchor.offset === this.current.offset\n    );\n  }\n  /** The side of the selection closest to the start of the value. */\n  get start() {\n    return compare(this.anchor, this.current) < 0 ? this.anchor : this.current;\n  }\n  /** The side of the selection closest to the end of the value. */\n  get end() {\n    return compare(this.anchor, this.current) < 0 ? this.current : this.anchor;\n  }\n  /** Returns whether this selection is equal to another. */\n  isEqual(other: SelectedRange) {\n    if (this === other) {\n      return true;\n    }\n\n    return (\n      this.anchor.index === other.anchor.index &&\n      this.anchor.offset === other.anchor.offset &&\n      this.current.index === other.current.index &&\n      this.current.offset === other.current.offset\n    );\n  }\n}\n\nfunction compare(a: Position, b: Position) {\n  if (a.index === b.index) {\n    return a.offset - b.offset;\n  }\n\n  return a.index - b.index;\n}\n\nenum Direction {\n  Forward = 1,\n  Backward = -1,\n}\n\nexport interface TokenFieldValueOptions {\n  selectedRange?: SelectedRange | null;\n}\n\n/**\n * A list of segments containing editable text and non-editable tokens.\n */\nexport class TokenFieldValue<T = unknown> {\n  static readonly Direction = Direction;\n  static readonly SelectedRange = SelectedRange;\n  /** The text and token segments in the list. */\n  readonly segments: readonly TokenFieldSegment<T>[];\n  /** The selected range. */\n  selectedRange: SelectedRange;\n  // Linked list representing the undo/redo history.\n  private previous: this | null = null;\n  private next: this | null = null;\n  private isCoalescing = true;\n  /** Create a new list with the given segments. */\n  constructor(\n    tokens: readonly TokenFieldSegment<T>[],\n    options?: TokenFieldValueOptions\n  ) {\n    this.segments = tokens;\n    this.selectedRange =\n      options?.selectedRange ?? new SelectedRange({ index: 0, offset: 0 });\n  }\n  protected createFieldValue(segments: readonly TokenFieldSegment<T>[]): this {\n    // SAFETY: TokenFieldValue subclasses inherit the segment constructor contract and immutable edits preserve the runtime class.\n    // oxlint-disable-next-line typescript/no-unsafe-type-assertion\n    const Constructor = this.constructor as new (\n      segments: readonly TokenFieldSegment<T>[],\n      options?: TokenFieldValueOptions\n    ) => this;\n\n    return new Constructor(segments);\n  }\n  get caretPosition(): Position {\n    return this.selectedRange.current;\n  }\n  /** Create a new list with the caret position set to the given position. */\n  withSelectedRange(selectedRange: SelectedRange): this {\n    if (this.selectedRange.isEqual(selectedRange)) {\n      return this;\n    }\n\n    const result = this.createFieldValue(this.segments);\n    result.selectedRange = selectedRange;\n    result.previous = this.previous;\n    result.next = this.next;\n    result.isCoalescing = this.isCoalescing;\n\n    return result;\n  }\n  withCaretPosition(position: Position): this {\n    return this.withSelectedRange(new SelectedRange(position));\n  }\n  private static splitSegment<T>(\n    segment: TokenFieldSegment<T> | undefined,\n    offset: number\n  ): [TokenFieldSegment<T> | null, TokenFieldSegment<T> | null] {\n    if (!segment) {\n      const empty = TokenFieldValue.createTextSegment(\"\");\n\n      return [offset > 0 ? empty : null, offset > 0 ? null : empty];\n    }\n\n    if (segment.type === \"token\") {\n      return [\n        offset > 0 ? { ...segment } : null,\n        offset > 0 ? null : { ...segment },\n      ];\n    }\n\n    return [\n      offset > 0 ? { text: segment.text.slice(0, offset), type: \"text\" } : null,\n      offset < segment.text.length\n        ? TokenFieldValue.createTextSegment(segment.text.slice(offset))\n        : null,\n    ];\n  }\n  private static createTextSegment(text: string): TextSegment {\n    return { text, type: \"text\" };\n  }\n  protected tokenize(text: string): TokenFieldSegment<T>[] {\n    return [TokenFieldValue.createTextSegment(text)];\n  }\n  private clampPosition(position: Position): Position {\n    if (this.segments.length === 0) {\n      return { index: 0, offset: 0 };\n    }\n\n    if (this.segments.length > 0 && position.index >= this.segments.length) {\n      return {\n        index: this.segments.length - 1,\n        offset: requireValue(\n          this.segments.at(-1),\n          \"Expected this.segments.at(-1) to exist.\"\n        ).text.length,\n      };\n    }\n\n    if (position.index < 0) {\n      return { index: 0, offset: 0 };\n    }\n\n    return position;\n  }\n  /** Replace the text between two positions with new text. */\n  replaceRange(\n    start: Position,\n    end: Position,\n    text: string,\n    coalesce = true\n  ): this {\n    return this.replaceRangeWithSegments(\n      start,\n      end,\n      text.length > 0 ? [TokenFieldValue.createTextSegment(text)] : [],\n      coalesce\n    );\n  }\n  /** Replace the text between two positions with new segments. */\n  replaceRangeWithSegments(\n    initialStart: Position,\n    initialEnd: Position,\n    insert: TokenFieldSegment<T>[],\n    coalesce = true\n  ): this {\n    let start = initialStart;\n\n    let end = initialEnd;\n\n    start = this.clampPosition(start);\n    end = this.clampPosition(end);\n    const startSegment = this.segments[start.index];\n    const endSegment = this.segments[end.index];\n\n    const [startSplit] = TokenFieldValue.splitSegment(\n      startSegment,\n      start.offset\n    );\n\n    const [, endSplit] = TokenFieldValue.splitSegment(endSegment, end.offset);\n    const newSegments = this.segments.slice(0, start.index);\n\n    if (startSplit) {\n      appendSegments(newSegments, [startSplit]);\n    }\n\n    if (insert.length) {\n      appendSegments(newSegments, insert, (text) => this.tokenize(text));\n    }\n\n    const lastSegment = newSegments.at(-1);\n    const lastIsText = lastSegment && lastSegment.type === \"text\";\n\n    const caret = {\n      index: lastIsText === true ? newSegments.length - 1 : newSegments.length,\n      offset: lastIsText === true ? lastSegment.text.length : 0,\n    };\n\n    if (endSplit) {\n      appendSegments(newSegments, [endSplit]);\n    }\n\n    appendSegments(newSegments, this.segments.slice(end.index + 1));\n    const segments = this.createFieldValue(newSegments);\n    segments.selectedRange = new SelectedRange(caret);\n    segments.isCoalescing = coalesce;\n\n    if (this.isCoalescing && coalesce && this.previous) {\n      segments.previous = this.previous;\n      segments.previous.next = segments;\n    } else {\n      segments.previous = this;\n      this.selectedRange = new SelectedRange(start, end);\n      this.next = segments;\n    }\n\n    return segments;\n  }\n  /** Find the boundary before or after a position using an Intl.Segmenter. */\n  findBoundaryWithSegmenter(\n    initialPosition: Position,\n    segmenter: Intl.Segmenter,\n    direction: Direction\n  ): Position | null {\n    let position = initialPosition;\n\n    position = this.clampPosition(position);\n\n    for (\n      let i = position.index;\n      i >= 0 && i < this.segments.length;\n      i += direction\n    ) {\n      const segment = requireValue(\n        this.segments[i],\n        \"Token traversal must stay within its segments.\"\n      );\n\n      switch (segment.type) {\n        case \"token\": {\n          if (\n            i !== position.index ||\n            (direction === Direction.Backward\n              ? position.offset > 0\n              : position.offset === 0)\n          ) {\n            const index = i + direction;\n\n            return {\n              index: Math.max(index, 0),\n              offset:\n                direction === Direction.Backward && index >= 0\n                  ? requireValue(\n                      this.segments[index],\n                      \"Expected this.segments[index] to exist.\"\n                    ).text.length\n                  : 0,\n            };\n          }\n\n          continue;\n        }\n\n        case \"text\": {\n          let offset =\n            direction === Direction.Backward ? segment.text.length : 0;\n\n          if (i === position.index) {\n            ({ offset } = position);\n          }\n\n          if (direction === Direction.Backward) {\n            offset -= 1;\n          }\n\n          if (offset < 0 || offset >= segment.text.length) {\n            continue;\n          }\n\n          let part = segmenter.segment(segment.text).containing(offset);\n\n          while (part && part.isWordLike === false) {\n            offset += direction;\n            part = segmenter.segment(segment.text).containing(offset);\n          }\n\n          if (part) {\n            return {\n              index: i,\n              offset:\n                direction === Direction.Backward\n                  ? part.index\n                  : part.index + part.segment.length,\n            };\n          }\n\n          continue;\n        }\n\n        default: {\n          break;\n        }\n      }\n    }\n\n    return null;\n  }\n  /** Find a line boundary before or after a position. */\n  findLineBoundary(position: Position, direction: Direction): Position | null {\n    const res = this.findText(position, direction, \"\\n\");\n\n    if (res) {\n      return res;\n    }\n\n    return direction === Direction.Backward\n      ? { index: 0, offset: 0 }\n      : {\n          index: Math.max(0, this.segments.length - 1),\n          offset: this.segments.at(-1)?.text.length ?? 0,\n        };\n  }\n  /** Find a string or regular expression match before or after a position. */\n  findText(\n    position: Position,\n    direction: Direction,\n    search: string | RegExp\n  ): Position | null {\n    if (this.segments.length === 0) {\n      return null;\n    }\n\n    for (\n      let i = position.index;\n      i >= 0 && i < this.segments.length;\n      i += direction\n    ) {\n      const segment = requireValue(\n        this.segments[i],\n        \"Token traversal must stay within its segments.\"\n      );\n\n      if (segment.type !== \"text\") {\n        continue;\n      }\n\n      const offset = findInText(\n        segment.text,\n        search,\n        direction,\n        i === position.index ? position.offset : undefined\n      );\n\n      if (offset >= 0) {\n        return {\n          index: i,\n          offset,\n        };\n      }\n    }\n\n    return null;\n  }\n  /** Delete text at a position using a segmenter. */\n  delete(\n    position: Position,\n    segmenter: Intl.Segmenter,\n    direction: Direction,\n    coalesce = true\n  ): this {\n    const boundary = this.findBoundaryWithSegmenter(\n      position,\n      segmenter,\n      direction\n    );\n\n    if (boundary) {\n      return this.replaceRange(\n        direction === Direction.Backward ? boundary : position,\n        direction === Direction.Backward ? position : boundary,\n        \"\",\n        coalesce\n      );\n    }\n\n    return this.withSelectedRange(new SelectedRange(position));\n  }\n  /** Delete text to the next or previous line break. */\n  deleteLine(position: Position, direction: Direction, coalesce = true): this {\n    if (this.segments.length === 0) {\n      return this;\n    }\n\n    const boundary = this.findLineBoundary(position, direction);\n\n    if (boundary) {\n      return this.replaceRange(\n        direction === Direction.Backward ? boundary : position,\n        direction === Direction.Backward ? position : boundary,\n        \"\",\n        coalesce\n      );\n    }\n\n    return this.withSelectedRange(new SelectedRange(position));\n  }\n  /** Create a new list containing a subset of the segments. */\n  slice(initialStart: Position, initialEnd: Position): this {\n    let start = initialStart;\n\n    let end = initialEnd;\n\n    start = this.clampPosition(start);\n    end = this.clampPosition(end);\n\n    if (start.index === end.index && start.offset === end.offset) {\n      return this.createFieldValue([]);\n    }\n\n    if (start.index === end.index) {\n      const segment = requireValue(\n        this.segments[start.index],\n        \"A token slice must reference an existing segment.\"\n      );\n\n      if (segment.type === \"text\") {\n        return this.createFieldValue([\n          {\n            text: segment.text.slice(start.offset, end.offset),\n            type: \"text\",\n          },\n        ]);\n      }\n\n      return this.createFieldValue([segment]);\n    }\n\n    const startSegment = this.segments[start.index];\n    const endSegment = this.segments[end.index];\n\n    const [, startSplit] = TokenFieldValue.splitSegment(\n      startSegment,\n      start.offset\n    );\n\n    const [endSplit] = TokenFieldValue.splitSegment(endSegment, end.offset);\n    const result: TokenFieldSegment<T>[] = [];\n\n    if (startSplit) {\n      result.push(startSplit);\n    }\n\n    result.push(...this.segments.slice(start.index + 1, end.index));\n\n    if (endSplit) {\n      result.push(endSplit);\n    }\n\n    return this.createFieldValue(result);\n  }\n  /** Convert the list to a string. */\n  toString(): string {\n    return this.segments.map((seg) => seg.text).join(\"\");\n  }\n  /** Returns the previous list in the undo history. */\n  undo(): this {\n    return this.previous ?? this;\n  }\n  /** Returns the next list in the redo history. */\n  redo(): this {\n    return this.next ?? this;\n  }\n  /** End coalescing undo/redo history. */\n  endCoalescing(): void {\n    this.isCoalescing = false;\n  }\n}\n\nfunction findInText(\n  text: string,\n  search: string | RegExp,\n  direction: Direction,\n  fromOffset?: number\n): number {\n  if (typeof search === \"string\") {\n    if (direction === Direction.Backward) {\n      return text.lastIndexOf(\n        search,\n        fromOffset === undefined ? text.length - 1 : fromOffset - 1\n      );\n    }\n\n    return text.indexOf(search, fromOffset ?? 0);\n  }\n\n  if (direction === Direction.Forward) {\n    const start = fromOffset ?? 0;\n    const index = text.slice(start).search(search);\n\n    return index >= 0 ? start + index : -1;\n  }\n\n  const limit = fromOffset ?? text.length;\n\n  if (limit < 0) {\n    return -1;\n  }\n\n  const re = search.flags.includes(\"g\")\n    ? search\n    : new RegExp(search.source, `${search.flags}g`);\n\n  const matches = [...text.slice(0, limit).matchAll(re)];\n\n  return matches.at(-1)?.index ?? -1;\n}\n\nfunction appendSegments<T>(\n  segments: TokenFieldSegment<T>[],\n  insert: TokenFieldSegment<T>[],\n  tokenize?: (text: string) => TokenFieldSegment<T>[]\n): TokenFieldSegment<T>[] {\n  for (const segment of insert) {\n    if (segment.type === \"text\" && segment.text.length === 0) {\n      continue;\n    }\n\n    const last = segments.at(-1);\n\n    if (last && last.type === \"text\" && segment.type === \"text\") {\n      if (tokenize) {\n        const tokenized = tokenize(last.text + segment.text);\n        segments.splice(-1, 1, ...tokenized);\n      } else {\n        segments[segments.length - 1] = {\n          text: last.text + segment.text,\n          type: \"text\",\n        };\n      }\n    } else if (tokenize && segment.type === \"text\") {\n      const tokenized = tokenize(segment.text);\n      segments.push(...tokenized);\n    } else {\n      segments.push(segment);\n    }\n  }\n\n  return segments;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAyCA,IAAa,gBAAb,MAA2B;;CAEzB;;CAEA;;;;;CAKA,YAAY,QAAkB,UAAoB,QAAQ;EACxD,KAAK,SAAS;EACd,KAAK,UAAU;CACjB;;CAEA,IAAI,cAAc;EAChB,OACE,KAAK,OAAO,UAAU,KAAK,QAAQ,SACnC,KAAK,OAAO,WAAW,KAAK,QAAQ;CAExC;;CAEA,IAAI,QAAQ;EACV,OAAO,QAAQ,KAAK,QAAQ,KAAK,OAAO,IAAI,IAAI,KAAK,SAAS,KAAK;CACrE;;CAEA,IAAI,MAAM;EACR,OAAO,QAAQ,KAAK,QAAQ,KAAK,OAAO,IAAI,IAAI,KAAK,UAAU,KAAK;CACtE;;CAEA,QAAQ,OAAsB;EAC5B,IAAI,SAAS,OACX,OAAO;EAGT,OACE,KAAK,OAAO,UAAU,MAAM,OAAO,SACnC,KAAK,OAAO,WAAW,MAAM,OAAO,UACpC,KAAK,QAAQ,UAAU,MAAM,QAAQ,SACrC,KAAK,QAAQ,WAAW,MAAM,QAAQ;CAE1C;AACF;AAEA,SAAS,QAAQ,GAAa,GAAa;CACzC,IAAI,EAAE,UAAU,EAAE,OAChB,OAAO,EAAE,SAAS,EAAE;CAGtB,OAAO,EAAE,QAAQ,EAAE;AACrB;AAEA,IAAK,YAAL,yBAAA,WAAA;CACE,UAAA,UAAA,aAAA,KAAA;CACA,UAAA,UAAA,cAAA,MAAA;;AACF,EAHK,aAAA,CAAA,CAGL;;;;AASA,IAAa,kBAAb,MAAa,gBAA6B;CACxC,OAAgB,YAAY;CAC5B,OAAgB,gBAAgB;;CAEhC;;CAEA;CAEA,WAAgC;CAChC,OAA4B;CAC5B,eAAuB;;CAEvB,YACE,QACA,SACA;EACA,KAAK,WAAW;EAChB,KAAK,gBACH,SAAS,iBAAiB,IAAI,cAAc;GAAE,OAAO;GAAG,QAAQ;EAAE,CAAC;CACvE;CACA,iBAA2B,UAAiD;EAG1E,MAAM,cAAc,KAAK;EAKzB,OAAO,IAAI,YAAY,QAAQ;CACjC;CACA,IAAI,gBAA0B;EAC5B,OAAO,KAAK,cAAc;CAC5B;;CAEA,kBAAkB,eAAoC;EACpD,IAAI,KAAK,cAAc,QAAQ,aAAa,GAC1C,OAAO;EAGT,MAAM,SAAS,KAAK,iBAAiB,KAAK,QAAQ;EAClD,OAAO,gBAAgB;EACvB,OAAO,WAAW,KAAK;EACvB,OAAO,OAAO,KAAK;EACnB,OAAO,eAAe,KAAK;EAE3B,OAAO;CACT;CACA,kBAAkB,UAA0B;EAC1C,OAAO,KAAK,kBAAkB,IAAI,cAAc,QAAQ,CAAC;CAC3D;CACA,OAAe,aACb,SACA,QAC4D;EAC5D,IAAI,CAAC,SAAS;GACZ,MAAM,QAAQ,gBAAgB,kBAAkB,EAAE;GAElD,OAAO,CAAC,SAAS,IAAI,QAAQ,MAAM,SAAS,IAAI,OAAO,KAAK;EAC9D;EAEA,IAAI,QAAQ,SAAS,SACnB,OAAO,CACL,SAAS,IAAI,EAAE,GAAG,QAAQ,IAAI,MAC9B,SAAS,IAAI,OAAO,EAAE,GAAG,QAAQ,CACnC;EAGF,OAAO,CACL,SAAS,IAAI;GAAE,MAAM,QAAQ,KAAK,MAAM,GAAG,MAAM;GAAG,MAAM;EAAO,IAAI,MACrE,SAAS,QAAQ,KAAK,SAClB,gBAAgB,kBAAkB,QAAQ,KAAK,MAAM,MAAM,CAAC,IAC5D,IACN;CACF;CACA,OAAe,kBAAkB,MAA2B;EAC1D,OAAO;GAAE;GAAM,MAAM;EAAO;CAC9B;CACA,SAAmB,MAAsC;EACvD,OAAO,CAAC,gBAAgB,kBAAkB,IAAI,CAAC;CACjD;CACA,cAAsB,UAA8B;EAClD,IAAI,KAAK,SAAS,WAAW,GAC3B,OAAO;GAAE,OAAO;GAAG,QAAQ;EAAE;EAG/B,IAAI,KAAK,SAAS,SAAS,KAAK,SAAS,SAAS,KAAK,SAAS,QAC9D,OAAO;GACL,OAAO,KAAK,SAAS,SAAS;GAC9B,QAAQ,aACN,KAAK,SAAS,GAAG,EAAE,GACnB,yCACF,CAAC,CAAC,KAAK;EACT;EAGF,IAAI,SAAS,QAAQ,GACnB,OAAO;GAAE,OAAO;GAAG,QAAQ;EAAE;EAG/B,OAAO;CACT;;CAEA,aACE,OACA,KACA,MACA,WAAW,MACL;EACN,OAAO,KAAK,yBACV,OACA,KACA,KAAK,SAAS,IAAI,CAAC,gBAAgB,kBAAkB,IAAI,CAAC,IAAI,CAAC,GAC/D,QACF;CACF;;CAEA,yBACE,cACA,YACA,QACA,WAAW,MACL;EACN,IAAI,QAAQ;EAEZ,IAAI,MAAM;EAEV,QAAQ,KAAK,cAAc,KAAK;EAChC,MAAM,KAAK,cAAc,GAAG;EAC5B,MAAM,eAAe,KAAK,SAAS,MAAM;EACzC,MAAM,aAAa,KAAK,SAAS,IAAI;EAErC,MAAM,CAAC,cAAc,gBAAgB,aACnC,cACA,MAAM,MACR;EAEA,MAAM,GAAG,YAAY,gBAAgB,aAAa,YAAY,IAAI,MAAM;EACxE,MAAM,cAAc,KAAK,SAAS,MAAM,GAAG,MAAM,KAAK;EAEtD,IAAI,YACF,eAAe,aAAa,CAAC,UAAU,CAAC;EAG1C,IAAI,OAAO,QACT,eAAe,aAAa,SAAS,SAAS,KAAK,SAAS,IAAI,CAAC;EAGnE,MAAM,cAAc,YAAY,GAAG,EAAE;EACrC,MAAM,aAAa,eAAe,YAAY,SAAS;EAEvD,MAAM,QAAQ;GACZ,OAAO,eAAe,OAAO,YAAY,SAAS,IAAI,YAAY;GAClE,QAAQ,eAAe,OAAO,YAAY,KAAK,SAAS;EAC1D;EAEA,IAAI,UACF,eAAe,aAAa,CAAC,QAAQ,CAAC;EAGxC,eAAe,aAAa,KAAK,SAAS,MAAM,IAAI,QAAQ,CAAC,CAAC;EAC9D,MAAM,WAAW,KAAK,iBAAiB,WAAW;EAClD,SAAS,gBAAgB,IAAI,cAAc,KAAK;EAChD,SAAS,eAAe;EAExB,IAAI,KAAK,gBAAgB,YAAY,KAAK,UAAU;GAClD,SAAS,WAAW,KAAK;GACzB,SAAS,SAAS,OAAO;EAC3B,OAAO;GACL,SAAS,WAAW;GACpB,KAAK,gBAAgB,IAAI,cAAc,OAAO,GAAG;GACjD,KAAK,OAAO;EACd;EAEA,OAAO;CACT;;CAEA,0BACE,iBACA,WACA,WACiB;EACjB,IAAI,WAAW;EAEf,WAAW,KAAK,cAAc,QAAQ;EAEtC,KACE,IAAI,IAAI,SAAS,OACjB,KAAK,KAAK,IAAI,KAAK,SAAS,QAC5B,KAAK,WACL;GACA,MAAM,UAAU,aACd,KAAK,SAAS,IACd,gDACF;GAEA,QAAQ,QAAQ,MAAhB;IACE,KAAK;KACH,IACE,MAAM,SAAS,UACd,cAAA,KACG,SAAS,SAAS,IAClB,SAAS,WAAW,IACxB;MACA,MAAM,QAAQ,IAAI;MAElB,OAAO;OACL,OAAO,KAAK,IAAI,OAAO,CAAC;OACxB,QACE,cAAA,MAAoC,SAAS,IACzC,aACE,KAAK,SAAS,QACd,yCACF,CAAC,CAAC,KAAK,SACP;MACR;KACF;KAEA;IAGF,KAAK,QAAQ;KACX,IAAI,SACF,cAAA,KAAmC,QAAQ,KAAK,SAAS;KAE3D,IAAI,MAAM,SAAS,OACjB,CAAC,CAAE,UAAW;KAGhB,IAAI,cAAA,IACF,UAAU;KAGZ,IAAI,SAAS,KAAK,UAAU,QAAQ,KAAK,QACvC;KAGF,IAAI,OAAO,UAAU,QAAQ,QAAQ,IAAI,CAAC,CAAC,WAAW,MAAM;KAE5D,OAAO,QAAQ,KAAK,eAAe,OAAO;MACxC,UAAU;MACV,OAAO,UAAU,QAAQ,QAAQ,IAAI,CAAC,CAAC,WAAW,MAAM;KAC1D;KAEA,IAAI,MACF,OAAO;MACL,OAAO;MACP,QACE,cAAA,KACI,KAAK,QACL,KAAK,QAAQ,KAAK,QAAQ;KAClC;KAGF;IACF;GAKF;EACF;EAEA,OAAO;CACT;;CAEA,iBAAiB,UAAoB,WAAuC;EAC1E,MAAM,MAAM,KAAK,SAAS,UAAU,WAAW,IAAI;EAEnD,IAAI,KACF,OAAO;EAGT,OAAO,cAAA,KACH;GAAE,OAAO;GAAG,QAAQ;EAAE,IACtB;GACE,OAAO,KAAK,IAAI,GAAG,KAAK,SAAS,SAAS,CAAC;GAC3C,QAAQ,KAAK,SAAS,GAAG,EAAE,CAAC,EAAE,KAAK,UAAU;EAC/C;CACN;;CAEA,SACE,UACA,WACA,QACiB;EACjB,IAAI,KAAK,SAAS,WAAW,GAC3B,OAAO;EAGT,KACE,IAAI,IAAI,SAAS,OACjB,KAAK,KAAK,IAAI,KAAK,SAAS,QAC5B,KAAK,WACL;GACA,MAAM,UAAU,aACd,KAAK,SAAS,IACd,gDACF;GAEA,IAAI,QAAQ,SAAS,QACnB;GAGF,MAAM,SAAS,WACb,QAAQ,MACR,QACA,WACA,MAAM,SAAS,QAAQ,SAAS,SAAS,KAAA,CAC3C;GAEA,IAAI,UAAU,GACZ,OAAO;IACL,OAAO;IACP;GACF;EAEJ;EAEA,OAAO;CACT;;CAEA,OACE,UACA,WACA,WACA,WAAW,MACL;EACN,MAAM,WAAW,KAAK,0BACpB,UACA,WACA,SACF;EAEA,IAAI,UACF,OAAO,KAAK,aACV,cAAA,KAAmC,WAAW,UAC9C,cAAA,KAAmC,WAAW,UAC9C,IACA,QACF;EAGF,OAAO,KAAK,kBAAkB,IAAI,cAAc,QAAQ,CAAC;CAC3D;;CAEA,WAAW,UAAoB,WAAsB,WAAW,MAAY;EAC1E,IAAI,KAAK,SAAS,WAAW,GAC3B,OAAO;EAGT,MAAM,WAAW,KAAK,iBAAiB,UAAU,SAAS;EAE1D,IAAI,UACF,OAAO,KAAK,aACV,cAAA,KAAmC,WAAW,UAC9C,cAAA,KAAmC,WAAW,UAC9C,IACA,QACF;EAGF,OAAO,KAAK,kBAAkB,IAAI,cAAc,QAAQ,CAAC;CAC3D;;CAEA,MAAM,cAAwB,YAA4B;EACxD,IAAI,QAAQ;EAEZ,IAAI,MAAM;EAEV,QAAQ,KAAK,cAAc,KAAK;EAChC,MAAM,KAAK,cAAc,GAAG;EAE5B,IAAI,MAAM,UAAU,IAAI,SAAS,MAAM,WAAW,IAAI,QACpD,OAAO,KAAK,iBAAiB,CAAC,CAAC;EAGjC,IAAI,MAAM,UAAU,IAAI,OAAO;GAC7B,MAAM,UAAU,aACd,KAAK,SAAS,MAAM,QACpB,mDACF;GAEA,IAAI,QAAQ,SAAS,QACnB,OAAO,KAAK,iBAAiB,CAC3B;IACE,MAAM,QAAQ,KAAK,MAAM,MAAM,QAAQ,IAAI,MAAM;IACjD,MAAM;GACR,CACF,CAAC;GAGH,OAAO,KAAK,iBAAiB,CAAC,OAAO,CAAC;EACxC;EAEA,MAAM,eAAe,KAAK,SAAS,MAAM;EACzC,MAAM,aAAa,KAAK,SAAS,IAAI;EAErC,MAAM,GAAG,cAAc,gBAAgB,aACrC,cACA,MAAM,MACR;EAEA,MAAM,CAAC,YAAY,gBAAgB,aAAa,YAAY,IAAI,MAAM;EACtE,MAAM,SAAiC,CAAC;EAExC,IAAI,YACF,OAAO,KAAK,UAAU;EAGxB,OAAO,KAAK,GAAG,KAAK,SAAS,MAAM,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC;EAE9D,IAAI,UACF,OAAO,KAAK,QAAQ;EAGtB,OAAO,KAAK,iBAAiB,MAAM;CACrC;;CAEA,WAAmB;EACjB,OAAO,KAAK,SAAS,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,KAAK,EAAE;CACrD;;CAEA,OAAa;EACX,OAAO,KAAK,YAAY;CAC1B;;CAEA,OAAa;EACX,OAAO,KAAK,QAAQ;CACtB;;CAEA,gBAAsB;EACpB,KAAK,eAAe;CACtB;AACF;AAEA,SAAS,WACP,MACA,QACA,WACA,YACQ;CACR,IAAI,OAAO,WAAW,UAAU;EAC9B,IAAI,cAAA,IACF,OAAO,KAAK,YACV,QACA,eAAe,KAAA,IAAY,KAAK,SAAS,IAAI,aAAa,CAC5D;EAGF,OAAO,KAAK,QAAQ,QAAQ,cAAc,CAAC;CAC7C;CAEA,IAAI,cAAA,GAAiC;EACnC,MAAM,QAAQ,cAAc;EAC5B,MAAM,QAAQ,KAAK,MAAM,KAAK,CAAC,CAAC,OAAO,MAAM;EAE7C,OAAO,SAAS,IAAI,QAAQ,QAAQ;CACtC;CAEA,MAAM,QAAQ,cAAc,KAAK;CAEjC,IAAI,QAAQ,GACV,OAAO;CAGT,MAAM,KAAK,OAAO,MAAM,SAAS,GAAG,IAChC,SACA,IAAI,OAAO,OAAO,QAAQ,GAAG,OAAO,MAAM,EAAE;CAIhD,OAAO,CAFU,GAAG,KAAK,MAAM,GAAG,KAAK,CAAC,CAAC,SAAS,EAAE,CAEvC,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,SAAS;AAClC;AAEA,SAAS,eACP,UACA,QACA,UACwB;CACxB,KAAK,MAAM,WAAW,QAAQ;EAC5B,IAAI,QAAQ,SAAS,UAAU,QAAQ,KAAK,WAAW,GACrD;EAGF,MAAM,OAAO,SAAS,GAAG,EAAE;EAE3B,IAAI,QAAQ,KAAK,SAAS,UAAU,QAAQ,SAAS,QAAQ;GAC3D,IAAI,UAAU;IACZ,MAAM,YAAY,SAAS,KAAK,OAAO,QAAQ,IAAI;IACnD,SAAS,OAAO,IAAI,GAAG,GAAG,SAAS;GACrC,OACE,SAAS,SAAS,SAAS,KAAK;IAC9B,MAAM,KAAK,OAAO,QAAQ;IAC1B,MAAM;GACR;EAEJ,OAAO,IAAI,YAAY,QAAQ,SAAS,QAAQ;GAC9C,MAAM,YAAY,SAAS,QAAQ,IAAI;GACvC,SAAS,KAAK,GAAG,SAAS;EAC5B,OACE,SAAS,KAAK,OAAO;CAEzB;CAEA,OAAO;AACT"}

package/dist/tooltip/create-tooltip-trigger-state.d.ts

@@ -0,0 +1,73 @@
+/*
+ * Copyright 2020 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+/*
+ * Derived from Adobe React Spectrum: packages/react-stately/src/tooltip/useTooltipTriggerState.ts.
+ * Modified for Solid Aria: adapted imports, collection descriptors, and reactive state APIs for Solid 2.
+ * Licensed under Apache-2.0. See LICENSES/Apache-2.0.txt and NOTICE.txt at the repository root.
+ */
+import { OverlayTriggerProps } from "../overlays/create-overlay-trigger-state.js";
+export interface TooltipTriggerProps extends OverlayTriggerProps {
+  /**
+   * Whether the tooltip should be disabled, independent from the trigger.
+   */
+  isDisabled?: boolean;
+  /**
+   * The delay time for the tooltip to show up. [See
+   * guidelines](https://spectrum.adobe.com/web/rsp/components/tooltip#behaviors).
+   *
+   * @default 1500
+   */
+  delay?: number;
+  /**
+   * The delay time for the tooltip to close. [See
+   * guidelines](https://spectrum.adobe.com/web/rsp/components/tooltip#behaviors).
+   *
+   * @default 500
+   */
+  closeDelay?: number;
+  /**
+   * By default, opens for both focus and hover. Can be made to open only for focus.
+   *
+   * @default 'hover'
+   */
+  trigger?: "hover" | "focus";
+  /**
+   * Whether the tooltip should close when the trigger is pressed.
+   *
+   * @default true
+   */
+  shouldCloseOnPress?: boolean;
+}
+export interface TooltipTriggerState {
+  /** Whether the tooltip is currently showing. */
+  isOpen: boolean;
+  /**
+   * Whether the tooltip is being shown or hidden without an animation. This is true while the
+   * global warmup timer is active, i.e. when quickly moving between tooltips.
+   */
+  shouldSkipAnimation: boolean;
+  /**
+   * Shows the tooltip. By default, the tooltip becomes visible after a delay
+   * depending on a global warmup timer. The `immediate` option shows the
+   * tooltip immediately instead.
+   */
+  open: (immediate?: boolean) => void;
+  /** Hides the tooltip. */
+  close: (immediate?: boolean) => void;
+}
+/**
+ * Manages state for a tooltip trigger. Tracks whether the tooltip is open, and provides
+ * methods to toggle this state. Ensures only one tooltip is open at a time and controls
+ * the delay for showing a tooltip.
+ */
+export declare function createTooltipTriggerState(props?: TooltipTriggerProps): TooltipTriggerState;
+//# sourceMappingURL=create-tooltip-trigger-state.d.ts.map

package/dist/tooltip/create-tooltip-trigger-state.js

@@ -0,0 +1,136 @@
+/*
+ * Copyright 2020 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+/*
+ * Derived from Adobe React Spectrum: packages/react-stately/src/tooltip/useTooltipTriggerState.ts.
+ * Modified for Solid Aria: adapted imports, collection descriptors, and reactive state APIs for Solid 2.
+ * Licensed under Apache-2.0. See LICENSES/Apache-2.0.txt and NOTICE.txt at the repository root.
+ */
+import { createOverlayTriggerState } from "../overlays/create-overlay-trigger-state.js";
+import { createSignal, onCleanup } from "solid-js";
+// src/tooltip/create-tooltip-trigger-state.ts
+const TOOLTIP_DELAY = 1500;
+const TOOLTIP_COOLDOWN = 500;
+const tooltips = /* @__PURE__ */ new Map();
+let tooltipId = 0;
+let globalWarmedUp = false;
+let globalWarmUpTimeout = null;
+let globalCooldownTimeout = null;
+/**
+* Manages state for a tooltip trigger. Tracks whether the tooltip is open, and provides
+* methods to toggle this state. Ensures only one tooltip is open at a time and controls
+* the delay for showing a tooltip.
+*/
+function createTooltipTriggerState(props = {}) {
+	const overlay = createOverlayTriggerState(props);
+	const open = () => {
+		if (!(props.isDisabled === true)) overlay.open();
+	};
+	const close = () => {
+		overlay.close();
+	};
+	const [shouldSkipAnimation, setIsInstant] = createSignal(false, { ownedWrite: true });
+	const id = `${tooltipId += 1}`;
+	let closeTimeout = null;
+	const ensureTooltipEntry = () => {
+		tooltips.set(id, hideTooltip);
+	};
+	const closeOpenTooltips = () => {
+		for (const [hideTooltipId, hide] of tooltips) if (hideTooltipId !== id) {
+			hide(true, true);
+			tooltips.delete(hideTooltipId);
+		}
+	};
+	const showTooltip = (instant) => {
+		if (closeTimeout) clearTimeout(closeTimeout);
+		closeTimeout = null;
+		closeOpenTooltips();
+		ensureTooltipEntry();
+		setIsInstant(instant === true);
+		globalWarmedUp = true;
+		open();
+		if (globalWarmUpTimeout) {
+			clearTimeout(globalWarmUpTimeout);
+			globalWarmUpTimeout = null;
+		}
+		if (globalCooldownTimeout) {
+			clearTimeout(globalCooldownTimeout);
+			globalCooldownTimeout = null;
+		}
+	};
+	function hideTooltip(immediate, instant) {
+		setIsInstant(instant === true);
+		if (immediate === true || (props.closeDelay ?? TOOLTIP_COOLDOWN) <= 0) {
+			if (closeTimeout) clearTimeout(closeTimeout);
+			closeTimeout = null;
+			close();
+		} else closeTimeout ??= setTimeout(() => {
+			closeTimeout = null;
+			close();
+		}, props.closeDelay ?? TOOLTIP_COOLDOWN);
+		if (globalWarmUpTimeout) {
+			clearTimeout(globalWarmUpTimeout);
+			globalWarmUpTimeout = null;
+		}
+		if (globalWarmedUp) {
+			if (globalCooldownTimeout) clearTimeout(globalCooldownTimeout);
+			globalCooldownTimeout = setTimeout(() => {
+				tooltips.delete(id);
+				globalCooldownTimeout = null;
+				globalWarmedUp = false;
+			}, Math.max(TOOLTIP_COOLDOWN, props.closeDelay ?? TOOLTIP_COOLDOWN));
+		}
+	}
+	const warmupTooltip = () => {
+		closeOpenTooltips();
+		ensureTooltipEntry();
+		if (!overlay.isOpen && !globalWarmedUp) {
+			if (globalWarmUpTimeout) clearTimeout(globalWarmUpTimeout);
+			globalWarmUpTimeout = setTimeout(() => {
+				globalWarmUpTimeout = null;
+				globalWarmedUp = true;
+				showTooltip(false);
+			}, props.delay ?? TOOLTIP_DELAY);
+		} else if (!overlay.isOpen) showTooltip(true);
+	};
+	onCleanup(() => {
+		if (closeTimeout) clearTimeout(closeTimeout);
+		if (tooltips.has(id)) {
+			tooltips.delete(id);
+			if (globalWarmUpTimeout) {
+				clearTimeout(globalWarmUpTimeout);
+				globalWarmUpTimeout = null;
+			}
+		}
+		if (tooltips.size === 0) {
+			if (globalCooldownTimeout) clearTimeout(globalCooldownTimeout);
+			globalCooldownTimeout = null;
+			globalWarmedUp = false;
+		}
+	});
+	return {
+		close: hideTooltip,
+		get isOpen() {
+			return overlay.isOpen;
+		},
+		open: (immediate) => {
+			if (props.isDisabled === true) return;
+			if (!(immediate === true) && (props.delay ?? TOOLTIP_DELAY) > 0 && !closeTimeout) warmupTooltip();
+			else showTooltip(globalWarmedUp);
+		},
+		get shouldSkipAnimation() {
+			return shouldSkipAnimation();
+		}
+	};
+}
+export { createTooltipTriggerState };
+
+//# sourceMappingURL=create-tooltip-trigger-state.js.map

package/dist/tooltip/create-tooltip-trigger-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-tooltip-trigger-state.js","names":[],"sources":["../../src/tooltip/create-tooltip-trigger-state.ts"],"sourcesContent":["/*\n * Copyright 2020 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n/*\n * Derived from Adobe React Spectrum: packages/react-stately/src/tooltip/useTooltipTriggerState.ts.\n * Modified for Solid Aria: adapted imports, collection descriptors, and reactive state APIs for Solid 2.\n * Licensed under Apache-2.0. See LICENSES/Apache-2.0.txt and NOTICE.txt at the repository root.\n */\n\nimport { createSignal, onCleanup } from \"solid-js\";\n\nimport { createOverlayTriggerState } from \"../overlays/create-overlay-trigger-state\";\nimport type { OverlayTriggerProps } from \"../overlays/create-overlay-trigger-state\";\n\nexport interface TooltipTriggerProps extends OverlayTriggerProps {\n  /**\n   * Whether the tooltip should be disabled, independent from the trigger.\n   */\n  isDisabled?: boolean;\n  /**\n   * The delay time for the tooltip to show up. [See\n   * guidelines](https://spectrum.adobe.com/web/rsp/components/tooltip#behaviors).\n   *\n   * @default 1500\n   */\n  delay?: number;\n  /**\n   * The delay time for the tooltip to close. [See\n   * guidelines](https://spectrum.adobe.com/web/rsp/components/tooltip#behaviors).\n   *\n   * @default 500\n   */\n  closeDelay?: number;\n  /**\n   * By default, opens for both focus and hover. Can be made to open only for focus.\n   *\n   * @default 'hover'\n   */\n  trigger?: \"hover\" | \"focus\";\n  /**\n   * Whether the tooltip should close when the trigger is pressed.\n   *\n   * @default true\n   */\n  shouldCloseOnPress?: boolean;\n}\n\n// this seems to be a 1.5 second delay, check with design\nconst TOOLTIP_DELAY = 1500;\nconst TOOLTIP_COOLDOWN = 500;\n\nexport interface TooltipTriggerState {\n  /** Whether the tooltip is currently showing. */\n  isOpen: boolean;\n  /**\n   * Whether the tooltip is being shown or hidden without an animation. This is true while the\n   * global warmup timer is active, i.e. when quickly moving between tooltips.\n   */\n  shouldSkipAnimation: boolean;\n  /**\n   * Shows the tooltip. By default, the tooltip becomes visible after a delay\n   * depending on a global warmup timer. The `immediate` option shows the\n   * tooltip immediately instead.\n   */\n  open: (immediate?: boolean) => void;\n  /** Hides the tooltip. */\n  close: (immediate?: boolean) => void;\n}\n\nconst tooltips = new Map<\n  string,\n  (immediate?: boolean, instant?: boolean) => void\n>();\n\nlet tooltipId = 0;\nlet globalWarmedUp = false;\nlet globalWarmUpTimeout: ReturnType<typeof setTimeout> | null = null;\nlet globalCooldownTimeout: ReturnType<typeof setTimeout> | null = null;\n\n/**\n * Manages state for a tooltip trigger. Tracks whether the tooltip is open, and provides\n * methods to toggle this state. Ensures only one tooltip is open at a time and controls\n * the delay for showing a tooltip.\n */\nexport function createTooltipTriggerState(\n  props: TooltipTriggerProps = {}\n): TooltipTriggerState {\n  const overlay = createOverlayTriggerState(props);\n\n  const open = () => {\n    if (!(props.isDisabled === true)) {\n      overlay.open();\n    }\n  };\n\n  const close = () => {\n    overlay.close();\n  };\n\n  // Whether the current open/close transition should skip its animation. Set when swapping\n  // between tooltips during the global warmup period.\n  const [shouldSkipAnimation, setIsInstant] = createSignal(false, {\n    ownedWrite: true,\n  });\n\n  const id = `${(tooltipId += 1)}`;\n\n  let closeTimeout: ReturnType<typeof setTimeout> | null = null;\n\n  const ensureTooltipEntry = () => {\n    tooltips.set(id, hideTooltip);\n  };\n\n  const closeOpenTooltips = () => {\n    for (const [hideTooltipId, hide] of tooltips) {\n      if (hideTooltipId !== id) {\n        // Close other open tooltips instantly (no exit animation), since they are being\n        // replaced by this one during the warmup period.\n        hide(true, true);\n        tooltips.delete(hideTooltipId);\n      }\n    }\n  };\n\n  const showTooltip = (instant?: boolean) => {\n    if (closeTimeout) {\n      clearTimeout(closeTimeout);\n    }\n\n    closeTimeout = null;\n    closeOpenTooltips();\n    ensureTooltipEntry();\n    setIsInstant(instant === true);\n    globalWarmedUp = true;\n    open();\n\n    if (globalWarmUpTimeout) {\n      clearTimeout(globalWarmUpTimeout);\n      globalWarmUpTimeout = null;\n    }\n\n    if (globalCooldownTimeout) {\n      clearTimeout(globalCooldownTimeout);\n      globalCooldownTimeout = null;\n    }\n  };\n\n  function hideTooltip(immediate?: boolean, instant?: boolean) {\n    setIsInstant(instant === true);\n\n    if (immediate === true || (props.closeDelay ?? TOOLTIP_COOLDOWN) <= 0) {\n      if (closeTimeout) {\n        clearTimeout(closeTimeout);\n      }\n\n      closeTimeout = null;\n      close();\n    } else {\n      closeTimeout ??= setTimeout(() => {\n        closeTimeout = null;\n        close();\n      }, props.closeDelay ?? TOOLTIP_COOLDOWN);\n    }\n\n    if (globalWarmUpTimeout) {\n      clearTimeout(globalWarmUpTimeout);\n      globalWarmUpTimeout = null;\n    }\n\n    if (globalWarmedUp) {\n      if (globalCooldownTimeout) {\n        clearTimeout(globalCooldownTimeout);\n      }\n\n      globalCooldownTimeout = setTimeout(\n        () => {\n          tooltips.delete(id);\n          globalCooldownTimeout = null;\n          globalWarmedUp = false;\n        },\n        Math.max(TOOLTIP_COOLDOWN, props.closeDelay ?? TOOLTIP_COOLDOWN)\n      );\n    }\n  }\n\n  const warmupTooltip = () => {\n    closeOpenTooltips();\n    ensureTooltipEntry();\n\n    if (!overlay.isOpen && !globalWarmedUp) {\n      if (globalWarmUpTimeout) {\n        clearTimeout(globalWarmUpTimeout);\n      }\n\n      globalWarmUpTimeout = setTimeout(() => {\n        globalWarmUpTimeout = null;\n        globalWarmedUp = true;\n        // First tooltip in a sequence: animate in.\n        showTooltip(false);\n      }, props.delay ?? TOOLTIP_DELAY);\n    } else if (!overlay.isOpen) {\n      // Already warmed up: appear instantly without an animation.\n      showTooltip(true);\n    }\n  };\n\n  onCleanup(() => {\n    if (closeTimeout) {\n      clearTimeout(closeTimeout);\n    }\n\n    if (tooltips.has(id)) {\n      tooltips.delete(id);\n\n      if (globalWarmUpTimeout) {\n        clearTimeout(globalWarmUpTimeout);\n        globalWarmUpTimeout = null;\n      }\n    }\n\n    if (tooltips.size === 0) {\n      if (globalCooldownTimeout) {\n        clearTimeout(globalCooldownTimeout);\n      }\n\n      globalCooldownTimeout = null;\n      globalWarmedUp = false;\n    }\n  });\n\n  return {\n    close: hideTooltip,\n    get isOpen() {\n      return overlay.isOpen;\n    },\n    open: (immediate) => {\n      if (props.isDisabled === true) {\n        return;\n      }\n\n      if (\n        !(immediate === true) &&\n        (props.delay ?? TOOLTIP_DELAY) > 0 &&\n        !closeTimeout\n      ) {\n        warmupTooltip();\n      } else {\n        // Immediate opens (e.g. focus, or (props.delay ?? TOOLTIP_DELAY) of 0) appear instantly without an animation\n        // only if another tooltip is already warmed up.\n        showTooltip(globalWarmedUp);\n      }\n    },\n    get shouldSkipAnimation() {\n      return shouldSkipAnimation();\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAwDA,MAAM,gBAAgB;AACtB,MAAM,mBAAmB;AAoBzB,MAAM,2BAAW,IAAI,IAGnB;AAEF,IAAI,YAAY;AAChB,IAAI,iBAAiB;AACrB,IAAI,sBAA4D;AAChE,IAAI,wBAA8D;;;;;;AAOlE,SAAgB,0BACd,QAA6B,CAAC,GACT;CACrB,MAAM,UAAU,0BAA0B,KAAK;CAE/C,MAAM,aAAa;EACjB,IAAI,EAAE,MAAM,eAAe,OACzB,QAAQ,KAAK;CAEjB;CAEA,MAAM,cAAc;EAClB,QAAQ,MAAM;CAChB;CAIA,MAAM,CAAC,qBAAqB,gBAAgB,aAAa,OAAO,EAC9D,YAAY,KACd,CAAC;CAED,MAAM,KAAK,GAAI,aAAa;CAE5B,IAAI,eAAqD;CAEzD,MAAM,2BAA2B;EAC/B,SAAS,IAAI,IAAI,WAAW;CAC9B;CAEA,MAAM,0BAA0B;EAC9B,KAAK,MAAM,CAAC,eAAe,SAAS,UAClC,IAAI,kBAAkB,IAAI;GAGxB,KAAK,MAAM,IAAI;GACf,SAAS,OAAO,aAAa;EAC/B;CAEJ;CAEA,MAAM,eAAe,YAAsB;EACzC,IAAI,cACF,aAAa,YAAY;EAG3B,eAAe;EACf,kBAAkB;EAClB,mBAAmB;EACnB,aAAa,YAAY,IAAI;EAC7B,iBAAiB;EACjB,KAAK;EAEL,IAAI,qBAAqB;GACvB,aAAa,mBAAmB;GAChC,sBAAsB;EACxB;EAEA,IAAI,uBAAuB;GACzB,aAAa,qBAAqB;GAClC,wBAAwB;EAC1B;CACF;CAEA,SAAS,YAAY,WAAqB,SAAmB;EAC3D,aAAa,YAAY,IAAI;EAE7B,IAAI,cAAc,SAAS,MAAM,cAAc,qBAAqB,GAAG;GACrE,IAAI,cACF,aAAa,YAAY;GAG3B,eAAe;GACf,MAAM;EACR,OACE,iBAAiB,iBAAiB;GAChC,eAAe;GACf,MAAM;EACR,GAAG,MAAM,cAAc,gBAAgB;EAGzC,IAAI,qBAAqB;GACvB,aAAa,mBAAmB;GAChC,sBAAsB;EACxB;EAEA,IAAI,gBAAgB;GAClB,IAAI,uBACF,aAAa,qBAAqB;GAGpC,wBAAwB,iBAChB;IACJ,SAAS,OAAO,EAAE;IAClB,wBAAwB;IACxB,iBAAiB;GACnB,GACA,KAAK,IAAI,kBAAkB,MAAM,cAAc,gBAAgB,CACjE;EACF;CACF;CAEA,MAAM,sBAAsB;EAC1B,kBAAkB;EAClB,mBAAmB;EAEnB,IAAI,CAAC,QAAQ,UAAU,CAAC,gBAAgB;GACtC,IAAI,qBACF,aAAa,mBAAmB;GAGlC,sBAAsB,iBAAiB;IACrC,sBAAsB;IACtB,iBAAiB;IAEjB,YAAY,KAAK;GACnB,GAAG,MAAM,SAAS,aAAa;EACjC,OAAO,IAAI,CAAC,QAAQ,QAElB,YAAY,IAAI;CAEpB;CAEA,gBAAgB;EACd,IAAI,cACF,aAAa,YAAY;EAG3B,IAAI,SAAS,IAAI,EAAE,GAAG;GACpB,SAAS,OAAO,EAAE;GAElB,IAAI,qBAAqB;IACvB,aAAa,mBAAmB;IAChC,sBAAsB;GACxB;EACF;EAEA,IAAI,SAAS,SAAS,GAAG;GACvB,IAAI,uBACF,aAAa,qBAAqB;GAGpC,wBAAwB;GACxB,iBAAiB;EACnB;CACF,CAAC;CAED,OAAO;EACL,OAAO;EACP,IAAI,SAAS;GACX,OAAO,QAAQ;EACjB;EACA,OAAO,cAAc;GACnB,IAAI,MAAM,eAAe,MACvB;GAGF,IACE,EAAE,cAAc,UACf,MAAM,SAAS,iBAAiB,KACjC,CAAC,cAED,cAAc;QAId,YAAY,cAAc;EAE9B;EACA,IAAI,sBAAsB;GACxB,OAAO,oBAAoB;EAC7B;CACF;AACF"}

package/dist/tree/create-tree-state.d.ts

@@ -0,0 +1,42 @@
+/*
+ * Copyright 2020 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+/*
+ * Derived from Adobe React Spectrum: packages/react-stately/src/tree/useTreeState.ts.
+ * Modified for Solid Aria: adapted imports, collection descriptors, and reactive state APIs for Solid 2.
+ * Licensed under Apache-2.0. See LICENSES/Apache-2.0.txt and NOTICE.txt at the repository root.
+ */
+import { SelectionManager } from "../selection/selection-manager.js";
+import { Collection, CollectionStateBase, DisabledBehavior, Expandable, Key, MultipleSelection, Node } from "@solid2-aria/types-shared";
+export interface TreeProps<T> extends CollectionStateBase<T>, Expandable, MultipleSelection {
+  /** Whether `disabledKeys` applies to all interactions, or only selection. */
+  disabledBehavior?: DisabledBehavior;
+}
+export interface TreeState<T> {
+  /** A collection of items in the tree. */
+  readonly collection: Collection<Node<T>>;
+  /** A set of keys for items that are disabled. */
+  readonly disabledKeys: Set<Key>;
+  /** A set of keys for items that are expanded. */
+  readonly expandedKeys: Set<Key>;
+  /** Toggles the expanded state for an item by its key. */
+  toggleKey: (key: Key) => void;
+  /** Replaces the set of expanded keys. */
+  setExpandedKeys: (keys: Set<Key>) => void;
+  /** A selection manager to read and update multiple selection state. */
+  readonly selectionManager: SelectionManager;
+}
+/**
+ * Provides state management for tree-like components. Handles building a collection
+ * of items from props, item expanded state, and manages multiple selection state.
+ */
+export declare function createTreeState<T extends object>(props: TreeProps<T>): TreeState<T>;
+//# sourceMappingURL=create-tree-state.d.ts.map