chore(async-stack): manually define public type for StackItem

Author: vnphanquang

.changeset/stupid-plants-explain.md

@@ -0,0 +1,5 @@
+---
+'@svelte-put/async-stack': patch
+---
+
+provide explicit d.ts for `StackItem` for greater control

packages/async-stack/src/stack-item.svelte.d.ts

@@ -0,0 +1,32 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import type { Component } from 'svelte';
+
+import type { StackItemInstanceConfig, StackItemState } from './types.package';
+import type { ComponentResolved } from './types.public';
+
+export class StackItem<
+	UserComponent extends Component<any>,
+	Resolved = ComponentResolved<UserComponent>,
+> {
+	/** @default 'idle' */
+	state: StackItemState;
+	config: Required<StackItemInstanceConfig<string, UserComponent>>;
+	/**
+	 * a promise that resolves when the item is resolved,
+	 * by timing out or via the .resolve method
+	 */
+	resolution: Promise<Resolved | undefined>;
+
+	constructor(config: StackItemInstanceConfig<string, UserComponent>);
+
+	/** resume the stack item, if it has been paused */
+	resume: () => void;
+	/** pause the stack item, if it has a timeout */
+	pause: () => void;
+	/**
+	 * resolve the stack item, optionally with a resolved value
+	 * resolve means popping the item from the stack, and
+	 * unmounting its component
+	 */
+	resolve: (resolved?: Resolved) => Promise<Resolved | undefined>;
+}

packages/async-stack/src/stack-item.svelte.js

@@ -18,10 +18,7 @@ export class StackItem {
 		resolve: () => {},
 	};
 
-	/**
-	 * a promise that resolves when the item is popped or resolved via the .resolve method
-	 * @type {Promise<Resolved | undefined>}
-	 */
+	/** @type {Promise<Resolved | undefined>} */
 	resolution;
 
 	/**

packages/async-stack/src/types.public.d.ts

@@ -5,7 +5,7 @@ import type { StackItem } from './stack-item.svelte.js';
 
 export interface StackItemProps<Resolved = undefined> {
 	/** the stack item instance injected by the stack */
-	item: Omit<StackItem<Component<StackItemProps<Resolved>>, Resolved>, '#internals'>;
+	item: StackItem<Component<StackItemProps<Resolved>>, Resolved>;
 }
 
 export type ComponentResolved<UserComponent extends Component<any>> =