docs: improves tsdocs

src/public/exec/stream.ts

@@ -34,6 +34,11 @@ export type TStreamOptions = IMultiExecOptions & {
 
 export default expose(stream);
 
+/**
+ * Streams *kpo* commands for children projects.
+ * It is an *exposed* function: call `stream.fn()`, which takes the same arguments, in order to execute on call.
+ * @returns An asynchronous function taking additional arguments to be used for all commands -hence, calling `stream` won't have any effect until the returned function is called.
+ */
 function stream(
   argv: string[],
   options: TStreamOptions = {}
@@ -89,6 +94,7 @@ function stream(
   };
 }
 
+/** @hidden */
 function getChild(name: string, children: IChild[]): IChild {
   const matches = children.filter((child) => child.matcher(name));
   if (matches.length > 1) throw Error(`Several scopes matched name "${name}"`);

src/public/kpo/list.ts

@@ -39,6 +39,7 @@ function list(options: IListOptions = {}): () => Promise<void> {
   };
 }
 
+/** @hidden */
 export function fromTasks(tasks: ITasks): string {
   let str = '';
 
@@ -61,6 +62,7 @@ export function fromTasks(tasks: ITasks): string {
   return str;
 }
 
+/** @hidden */
 export async function fromScopes(): Promise<string> {
   const cwd = await core.cwd();
   const root = await core.root();

src/public/kpo/options.ts

@@ -2,6 +2,9 @@ import { options as _options } from '~/core';
 import { IScopeOptions } from '~/types';
 import { wrap } from '~/utils/errors';
 
+/**
+ * Programmatically sets *kpo* options.
+ */
 export default function options(opts: IScopeOptions): void {
   return wrap.throws(() => _options.setScope(opts));
 }