elements-kit 0.3.2 → 0.3.4

package/dist/slot-BnzxFBfO.mjs

@@ -1,198 +0,0 @@
-import "./polyfill-CdZVCxdo.mjs";
-//#region src/lib.ts
-var UnsupportedChildError = class extends Error {
-	constructor(value) {
-		super(`Unsupported child type: ${typeof value}`);
-		this.name = "UnsupportedChildError";
-	}
-};
-function resolveNode(c) {
-	if (c instanceof Node) return c;
-	if (c === null || c === void 0 || typeof c === "boolean") return document.createComment("");
-	if (typeof c === "string" || typeof c === "number" || typeof c === "bigint" || typeof c === "symbol" || c instanceof Date || c instanceof RegExp) return document.createTextNode(String(c));
-	throw new UnsupportedChildError(c);
-}
-//#endregion
-//#region src/slot.ts
-/**
-* A lightweight slot that reserves a region in the DOM using comment markers.
-* Content between the markers can be replaced dynamically without wrapper elements.
-*/
-var Slot = class Slot {
-	start = document.createComment("{");
-	end = document.createComment("}");
-	#pending;
-	/**
-	* Render the slot as a DocumentFragment.
-	* If not yet mounted, inserts the comment markers and optional default content.
-	* If already mounted, extracts and returns the current content WITHOUT disposing
-	* it — the caller takes ownership of the returned nodes and is responsible for
-	* their disposal.
-	*/
-	slot(defaultContent) {
-		const fragment = document.createDocumentFragment();
-		if (this.isMounted()) {
-			const range = document.createRange();
-			range.setStartAfter(this.start);
-			range.setEndBefore(this.end);
-			fragment.appendChild(range.extractContents());
-			return fragment;
-		}
-		fragment.appendChild(this.start);
-		fragment.appendChild(this.end);
-		const initialContent = this.#pending ?? resolveNode(defaultContent);
-		if (initialContent) fragment.insertBefore(initialContent, this.end);
-		this.#pending = void 0;
-		return fragment;
-	}
-	/** Dispose reactive children and remove all content between the markers. */
-	clear() {
-		let node = this.start.nextSibling;
-		while (node && node !== this.end) {
-			const next = node.nextSibling;
-			if (node instanceof Element) node[Symbol.dispose]?.();
-			node = next;
-		}
-		const range = document.createRange();
-		range.setStartAfter(this.start);
-		range.setEndBefore(this.end);
-		range.deleteContents();
-	}
-	/**
-	* Replace the slot's content with the given element.
-	* No-op if the slot is not mounted or the content is identical.
-	*/
-	set(element) {
-		const parent = this.parent();
-		if (!parent) {
-			this.#pending = element;
-			return;
-		}
-		if (this.isSame(element)) return;
-		this.clear();
-		parent.insertBefore(element, this.end);
-		this.#pending = void 0;
-	}
-	/**
-	* Extract and return the current slot content as a DocumentFragment.
-	* Returns `null` if the slot is not mounted.
-	* Content is NOT disposed — the caller takes ownership and is responsible
-	* for disposal.
-	*/
-	get() {
-		if (!this.isMounted()) return null;
-		const range = document.createRange();
-		range.setStartAfter(this.start);
-		range.setEndBefore(this.end);
-		return range.extractContents();
-	}
-	/** Returns the parent node if the slot is mounted, otherwise `null`. */
-	parent() {
-		return this.isMounted() ? this.start.parentNode : null;
-	}
-	/** Whether the slot's comment markers are attached to the DOM. */
-	isMounted() {
-		return this.start.parentNode === this.end.parentNode && !!this.start.parentNode;
-	}
-	isSame(element) {
-		return this.start.nextSibling === element && this.end === element.nextSibling;
-	}
-	/**
-	* Create a callable slot instance.
-	*
-	* The returned value is both a function and an object:
-	* - Call it to render the slot with optional default content.
-	* - Access `.set()`, `.parent()`, `.isMounted()` for slot management.
-	*
-	* @example
-	* ```ts
-	* const slot = createSlot();
-	* el.append(slot("default text"));  // mount with default
-	* slot.set(newElement);              // replace content
-	* ```
-	*/
-	static new() {
-		const instance = new Slot();
-		return new Proxy(instance.slot.bind(instance), {
-			apply(target, _thisArg, argArray) {
-				return target(...argArray);
-			},
-			get(_target, prop) {
-				const value = instance[prop];
-				return typeof value === "function" ? value.bind(instance) : value;
-			},
-			getPrototypeOf() {
-				return Slot.prototype;
-			}
-		});
-	}
-};
-/**
-* Symbol key for attaching a `Slots` instance to a custom element instance.
-* This prevent collisions with Element properties and are not meant to be treated as JSX children.
-*/
-const SLOTS = Symbol("slots");
-const $map = Symbol("map");
-const $keys = Symbol("keys");
-const $has = Symbol("has");
-/**
-* A keyed collection of slot instances.
-* Slots are pre-created from the provided keys and lazily created on first access for unknown keys.
-*/
-var Slots = class Slots {
-	[$map] = /* @__PURE__ */ new Map();
-	constructor(keys = []) {
-		for (const key of keys) this[$map].set(key, Slot.new());
-	}
-	[Symbol.iterator]() {
-		return this[$map][Symbol.iterator]();
-	}
-	[Symbol.toStringTag]() {
-		return "Slots";
-	}
-	[Symbol.hasInstance](instance) {
-		return instance instanceof Slots;
-	}
-	[$has](key) {
-		return this[$map].has(key);
-	}
-	/** Check whether a slot with the given key exists. */
-	static has(slots, key) {
-		return slots[$has](key);
-	}
-	[$keys]() {
-		return this[$map].keys();
-	}
-	/** Iterate over all registered slot keys. */
-	static keys(slots) {
-		return slots[$keys]();
-	}
-	/**
-	* Create a typed `Slots` collection from a list of key names.
-	*
-	* Pass the keys with `as const` so TS narrows them to a literal union —
-	* this is what lets `ElementProps<typeof Cls>` synthesize `slot:${K}`
-	* entries. Without `as const`, the array type widens to `string[]` and
-	* the slot keys are lost.
-	*
-	* @example
-	* ```ts
-	* class Card extends HTMLElement {
-	*   // ✅ literal keys flow through — "header" | "footer"
-	*   [SLOTS] = Slots.new(["header", "footer"] as const);
-	* }
-	*
-	* // ❌ widens to string; no typed slot:* props
-	* // [SLOTS] = Slots.new(["header", "footer"]);
-	* ```
-	*/
-	static new(keys) {
-		const instance = new Slots(keys);
-		return new Proxy(instance, { get(target, prop, receiver) {
-			if (typeof prop === "string" && target[$map].has(prop)) return target[$map].get(prop);
-			return Reflect.get(target, prop, receiver);
-		} });
-	}
-};
-//#endregion
-export { resolveNode as i, Slot as n, Slots as r, SLOTS as t };

package/dist/slot-CfafCBOW.d.mts

@@ -1,121 +0,0 @@
-//#region src/lib.d.ts
-type PrimitiveNodeType = Node | string | boolean | number | bigint | symbol | Date | RegExp | null | undefined;
-//#endregion
-//#region src/polyfill.d.ts
-declare global {
-  interface SymbolConstructor {
-    readonly dispose: symbol;
-  }
-  interface Disposable {
-    [Symbol.dispose](): void;
-  }
-}
-//#endregion
-//#region src/slot.d.ts
-/**
- * A lightweight slot that reserves a region in the DOM using comment markers.
- * Content between the markers can be replaced dynamically without wrapper elements.
- */
-declare class Slot {
-  #private;
-  private readonly start;
-  private readonly end;
-  /**
-   * Render the slot as a DocumentFragment.
-   * If not yet mounted, inserts the comment markers and optional default content.
-   * If already mounted, extracts and returns the current content WITHOUT disposing
-   * it — the caller takes ownership of the returned nodes and is responsible for
-   * their disposal.
-   */
-  slot(defaultContent?: PrimitiveNodeType): DocumentFragment;
-  /** Dispose reactive children and remove all content between the markers. */
-  clear(): void;
-  /**
-   * Replace the slot's content with the given element.
-   * No-op if the slot is not mounted or the content is identical.
-   */
-  set(element: Node): void;
-  /**
-   * Extract and return the current slot content as a DocumentFragment.
-   * Returns `null` if the slot is not mounted.
-   * Content is NOT disposed — the caller takes ownership and is responsible
-   * for disposal.
-   */
-  get(): DocumentFragment | null;
-  /** Returns the parent node if the slot is mounted, otherwise `null`. */
-  parent(): ParentNode | null;
-  /** Whether the slot's comment markers are attached to the DOM. */
-  isMounted(): boolean;
-  private isSame;
-  /**
-   * Create a callable slot instance.
-   *
-   * The returned value is both a function and an object:
-   * - Call it to render the slot with optional default content.
-   * - Access `.set()`, `.parent()`, `.isMounted()` for slot management.
-   *
-   * @example
-   * ```ts
-   * const slot = createSlot();
-   * el.append(slot("default text"));  // mount with default
-   * slot.set(newElement);              // replace content
-   * ```
-   */
-  static new(): Slot & ((defaultContent?: PrimitiveNodeType) => DocumentFragment);
-}
-/**
- * A callable slot returned by {@link Slot.new}.
- *
- * - Invoke it (`slot()`) to render the slot region as a `DocumentFragment`,
- *   optionally with default content on first mount.
- * - Call `.set()` to replace current content, `.clear()` to empty it, and
- *   `.isMounted()` / `.parent()` to inspect mount state.
- */
-type SlotInstance = ReturnType<typeof Slot.new>;
-/**
- * Symbol key for attaching a `Slots` instance to a custom element instance.
- * This prevent collisions with Element properties and are not meant to be treated as JSX children.
- */
-declare const SLOTS: unique symbol;
-declare const $map: unique symbol;
-declare const $keys: unique symbol;
-declare const $has: unique symbol;
-/**
- * A keyed collection of slot instances.
- * Slots are pre-created from the provided keys and lazily created on first access for unknown keys.
- */
-declare class Slots<K extends string> implements Iterable<[K, SlotInstance]> {
-  readonly [$map]: Map<K, Slot & ((defaultContent?: PrimitiveNodeType) => DocumentFragment)>;
-  private constructor();
-  [Symbol.iterator](): MapIterator<[K, Slot & ((defaultContent?: PrimitiveNodeType) => DocumentFragment)]>;
-  [Symbol.toStringTag](): string;
-  [Symbol.hasInstance](instance: unknown): instance is Slots<any>;
-  [$has](key: K): boolean;
-  /** Check whether a slot with the given key exists. */
-  static has<K extends string>(slots: Slots<K>, key: K): boolean;
-  [$keys](): MapIterator<K>;
-  /** Iterate over all registered slot keys. */
-  static keys<K extends string>(slots: Slots<K>): MapIterator<K>;
-  /**
-   * Create a typed `Slots` collection from a list of key names.
-   *
-   * Pass the keys with `as const` so TS narrows them to a literal union —
-   * this is what lets `ElementProps<typeof Cls>` synthesize `slot:${K}`
-   * entries. Without `as const`, the array type widens to `string[]` and
-   * the slot keys are lost.
-   *
-   * @example
-   * ```ts
-   * class Card extends HTMLElement {
-   *   // ✅ literal keys flow through — "header" | "footer"
-   *   [SLOTS] = Slots.new(["header", "footer"] as const);
-   * }
-   *
-   * // ❌ widens to string; no typed slot:* props
-   * // [SLOTS] = Slots.new(["header", "footer"]);
-   * ```
-   */
-  static new<K extends string>(keys: K[]): Slots<K> & { readonly [P in K]: SlotInstance };
-}
-//#endregion
-export { PrimitiveNodeType as a, Slots as i, Slot as n, SlotInstance as r, SLOTS as t };