@pzerelles/headlessui-svelte 2.1.1-next.1 → 2.1.2-next.10

package/dist/tabs/TabPanel.svelte

@@ -1,34 +1,30 @@
-<script lang="ts" context="module">const DEFAULT_PANEL_TAG = "div";
+<script lang="ts" module>const DEFAULT_PANEL_TAG = "div";
 const PanelRenderFeatures = RenderFeatures.RenderStrategy | RenderFeatures.Static;
 </script>
 
-<script lang="ts" generics="TTag extends ElementType">import { useId } from "../hooks/use-id.js";
-import { RenderFeatures } from "../utils/render.js";
+<script lang="ts" generics="TTag extends ElementType = typeof DEFAULT_PANEL_TAG">import { useId } from "../hooks/use-id.js";
+import { mergeProps, RenderFeatures } from "../utils/render.js";
 import { useActions, useData } from "./TabGroup.svelte";
 import { useStableCollectionIndex } from "../utils/StableCollection.svelte";
 import { useFocusRing } from "../hooks/use-focus-ring.svelte.js";
 import Hidden from "../internal/Hidden.svelte";
-import { stateFromSlot } from "../utils/state.js";
 import { onMount } from "svelte";
+import ElementOrComponent from "../utils/ElementOrComponent.svelte";
 const internalId = useId();
-const {
-  as,
+let {
+  ref = $bindable(),
   id = `headlessui-tabs-panel-${internalId}`,
   tabIndex = 0,
-  children,
-  static: isStatic = false,
-  unmount = true,
   ...theirProps
 } = $props();
 const data = useData("Tab.Panel");
 const { selectedIndex, tabs, panels } = $derived(data);
 const actions = useActions("Tab.Panel");
-let internalPanelRef = $state();
-const panelRef = $derived({ current: internalPanelRef });
+const panelRef = $derived({ current: ref });
 onMount(() => actions.registerPanel(panelRef));
 const mySSRIndex = useStableCollectionIndex("panels");
 const myIndex = $derived.by(() => {
-  const index = tabs.findIndex((panel) => $state.is(panel, panelRef));
+  const index = tabs.findIndex((panel) => panel === panelRef);
   return index === -1 ? mySSRIndex : index;
 });
 const selected = $derived(myIndex === selectedIndex);
@@ -37,27 +33,29 @@ const slot = $derived({
   selected,
   focus
 });
-const ourProps = $derived({
-  id,
-  role: "tabpanel",
-  "aria-labelledby": tabs[myIndex]?.current?.id,
-  tabIndex: selected ? 0 : -1,
-  ...focusProps,
-  ...stateFromSlot(slot)
-});
+const ourProps = $derived(
+  mergeProps(
+    {
+      id,
+      role: "tabpanel",
+      "aria-labelledby": tabs[myIndex]?.current?.id,
+      tabIndex: selected ? 0 : -1
+    },
+    focusProps
+  )
+);
 </script>
 
-{#if !selected && unmount && !isStatic}
-  <Hidden as="span" bind:ref={internalPanelRef} aria-hidden="true" {...ourProps} />
+{#if !selected && (theirProps.unmount ?? true) && !(theirProps.static ?? false)}
+  <Hidden aria-hidden="true" {...ourProps} bind:ref />
 {:else}
-  <svelte:element
-    this={as ?? DEFAULT_PANEL_TAG}
-    bind:this={internalPanelRef}
-    {...ourProps}
-    {...theirProps}
-    hidden={isStatic || selected ? undefined : true}
-    style={isStatic || selected ? theirProps.style : "display: none;"}
-  >
-    {#if children}{@render children(slot)}{/if}
-  </svelte:element>
+  <ElementOrComponent
+    {ourProps}
+    {theirProps}
+    {slot}
+    defaultTag={DEFAULT_PANEL_TAG}
+    features={PanelRenderFeatures}
+    name="TabPanel"
+    bind:ref
+  />
 {/if}

package/dist/tabs/TabPanel.svelte.d.ts

@@ -11,24 +11,37 @@ export type TabPanelProps<TTag extends ElementType = typeof DEFAULT_PANEL_TAG> =
     tabIndex?: number;
 }>;
 import { type PropsForFeatures } from "../utils/render.js";
-declare class __sveltets_Render<TTag extends ElementType> {
-    props(): TabPanelProps<TTag>;
+declare class __sveltets_Render<TTag extends ElementType = typeof DEFAULT_PANEL_TAG> {
+    props(): {
+        as?: TTag | undefined;
+    } & (Exclude<keyof import("../utils/types.js").PropsOf<TTag>, ("as" | "children" | "refName" | "class") | "unmount" | "static" | "id" | "tabIndex" | PanelPropsWeControl> extends infer T extends keyof import("../utils/types.js").PropsOf<TTag> ? { [P in T]: import("../utils/types.js").PropsOf<TTag>[P]; } : never) & {
+        children?: import("../utils/types.js").Children<PanelRenderPropArg> | undefined;
+        ref?: HTMLElement;
+    } & (true extends (import("../utils/types.js").PropsOf<TTag> extends infer T_1 ? T_1 extends import("../utils/types.js").PropsOf<TTag> ? T_1 extends never ? never : "class" extends infer T_2 ? T_2 extends "class" ? T_2 extends keyof T_1 ? true : never : never : never : never : never) ? {
+        class?: import("../utils/types.js").PropsOf<TTag>["class"] | ((bag: PanelRenderPropArg) => string) | undefined;
+    } : {}) & {
+        static?: boolean | undefined;
+        unmount?: boolean | undefined;
+    } & {
+        id?: string;
+        tabIndex?: number;
+    };
     events(): {} & {
         [evt: string]: CustomEvent<any>;
     };
     slots(): {};
-    bindings(): "";
+    bindings(): "ref";
     exports(): {};
 }
 interface $$IsomorphicComponent {
-    new <TTag extends ElementType>(options: import('svelte').ComponentConstructorOptions<ReturnType<__sveltets_Render<TTag>['props']>>): import('svelte').SvelteComponent<ReturnType<__sveltets_Render<TTag>['props']>, ReturnType<__sveltets_Render<TTag>['events']>, ReturnType<__sveltets_Render<TTag>['slots']>> & {
+    new <TTag extends ElementType = typeof DEFAULT_PANEL_TAG>(options: import('svelte').ComponentConstructorOptions<ReturnType<__sveltets_Render<TTag>['props']>>): import('svelte').SvelteComponent<ReturnType<__sveltets_Render<TTag>['props']>, ReturnType<__sveltets_Render<TTag>['events']>, ReturnType<__sveltets_Render<TTag>['slots']>> & {
         $$bindings?: ReturnType<__sveltets_Render<TTag>['bindings']>;
     } & ReturnType<__sveltets_Render<TTag>['exports']>;
-    <TTag extends ElementType>(internal: unknown, props: ReturnType<__sveltets_Render<TTag>['props']> & {
+    <TTag extends ElementType = typeof DEFAULT_PANEL_TAG>(internal: unknown, props: ReturnType<__sveltets_Render<TTag>['props']> & {
         $$events?: ReturnType<__sveltets_Render<TTag>['events']>;
     }): ReturnType<__sveltets_Render<TTag>['exports']>;
     z_$$bindings?: ReturnType<__sveltets_Render<any>['bindings']>;
 }
 declare const TabPanel: $$IsomorphicComponent;
-type TabPanel<TTag extends ElementType> = InstanceType<typeof TabPanel<TTag>>;
+type TabPanel<TTag extends ElementType = typeof DEFAULT_PANEL_TAG> = InstanceType<typeof TabPanel<TTag>>;
 export default TabPanel;

package/dist/tabs/TabPanels.svelte

@@ -1,13 +1,12 @@
-<script lang="ts" context="module">import { useData } from "./TabGroup.svelte";
+<script lang="ts" module>import ElementOrComponent from "../utils/ElementOrComponent.svelte";
+import { useData } from "./TabGroup.svelte";
 let DEFAULT_PANELS_TAG = "div";
 </script>
 
-<script lang="ts" generics="TTag extends ElementType">const data = useData("Tab.Panels");
+<script lang="ts" generics="TTag extends ElementType = typeof DEFAULT_PANELS_TAG">const data = useData("Tab.Panels");
 const { selectedIndex } = $derived(data);
 const slot = $derived({ selectedIndex });
-const { as, children, ...theirProps } = $props();
+let { ref = $bindable(), ...theirProps } = $props();
 </script>
 
-<svelte:element this={as ?? DEFAULT_PANELS_TAG} {...theirProps}>
-  {#if children}{@render children(slot)}{/if}
-</svelte:element>
+<ElementOrComponent {theirProps} {slot} defaultTag={DEFAULT_PANELS_TAG} name="TabPanel" bind:ref />

package/dist/tabs/TabPanels.svelte.d.ts

@@ -4,24 +4,31 @@ type PanelsRenderPropArg = {
     selectedIndex: number;
 };
 export type TabPanelsProps<TTag extends ElementType = typeof DEFAULT_PANELS_TAG> = Props<TTag, PanelsRenderPropArg>;
-declare class __sveltets_Render<TTag extends ElementType> {
-    props(): TabPanelsProps<TTag>;
+declare class __sveltets_Render<TTag extends ElementType = typeof DEFAULT_PANELS_TAG> {
+    props(): {
+        as?: TTag | undefined;
+    } & (Exclude<keyof import("../utils/types.js").PropsOf<TTag>, "as" | "children" | "refName" | "class"> extends infer T extends keyof import("../utils/types.js").PropsOf<TTag> ? { [P in T]: import("../utils/types.js").PropsOf<TTag>[P]; } : never) & {
+        children?: import("../utils/types.js").Children<PanelsRenderPropArg> | undefined;
+        ref?: HTMLElement;
+    } & (true extends (import("../utils/types.js").PropsOf<TTag> extends infer T_1 ? T_1 extends import("../utils/types.js").PropsOf<TTag> ? T_1 extends never ? never : "class" extends infer T_2 ? T_2 extends "class" ? T_2 extends keyof T_1 ? true : never : never : never : never : never) ? {
+        class?: import("../utils/types.js").PropsOf<TTag>["class"] | ((bag: PanelsRenderPropArg) => string) | undefined;
+    } : {});
     events(): {} & {
         [evt: string]: CustomEvent<any>;
     };
     slots(): {};
-    bindings(): "";
+    bindings(): "ref";
     exports(): {};
 }
 interface $$IsomorphicComponent {
-    new <TTag extends ElementType>(options: import('svelte').ComponentConstructorOptions<ReturnType<__sveltets_Render<TTag>['props']>>): import('svelte').SvelteComponent<ReturnType<__sveltets_Render<TTag>['props']>, ReturnType<__sveltets_Render<TTag>['events']>, ReturnType<__sveltets_Render<TTag>['slots']>> & {
+    new <TTag extends ElementType = typeof DEFAULT_PANELS_TAG>(options: import('svelte').ComponentConstructorOptions<ReturnType<__sveltets_Render<TTag>['props']>>): import('svelte').SvelteComponent<ReturnType<__sveltets_Render<TTag>['props']>, ReturnType<__sveltets_Render<TTag>['events']>, ReturnType<__sveltets_Render<TTag>['slots']>> & {
         $$bindings?: ReturnType<__sveltets_Render<TTag>['bindings']>;
     } & ReturnType<__sveltets_Render<TTag>['exports']>;
-    <TTag extends ElementType>(internal: unknown, props: ReturnType<__sveltets_Render<TTag>['props']> & {
+    <TTag extends ElementType = typeof DEFAULT_PANELS_TAG>(internal: unknown, props: ReturnType<__sveltets_Render<TTag>['props']> & {
         $$events?: ReturnType<__sveltets_Render<TTag>['events']>;
     }): ReturnType<__sveltets_Render<TTag>['exports']>;
     z_$$bindings?: ReturnType<__sveltets_Render<any>['bindings']>;
 }
 declare const TabPanels: $$IsomorphicComponent;
-type TabPanels<TTag extends ElementType> = InstanceType<typeof TabPanels<TTag>>;
+type TabPanels<TTag extends ElementType = typeof DEFAULT_PANELS_TAG> = InstanceType<typeof TabPanels<TTag>>;
 export default TabPanels;

package/dist/textarea/Textarea.svelte

@@ -0,0 +1,67 @@
+<script lang="ts" module>const DEFAULT_TEXTAREA_TAG = "textarea";
+</script>
+
+<script lang="ts" generics="TTag extends ElementType = typeof DEFAULT_TEXTAREA_TAG, TValue = string">import { htmlid } from "../utils/id.js";
+import { useDisabled } from "../hooks/use-disabled.js";
+import { useProvidedId } from "../utils/id.js";
+import { useLabelledBy } from "../label/context.svelte.js";
+import { useDescribedBy } from "../description/context.svelte.js";
+import { useHover } from "../hooks/use-hover.svelte.js";
+import { useFocusRing } from "../hooks/use-focus-ring.svelte.js";
+import { mergeProps } from "../utils/render.js";
+import ElementOrComponent from "../utils/ElementOrComponent.svelte";
+const internalId = htmlid();
+const providedId = useProvidedId();
+const providedDisabled = useDisabled();
+let {
+  ref = $bindable(),
+  value = $bindable(),
+  id = providedId || `headlessui-input-${internalId}`,
+  disabled: theirDisabled = false,
+  autofocus = false,
+  invalid = false,
+  ...theirProps
+} = $props();
+const disabled = $derived(providedDisabled?.value ?? theirDisabled);
+const labelledBy = useLabelledBy();
+const describedBy = useDescribedBy();
+const { isFocusVisible: focus, focusProps } = $derived(
+  useFocusRing({
+    get autofocus() {
+      return autofocus;
+    }
+  })
+);
+const { isHovered: hover, hoverProps } = $derived(
+  useHover({
+    get disabled() {
+      return disabled;
+    }
+  })
+);
+const ourProps = $derived(
+  mergeProps(
+    {
+      id,
+      "aria-labelledby": labelledBy?.value,
+      "aria-describedby": describedBy?.value,
+      "aria-invalid": invalid ? "" : void 0,
+      disabled: disabled || void 0,
+      autofocus
+    },
+    focusProps,
+    hoverProps
+  )
+);
+const slot = $derived({ disabled, invalid, hover, focus, autofocus });
+</script>
+
+<ElementOrComponent
+  {ourProps}
+  {theirProps}
+  {slot}
+  defaultTag={DEFAULT_TEXTAREA_TAG}
+  name="Textarea"
+  bind:ref
+  bind:value
+/>

package/dist/textarea/Textarea.svelte.d.ts

@@ -0,0 +1,50 @@
+import type { ElementType, Props, PropsOf } from "../utils/types.js";
+declare const DEFAULT_TEXTAREA_TAG: "textarea";
+type TextareaRenderPropArg = {
+    disabled: boolean;
+    hover: boolean;
+    focus: boolean;
+    autofocus: boolean;
+    invalid: boolean;
+};
+type TextareaPropsWeControl = "aria-labelledby" | "aria-describedby";
+export type TextareaProps<TTag extends ElementType = typeof DEFAULT_TEXTAREA_TAG, TValue = string> = Props<TTag, TextareaRenderPropArg, TextareaPropsWeControl, {
+    value?: TValue;
+    disabled?: boolean;
+    invalid?: boolean;
+    autofocus?: boolean;
+}>;
+declare class __sveltets_Render<TTag extends ElementType = typeof DEFAULT_TEXTAREA_TAG, TValue = string> {
+    props(): {
+        as?: TTag | undefined;
+        value?: TValue | undefined;
+    } & (Exclude<keyof PropsOf<TTag>, ("as" | "children" | "refName" | "class") | "invalid" | "disabled" | "autofocus" | "value" | TextareaPropsWeControl> extends infer T extends keyof PropsOf<TTag> ? { [P in T]: PropsOf<TTag>[P]; } : never) & {
+        children?: import("../utils/types.js").Children<TextareaRenderPropArg> | undefined;
+        ref?: HTMLElement;
+    } & (true extends (PropsOf<TTag> extends infer T_1 ? T_1 extends PropsOf<TTag> ? T_1 extends never ? never : "class" extends infer T_2 ? T_2 extends "class" ? T_2 extends keyof T_1 ? true : never : never : never : never : never) ? {
+        class?: PropsOf<TTag>["class"] | ((bag: TextareaRenderPropArg) => string) | undefined;
+    } : {}) & {
+        value?: TValue | undefined;
+        disabled?: boolean;
+        invalid?: boolean;
+        autofocus?: boolean;
+    };
+    events(): {} & {
+        [evt: string]: CustomEvent<any>;
+    };
+    slots(): {};
+    bindings(): "ref" | "value";
+    exports(): {};
+}
+interface $$IsomorphicComponent {
+    new <TTag extends ElementType = typeof DEFAULT_TEXTAREA_TAG, TValue = string>(options: import('svelte').ComponentConstructorOptions<ReturnType<__sveltets_Render<TTag, TValue>['props']>>): import('svelte').SvelteComponent<ReturnType<__sveltets_Render<TTag, TValue>['props']>, ReturnType<__sveltets_Render<TTag, TValue>['events']>, ReturnType<__sveltets_Render<TTag, TValue>['slots']>> & {
+        $$bindings?: ReturnType<__sveltets_Render<TTag, TValue>['bindings']>;
+    } & ReturnType<__sveltets_Render<TTag, TValue>['exports']>;
+    <TTag extends ElementType = typeof DEFAULT_TEXTAREA_TAG, TValue = string>(internal: unknown, props: ReturnType<__sveltets_Render<TTag, TValue>['props']> & {
+        $$events?: ReturnType<__sveltets_Render<TTag, TValue>['events']>;
+    }): ReturnType<__sveltets_Render<TTag, TValue>['exports']>;
+    z_$$bindings?: ReturnType<__sveltets_Render<any, any>['bindings']>;
+}
+declare const Textarea: $$IsomorphicComponent;
+type Textarea<TTag extends ElementType = typeof DEFAULT_TEXTAREA_TAG, TValue = string> = InstanceType<typeof Textarea<TTag, TValue>>;
+export default Textarea;

package/dist/textarea/index.d.ts

@@ -0,0 +1 @@
+export { default as Textarea, type TextareaProps } from "./Textarea.svelte";

package/dist/textarea/index.js

@@ -0,0 +1 @@
+export { default as Textarea } from "./Textarea.svelte";

package/dist/transition/InternalTransitionChild.svelte

@@ -0,0 +1,178 @@
+<script lang="ts" module>import { compact, RenderStrategy } from "../utils/render.js";
+import { onMount, setContext, untrack } from "svelte";
+import {
+  hasChildren,
+  TreeStates,
+  useNesting,
+  useParentNesting,
+  useTransitionContext
+} from "./context.svelte.js";
+import { match } from "../utils/match.js";
+import { transitionDataAttributes, useTransition } from "../hooks/use-transition.svelte.js";
+import { classNames } from "../utils/class-names.js";
+import { createOpenClosedContext, State } from "../internal/open-closed.js";
+import ElementOrComponent from "../utils/ElementOrComponent.svelte";
+import { DEFAULT_TRANSITION_CHILD_TAG } from "./TransitionChild.svelte";
+export function shouldForwardRef(props) {
+  return (
+    // If we have any of the enter/leave classes
+    Boolean(props.enter || props.enterFrom || props.enterTo || props.leave || props.leaveFrom || props.leaveTo) || // If the `as` prop is not a Fragment
+    (props.as ?? DEFAULT_TRANSITION_CHILD_TAG) !== "svelte:fragment" || // If we have a single child, then we can forward the ref directly
+    props.children !== void 0
+  );
+}
+</script>
+
+<script lang="ts" generics="TTag extends ElementType = typeof DEFAULT_TRANSITION_CHILD_TAG">let { ref = $bindable(), ..._props } = $props();
+const {
+  // Whether or not to enable transitions on the current element (by exposing
+  // transition data). When set to false, the `Transition` component still
+  // acts as a transition boundary for `TransitionChild` components.
+  transition = true,
+  // Event "handlers"
+  beforeEnter,
+  afterEnter,
+  beforeLeave,
+  afterLeave,
+  // Class names
+  enter,
+  enterFrom,
+  enterTo,
+  entered,
+  leave,
+  leaveFrom,
+  leaveTo,
+  ...theirProps
+} = $derived(_props);
+let containerElement = $state();
+let container = $state({ current: null });
+const requiresRef = $derived(shouldForwardRef(_props));
+const strategy = $derived(theirProps.unmount ?? true ? RenderStrategy.Unmount : RenderStrategy.Hidden);
+const _transitionContext = useTransitionContext();
+const { show, appear, initial } = $derived(_transitionContext);
+let _state = $state(untrack(() => show) ? TreeStates.Visible : TreeStates.Hidden);
+const parentNesting = useParentNesting();
+const { register, unregister } = $derived(parentNesting);
+onMount(() => {
+  if (requiresRef) {
+    container.current = ref ?? null;
+    containerElement = ref;
+  }
+  return register(container);
+});
+$effect(() => {
+  if (strategy !== RenderStrategy.Hidden) return;
+  if (!container.current) return;
+  if (show && _state !== TreeStates.Visible) {
+    _state = TreeStates.Visible;
+    return;
+  }
+  match(_state, {
+    [TreeStates.Hidden]: () => unregister(container),
+    [TreeStates.Visible]: () => register(container)
+  });
+});
+$effect(() => {
+  if (!requiresRef) return;
+  if (_state === TreeStates.Visible && container.current === null) {
+    throw new Error("Did you forget to passthrough the `ref` to the actual DOM node?");
+  }
+});
+const skip = $derived(initial && !appear);
+const immediate = $derived(appear && show && initial);
+let isTransitioning = $state(false);
+let nesting = useNesting({
+  done: () => {
+    if (isTransitioning) return;
+    _state = TreeStates.Hidden;
+    unregister(container);
+  },
+  get parent() {
+    return parentNesting;
+  }
+});
+const start = (show2) => {
+  isTransitioning = true;
+  const direction = show2 ? "enter" : "leave";
+  nesting.onStart(container, direction, (direction2) => {
+    if (direction2 === "enter") beforeEnter?.();
+    else if (direction2 === "leave") beforeLeave?.();
+  });
+};
+const end = (show2) => {
+  let direction = show2 ? "enter" : "leave";
+  isTransitioning = false;
+  nesting.onStop(container, direction, (direction2) => {
+    if (direction2 === "enter") afterEnter?.();
+    else if (direction2 === "leave") afterLeave?.();
+  });
+  if (direction === "leave" && !hasChildren(nesting)) {
+    _state = TreeStates.Hidden;
+    unregister(container);
+  }
+};
+$effect(() => {
+  if (requiresRef && transition) return;
+  untrack(() => start(show));
+  untrack(() => end(show));
+});
+const enabled = $derived.by(() => {
+  if (!transition) return false;
+  if (!requiresRef) return false;
+  if (skip) return false;
+  return true;
+});
+const _transition = useTransition({
+  get enabled() {
+    return enabled;
+  },
+  get element() {
+    return containerElement;
+  },
+  get show() {
+    return show;
+  },
+  events: { start, end }
+});
+const { data: transitionData } = $derived(_transition);
+const ourProps = $derived(
+  compact({
+    class: classNames(
+      // Incoming classes if any
+      // all components accept className (but all HTML elements do)
+      theirProps.class,
+      // Apply these classes immediately
+      immediate && enter,
+      immediate && enterFrom,
+      // Map data attributes to `enter`, `enterFrom` and `enterTo` classes
+      transitionData.enter && enter,
+      transitionData.enter && transitionData.closed && enterFrom,
+      transitionData.enter && !transitionData.closed && enterTo,
+      // Map data attributes to `leave`, `leaveFrom` and `leaveTo` classes
+      transitionData.leave && leave,
+      transitionData.leave && !transitionData.closed && leaveFrom,
+      transitionData.leave && transitionData.closed && leaveTo,
+      // Map data attributes to `entered` class (backwards compatibility)
+      !transitionData.transition && show && entered
+    )?.trim() || void 0,
+    // If `class` is an empty string, we can omit it
+    ...transitionDataAttributes(transitionData)
+  })
+);
+const openClosedState = $derived.by(() => {
+  let openClosedState2 = 0;
+  if (_state === TreeStates.Visible) openClosedState2 |= State.Open;
+  if (_state === TreeStates.Hidden) openClosedState2 |= State.Closed;
+  if (transitionData.enter) openClosedState2 |= State.Opening;
+  if (transitionData.leave) openClosedState2 |= State.Closing;
+  return openClosedState2;
+});
+createOpenClosedContext({
+  get value() {
+    return openClosedState;
+  }
+});
+setContext("NestingContext", nesting);
+</script>
+
+<ElementOrComponent {ourProps} {theirProps} defaultTag={DEFAULT_TRANSITION_CHILD_TAG} name="TransitionChild" bind:ref />

package/dist/transition/InternalTransitionChild.svelte.d.ts

@@ -0,0 +1,55 @@
+import type { ElementType } from "../utils/types.js";
+import type { TransitionRootProps } from "./Transition.svelte";
+import { DEFAULT_TRANSITION_CHILD_TAG } from "./TransitionChild.svelte";
+/**
+ * Check if we should forward the ref to the child element or not. This is to
+ * prevent crashes when the `as` prop is a Fragment _and_ the component just acts
+ * as a state container (aka, there is no actual transition happening).
+ *
+ * E.g.:
+ *
+ * ```tsx
+ * <Transition show={true}>
+ *   <Transition.Child enter="duration-100"><div>Child 1</div></Transition.Child>
+ *   <Transition.Child enter="duration-200"><div>Child 2</div></Transition.Child>
+ * </Transition>
+ * ```
+ *
+ * In this scenario, the child components are transitioning, but the
+ * `Transition` parent, which is a `Fragment`, is not. So we should not forward
+ * the ref to the `Fragment`.
+ */
+export declare function shouldForwardRef<TTag extends ElementType = typeof DEFAULT_TRANSITION_CHILD_TAG>(props: TransitionRootProps<TTag>): boolean;
+declare class __sveltets_Render<TTag extends ElementType = typeof DEFAULT_TRANSITION_CHILD_TAG> {
+    props(): {
+        as?: TTag | undefined;
+    } & (Exclude<keyof import("../utils/types.js").PropsOf<TTag>, ("as" | "children" | "refName" | "class") | "unmount" | "transition" | keyof import("./context.svelte.js").TransitionClasses | keyof import("./context.svelte.js").TransitionEvents | "appear"> extends infer T extends keyof import("../utils/types.js").PropsOf<TTag> ? { [P in T]: import("../utils/types.js").PropsOf<TTag>[P]; } : never) & {
+        children?: import("../utils/types.js").Children<HTMLElement> | undefined;
+        ref?: HTMLElement;
+    } & (true extends (import("../utils/types.js").PropsOf<TTag> extends infer T_1 ? T_1 extends import("../utils/types.js").PropsOf<TTag> ? T_1 extends never ? never : "class" extends infer T_2 ? T_2 extends "class" ? T_2 extends keyof T_1 ? true : never : never : never : never : never) ? {
+        class?: import("../utils/types.js").PropsOf<TTag>["class"] | ((bag: HTMLElement) => string) | undefined;
+    } : {}) & {
+        unmount?: boolean | undefined;
+    } & import("./context.svelte.js").TransitionClasses & import("./context.svelte.js").TransitionEvents & {
+        transition?: boolean;
+        appear?: boolean;
+    };
+    events(): {} & {
+        [evt: string]: CustomEvent<any>;
+    };
+    slots(): {};
+    bindings(): "ref";
+    exports(): {};
+}
+interface $$IsomorphicComponent {
+    new <TTag extends ElementType = typeof DEFAULT_TRANSITION_CHILD_TAG>(options: import('svelte').ComponentConstructorOptions<ReturnType<__sveltets_Render<TTag>['props']>>): import('svelte').SvelteComponent<ReturnType<__sveltets_Render<TTag>['props']>, ReturnType<__sveltets_Render<TTag>['events']>, ReturnType<__sveltets_Render<TTag>['slots']>> & {
+        $$bindings?: ReturnType<__sveltets_Render<TTag>['bindings']>;
+    } & ReturnType<__sveltets_Render<TTag>['exports']>;
+    <TTag extends ElementType = typeof DEFAULT_TRANSITION_CHILD_TAG>(internal: unknown, props: ReturnType<__sveltets_Render<TTag>['props']> & {
+        $$events?: ReturnType<__sveltets_Render<TTag>['events']>;
+    }): ReturnType<__sveltets_Render<TTag>['exports']>;
+    z_$$bindings?: ReturnType<__sveltets_Render<any>['bindings']>;
+}
+declare const InternalTransitionChild: $$IsomorphicComponent;
+type InternalTransitionChild<TTag extends ElementType = typeof DEFAULT_TRANSITION_CHILD_TAG> = InstanceType<typeof InternalTransitionChild<TTag>>;
+export default InternalTransitionChild;

package/dist/transition/Transition.svelte

@@ -0,0 +1,89 @@
+<script lang="ts" module>import { State, useOpenClosed } from "../internal/open-closed.js";
+import { setContext, untrack } from "svelte";
+import {
+  DEFAULT_TRANSITION_CHILD_TAG,
+  TransitionChildRenderFeatures
+} from "./TransitionChild.svelte";
+</script>
+
+<script lang="ts" generics="TTag extends ElementType = typeof DEFAULT_TRANSITION_CHILD_TAG">import InternalTransitionChild, { shouldForwardRef } from "./InternalTransitionChild.svelte";
+import ElementOrComponent from "../utils/ElementOrComponent.svelte";
+import {
+  hasChildren,
+  TreeStates,
+  useNesting
+} from "./context.svelte.js";
+let { ref = $bindable(), show, ..._props } = $props();
+const { appear = false, unmount = true, ...theirProps } = $derived(_props);
+const requiresRef = shouldForwardRef(_props);
+const usesOpenClosedState = useOpenClosed();
+if (show === void 0 && usesOpenClosedState !== null) {
+  show = (usesOpenClosedState.value & State.Open) === State.Open;
+}
+if (show === void 0) {
+  throw new Error("A <Transition /> is used but it is missing a `show={true | false}` prop.");
+}
+let _state = $state(show ? TreeStates.Visible : TreeStates.Hidden);
+const nestingBag = useNesting({
+  done: () => {
+    if (show) return;
+    _state = TreeStates.Hidden;
+  }
+});
+let initial = $state(true);
+let changes = $state([show]);
+$effect(() => {
+  if (untrack(() => initial) === false) {
+    return;
+  }
+  if (changes[changes.length - 1] !== show) {
+    changes.push(show);
+    initial = false;
+  }
+});
+$effect(() => {
+  if (show) {
+    _state = TreeStates.Visible;
+  } else if (!hasChildren(nestingBag) && untrack(() => ref)) {
+    _state = TreeStates.Hidden;
+  }
+});
+const sharedProps = $derived({ unmount });
+const beforeEnter = () => {
+  if (initial) initial = false;
+  _props.beforeEnter?.();
+};
+const beforeLeave = () => {
+  if (initial) initial = false;
+  _props.beforeLeave?.();
+};
+setContext("NestingContext", nestingBag);
+setContext("TransitionContext", {
+  get show() {
+    return show;
+  },
+  get appear() {
+    return appear;
+  },
+  get initial() {
+    return initial;
+  }
+});
+const InternalChild = InternalTransitionChild;
+</script>
+
+{#snippet children()}
+  <InternalChild bind:ref {...sharedProps} {...theirProps} {beforeEnter} {beforeLeave} />
+{/snippet}
+
+<ElementOrComponent
+  ourProps={{
+    ...sharedProps,
+    children,
+  }}
+  theirProps={{}}
+  defaultTag={"svelte:fragment"}
+  features={TransitionChildRenderFeatures}
+  visible={_state === TreeStates.Visible}
+  name="Transition"
+/>