elements-kit 0.3.1 → 0.3.3

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 };