taskninja 1.1.2 → 1.1.4

package/src/node_modules/@inquirer/core/dist/lib/theme.d.ts

@@ -0,0 +1,155 @@
+import type { Prettify } from '@inquirer/type';
+/**
+ * Union type representing the possible statuses of a prompt.
+ *
+ * -   `'loading'`: The prompt is currently loading.
+ * -   `'idle'`: The prompt is loaded and currently waiting for the user to
+ *     submit an answer.
+ * -   `'done'`: The user has submitted an answer and the prompt is finished.
+ * -   `string`: Any other string: The prompt is in a custom state.
+ */
+export type Status = 'loading' | 'idle' | 'done' | (string & {});
+type DefaultTheme = {
+    /**
+     * Prefix to prepend to the message. If a function is provided, it will be
+     * called with the current status of the prompt, and the return value will be
+     * used as the prefix.
+     *
+     * @remarks
+     * If `status === 'loading'`, this property is ignored and the spinner (styled
+     * by the `spinner` property) will be displayed instead.
+     *
+     * @defaultValue
+     * ```ts
+     * // import { styleText } from 'node:util';
+     * (status) => status === 'done' ? styleText('green', '✔') : styleText('blue', '?')
+     * ```
+     */
+    prefix: string | Prettify<Omit<Record<Status, string>, 'loading'>>;
+    /**
+     * Configuration for the spinner that is displayed when the prompt is in the
+     * `'loading'` state.
+     *
+     * We recommend the use of {@link https://github.com/sindresorhus/cli-spinners|cli-spinners} for a list of available spinners.
+     */
+    spinner: {
+        /**
+         * The time interval between frames, in milliseconds.
+         *
+         * @defaultValue
+         * ```ts
+         * 80
+         * ```
+         */
+        interval: number;
+        /**
+         * A list of frames to show for the spinner.
+         *
+         * @defaultValue
+         * ```ts
+         * ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏']
+         * ```
+         */
+        frames: string[];
+    };
+    /**
+     * Object containing functions to style different parts of the prompt.
+     */
+    style: {
+        /**
+         * Style to apply to the user's answer once it has been submitted.
+         *
+         * @param text - The user's answer.
+         * @returns The styled answer.
+         *
+         * @defaultValue
+         * ```ts
+         * // import { styleText } from 'node:util';
+         * (text) => styleText('cyan', text)
+         * ```
+         */
+        answer: (text: string) => string;
+        /**
+         * Style to apply to the message displayed to the user.
+         *
+         * @param text - The message to style.
+         * @param status - The current status of the prompt.
+         * @returns The styled message.
+         *
+         * @defaultValue
+         * ```ts
+         * // import { styleText } from 'node:util';
+         * (text, status) => styleText('bold', text)
+         * ```
+         */
+        message: (text: string, status: Status) => string;
+        /**
+         * Style to apply to error messages.
+         *
+         * @param text - The error message.
+         * @returns The styled error message.
+         *
+         * @defaultValue
+         * ```ts
+         * // import { styleText } from 'node:util';
+         * (text) => styleText('red', `> ${text}`)
+         * ```
+         */
+        error: (text: string) => string;
+        /**
+         * Style to apply to the default answer when one is provided.
+         *
+         * @param text - The default answer.
+         * @returns The styled default answer.
+         *
+         * @defaultValue
+         * ```ts
+         * // import { styleText } from 'node:util';
+         * (text) => styleText('dim', `(${text})`)
+         * ```
+         */
+        defaultAnswer: (text: string) => string;
+        /**
+         * Style to apply to help text.
+         *
+         * @param text - The help text.
+         * @returns The styled help text.
+         *
+         * @defaultValue
+         * ```ts
+         * // import { styleText } from 'node:util';
+         * (text) => styleText('dim', text)
+         * ```
+         */
+        help: (text: string) => string;
+        /**
+         * Style to apply to highlighted text.
+         *
+         * @param text - The text to highlight.
+         * @returns The highlighted text.
+         *
+         * @defaultValue
+         * ```ts
+         * // import { styleText } from 'node:util';
+         * (text) => styleText('cyan', text)
+         * ```
+         */
+        highlight: (text: string) => string;
+        /**
+         * Style to apply to keyboard keys referred to in help texts.
+         *
+         * @param text - The key to style.
+         * @returns The styled key.
+         *
+         * @defaultValue
+         * ```ts
+         * // import { styleText } from 'node:util';
+         * (text) => styleText('cyan', styleText('bold', `<${text}>`))
+         * ```
+         */
+        key: (text: string) => string;
+    };
+};
+export type Theme<Extension extends object = object> = Prettify<Extension & DefaultTheme>;
+export declare const defaultTheme: DefaultTheme;
+export {};

package/src/node_modules/@inquirer/core/dist/lib/theme.js

@@ -0,0 +1,21 @@
+import { styleText } from 'node:util';
+import figures from '@inquirer/figures';
+export const defaultTheme = {
+    prefix: {
+        idle: styleText('blue', '?'),
+        done: styleText('green', figures.tick),
+    },
+    spinner: {
+        interval: 80,
+        frames: ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'].map((frame) => styleText('yellow', frame)),
+    },
+    style: {
+        answer: (text) => styleText('cyan', text),
+        message: (text) => styleText('bold', text),
+        error: (text) => styleText('red', `> ${text}`),
+        defaultAnswer: (text) => styleText('dim', `(${text})`),
+        help: (text) => styleText('dim', text),
+        highlight: (text) => styleText('cyan', text),
+        key: (text) => styleText('cyan', styleText('bold', `<${text}>`)),
+    },
+};

package/src/node_modules/@inquirer/core/dist/lib/use-effect.d.ts

@@ -0,0 +1,2 @@
+import type { InquirerReadline } from '@inquirer/type';
+export declare function useEffect(cb: (rl: InquirerReadline) => void | (() => void), depArray: ReadonlyArray<unknown>): void;

package/src/node_modules/@inquirer/core/dist/lib/use-effect.js

@@ -0,0 +1,11 @@
+import { withPointer, effectScheduler } from "./hook-engine.js";
+export function useEffect(cb, depArray) {
+    withPointer((pointer) => {
+        const oldDeps = pointer.get();
+        const hasChanged = !Array.isArray(oldDeps) || depArray.some((dep, i) => !Object.is(dep, oldDeps[i]));
+        if (hasChanged) {
+            effectScheduler.queue(cb);
+        }
+        pointer.set(depArray);
+    });
+}

package/src/node_modules/@inquirer/core/dist/lib/use-keypress.d.ts

@@ -0,0 +1,3 @@
+import { type InquirerReadline } from '@inquirer/type';
+import { type KeypressEvent } from './key';
+export declare function useKeypress(userHandler: (event: KeypressEvent, rl: InquirerReadline) => void | Promise<void>): void;

package/src/node_modules/@inquirer/core/dist/lib/use-keypress.js

@@ -0,0 +1,20 @@
+import { useRef } from "./use-ref.js";
+import { useEffect } from "./use-effect.js";
+import { withUpdates } from "./hook-engine.js";
+export function useKeypress(userHandler) {
+    const signal = useRef(userHandler);
+    signal.current = userHandler;
+    useEffect((rl) => {
+        let ignore = false;
+        const handler = withUpdates((_input, event) => {
+            if (ignore)
+                return;
+            void signal.current(event, rl);
+        });
+        rl.input.on('keypress', handler);
+        return () => {
+            ignore = true;
+            rl.input.removeListener('keypress', handler);
+        };
+    }, []);
+}

package/src/node_modules/@inquirer/core/dist/lib/use-memo.d.ts

@@ -0,0 +1 @@
+export declare function useMemo<Value>(fn: () => Value, dependencies: ReadonlyArray<unknown>): Value;

package/src/node_modules/@inquirer/core/dist/lib/use-memo.js

@@ -0,0 +1,14 @@
+import { withPointer } from "./hook-engine.js";
+export function useMemo(fn, dependencies) {
+    return withPointer((pointer) => {
+        const prev = pointer.get();
+        if (!prev ||
+            prev.dependencies.length !== dependencies.length ||
+            prev.dependencies.some((dep, i) => dep !== dependencies[i])) {
+            const value = fn();
+            pointer.set({ value, dependencies });
+            return value;
+        }
+        return prev.value;
+    });
+}

package/src/node_modules/@inquirer/core/dist/lib/use-prefix.d.ts

@@ -0,0 +1,5 @@
+import type { Theme, Status } from './theme';
+export declare function usePrefix({ status, theme, }: {
+    status?: Status;
+    theme?: Theme;
+}): string;

package/src/node_modules/@inquirer/core/dist/lib/use-prefix.js

@@ -0,0 +1,35 @@
+import { useState } from "./use-state.js";
+import { useEffect } from "./use-effect.js";
+import { makeTheme } from "./make-theme.js";
+export function usePrefix({ status = 'idle', theme, }) {
+    const [showLoader, setShowLoader] = useState(false);
+    const [tick, setTick] = useState(0);
+    const { prefix, spinner } = makeTheme(theme);
+    useEffect(() => {
+        if (status === 'loading') {
+            let tickInterval;
+            let inc = -1;
+            // Delay displaying spinner by 300ms, to avoid flickering
+            const delayTimeout = setTimeout(() => {
+                setShowLoader(true);
+                tickInterval = setInterval(() => {
+                    inc = inc + 1;
+                    setTick(inc % spinner.frames.length);
+                }, spinner.interval);
+            }, 300);
+            return () => {
+                clearTimeout(delayTimeout);
+                clearInterval(tickInterval);
+            };
+        }
+        else {
+            setShowLoader(false);
+        }
+    }, [status]);
+    if (showLoader) {
+        return spinner.frames[tick];
+    }
+    // There's a delay before we show the loader. So we want to ignore `loading` here, and pass idle instead.
+    const iconName = status === 'loading' ? 'idle' : status;
+    return typeof prefix === 'string' ? prefix : (prefix[iconName] ?? prefix['idle']);
+}

package/src/node_modules/@inquirer/core/dist/lib/use-ref.d.ts

@@ -0,0 +1,6 @@
+export declare function useRef<Value>(val: Value): {
+    current: Value;
+};
+export declare function useRef<Value>(val?: Value): {
+    current: Value | undefined;
+};

package/src/node_modules/@inquirer/core/dist/lib/use-ref.js

@@ -0,0 +1,4 @@
+import { useState } from "./use-state.js";
+export function useRef(val) {
+    return useState({ current: val })[0];
+}

package/src/node_modules/@inquirer/core/dist/lib/use-state.d.ts

@@ -0,0 +1,4 @@
+type NotFunction<T> = T extends (...args: never) => unknown ? never : T;
+export declare function useState<Value>(defaultValue: NotFunction<Value> | (() => Value)): [Value, (newValue: Value) => void];
+export declare function useState<Value>(defaultValue?: NotFunction<Value> | (() => Value)): [Value | undefined, (newValue?: Value) => void];
+export {};

package/src/node_modules/@inquirer/core/dist/lib/use-state.js

@@ -0,0 +1,20 @@
+import { AsyncResource } from 'node:async_hooks';
+import { withPointer, handleChange } from "./hook-engine.js";
+export function useState(defaultValue) {
+    return withPointer((pointer) => {
+        const setState = AsyncResource.bind(function setState(newValue) {
+            // Noop if the value is still the same.
+            if (pointer.get() !== newValue) {
+                pointer.set(newValue);
+                // Trigger re-render
+                handleChange();
+            }
+        });
+        if (pointer.initialized) {
+            return [pointer.get(), setState];
+        }
+        const value = typeof defaultValue === 'function' ? defaultValue() : defaultValue;
+        pointer.set(value);
+        return [value, setState];
+    });
+}

package/src/node_modules/@inquirer/core/dist/lib/utils.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Force line returns at specific width. This function is ANSI code friendly and it'll
+ * ignore invisible codes during width calculation.
+ * @param {string} content
+ * @param {number} width
+ * @return {string}
+ */
+export declare function breakLines(content: string, width: number): string;
+/**
+ * Returns the width of the active readline, or 80 as default value.
+ * @returns {number}
+ */
+export declare function readlineWidth(): number;

package/src/node_modules/@inquirer/core/dist/lib/utils.js

@@ -0,0 +1,25 @@
+import cliWidth from 'cli-width';
+import wrapAnsi from 'wrap-ansi';
+import { readline } from "./hook-engine.js";
+/**
+ * Force line returns at specific width. This function is ANSI code friendly and it'll
+ * ignore invisible codes during width calculation.
+ * @param {string} content
+ * @param {number} width
+ * @return {string}
+ */
+export function breakLines(content, width) {
+    return content
+        .split('\n')
+        .flatMap((line) => wrapAnsi(line, width, { trim: false, hard: true })
+        .split('\n')
+        .map((str) => str.trimEnd()))
+        .join('\n');
+}
+/**
+ * Returns the width of the active readline, or 80 as default value.
+ * @returns {number}
+ */
+export function readlineWidth() {
+    return cliWidth({ defaultWidth: 80, output: readline().output });
+}

package/src/node_modules/@inquirer/core/package.json

@@ -0,0 +1,98 @@
+{
+  "name": "@inquirer/core",
+  "version": "11.1.1",
+  "description": "Core Inquirer prompt API",
+  "keywords": [
+    "answer",
+    "answers",
+    "ask",
+    "base",
+    "cli",
+    "command",
+    "command-line",
+    "confirm",
+    "enquirer",
+    "generate",
+    "generator",
+    "hyper",
+    "input",
+    "inquire",
+    "inquirer",
+    "interface",
+    "iterm",
+    "javascript",
+    "menu",
+    "node",
+    "nodejs",
+    "prompt",
+    "promptly",
+    "prompts",
+    "question",
+    "readline",
+    "scaffold",
+    "scaffolder",
+    "scaffolding",
+    "stdin",
+    "stdout",
+    "terminal",
+    "tty",
+    "ui",
+    "yeoman",
+    "yo",
+    "zsh"
+  ],
+  "homepage": "https://github.com/SBoudrias/Inquirer.js/blob/main/packages/core/README.md",
+  "license": "MIT",
+  "author": "Simon Boudrias <admin@simonboudrias.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SBoudrias/Inquirer.js.git"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "tsc": "tsc"
+  },
+  "dependencies": {
+    "@inquirer/ansi": "^2.0.3",
+    "@inquirer/figures": "^2.0.3",
+    "@inquirer/type": "^4.0.3",
+    "cli-width": "^4.1.0",
+    "mute-stream": "^3.0.0",
+    "signal-exit": "^4.1.0",
+    "wrap-ansi": "^9.0.2"
+  },
+  "devDependencies": {
+    "@inquirer/testing": "^3.0.4",
+    "@types/mute-stream": "^0.0.4",
+    "@types/node": "^25.0.2",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "@types/node": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "@types/node": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=23.5.0 || ^22.13.0 || ^21.7.0 || ^20.12.0"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "gitHead": "99d00a9adc53be8b7edf5926b2ec4ba0b792f68f"
+}

package/src/node_modules/@inquirer/editor/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2025 Simon Boudrias
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

package/src/node_modules/@inquirer/editor/README.md

@@ -0,0 +1,101 @@
+# `@inquirer/editor`
+
+Prompt that'll open the user preferred editor with default content and allow for a convenient multi-line input controlled through the command line.
+
+The editor launched is the one [defined by the user's `EDITOR` environment variable](https://dev.to/jonasbn/til-integrate-visual-studio-code-with-shell--cli-2l1l).
+
+# Installation
+
+<table>
+<tr>
+  <th>npm</th>
+  <th>yarn</th>
+</tr>
+<tr>
+<td>
+
+```sh
+npm install @inquirer/prompts
+```
+
+</td>
+<td>
+
+```sh
+yarn add @inquirer/prompts
+```
+
+</td>
+</tr>
+<tr>
+<td colSpan="2" align="center">Or</td>
+</tr>
+<tr>
+<td>
+
+```sh
+npm install @inquirer/editor
+```
+
+</td>
+<td>
+
+```sh
+yarn add @inquirer/editor
+```
+
+</td>
+</tr>
+</table>
+
+# Usage
+
+```js
+import { editor } from '@inquirer/prompts';
+// Or
+// import editor from '@inquirer/editor';
+
+const answer = await editor({
+  message: 'Enter a description',
+});
+```
+
+## Options
+
+| Property         | Type                                                                           | Required               | Description                                                                                                                                                                                                                            |
+| ---------------- | ------------------------------------------------------------------------------ | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| message          | `string`                                                                       | yes                    | The question to ask                                                                                                                                                                                                                    |
+| default          | `string`                                                                       | no                     | Default value which will automatically be present in the editor                                                                                                                                                                        |
+| validate         | `string => boolean \| string \| Promise<boolean \| string>`                    | no                     | On submit, validate the content. When returning a string, it'll be used as the error message displayed to the user. Note: returning a rejected promise, we'll assume a code error happened and crash.                                  |
+| postfix          | `string`                                                                       | no (default to `.txt`) | The postfix of the file being edited. Adding this will add color highlighting to the file content in most editors.                                                                                                                     |
+| file             | [`IFileOptions`](https://github.com/mrkmg/node-external-editor#config-options) | no                     | Exposes the [`external-editor` package options](https://github.com/mrkmg/node-external-editor#config-options) to configure the temporary file.                                                                                         |
+| waitForUserInput | `boolean`                                                                      | no (default to `true`) | Open the editor automatically without waiting for the user to press enter. Note that this mean the user will not see the question! So make sure you have a default value that provide guidance if it's unclear what input is expected. |
+| theme            | [See Theming](#Theming)                                                        | no                     | Customize look of the prompt.                                                                                                                                                                                                          |
+
+## Theming
+
+You can theme a prompt by passing a `theme` object option. The theme object only need to includes the keys you wish to modify, we'll fallback on the defaults for the rest.
+
+```ts
+type Theme = {
+  prefix: string | { idle: string; done: string };
+  spinner: {
+    interval: number;
+    frames: string[];
+  };
+  style: {
+    message: (text: string, status: 'idle' | 'done' | 'loading') => string;
+    error: (text: string) => string;
+    help: (text: string) => string;
+    key: (text: string) => string;
+  };
+  validationFailureMode: 'keep' | 'clear';
+};
+```
+
+`validationFailureMode` defines the behavior of the prompt when the value submitted is invalid. By default, we'll keep the value allowing the user to edit it. When the theme option is set to `clear`, we'll remove and reset to the default value or empty string.
+
+# License
+
+Copyright (c) 2023 Simon Boudrias (twitter: [@vaxilart](https://twitter.com/Vaxilart))<br/>
+Licensed under the MIT license.

package/src/node_modules/@inquirer/editor/dist/index.d.ts

@@ -0,0 +1,17 @@
+import { type IFileOptions } from '@inquirer/external-editor';
+import { type Theme } from '@inquirer/core';
+import type { PartialDeep } from '@inquirer/type';
+type EditorTheme = {
+    validationFailureMode: 'keep' | 'clear';
+};
+type EditorConfig = {
+    message: string;
+    default?: string;
+    postfix?: string;
+    waitForUserInput?: boolean;
+    validate?: (value: string) => boolean | string | Promise<string | boolean>;
+    file?: IFileOptions;
+    theme?: PartialDeep<Theme<EditorTheme>>;
+};
+declare const _default: import("@inquirer/type").Prompt<string, EditorConfig>;
+export default _default;