@maizzle/framework 6.0.0-rc.8 → 6.0.0

package/dist/utils/watchPaths.d.ts

@@ -0,0 +1,11 @@
+//#region src/utils/watchPaths.d.ts
+/**
+ * Build a predicate that tells whether an absolute file path emitted by
+ * chokidar matches any of the given globs. Patterns are interpreted as
+ * project-relative; a leading `./` is stripped so user-supplied globs like
+ * `./locales/**` behave identically to `locales/**`.
+ */
+declare function createWatchedFileMatcher(patterns: string[], cwd: string): (file: string) => boolean;
+//#endregion
+export { createWatchedFileMatcher };
+//# sourceMappingURL=watchPaths.d.ts.map

package/dist/utils/watchPaths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watchPaths.d.ts","names":[],"sources":["../../src/utils/watchPaths.ts"],"mappings":";;AAQA;;;;;iBAAgB,wBAAA,CAAyB,QAAA,YAAoB,GAAA,YAEnD,IAAA"}

package/dist/utils/watchPaths.js

@@ -0,0 +1,19 @@
+import { matchesGlob, relative } from "pathe";
+//#region src/utils/watchPaths.ts
+/**
+* Build a predicate that tells whether an absolute file path emitted by
+* chokidar matches any of the given globs. Patterns are interpreted as
+* project-relative; a leading `./` is stripped so user-supplied globs like
+* `./locales/**` behave identically to `locales/**`.
+*/
+function createWatchedFileMatcher(patterns, cwd) {
+	const normalized = patterns.map((p) => p.replace(/^\.\//, ""));
+	return (file) => {
+		const rel = relative(cwd, file);
+		return normalized.some((p) => matchesGlob(rel, p));
+	};
+}
+//#endregion
+export { createWatchedFileMatcher };
+
+//# sourceMappingURL=watchPaths.js.map

package/dist/utils/watchPaths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watchPaths.js","names":[],"sources":["../../src/utils/watchPaths.ts"],"sourcesContent":["import { matchesGlob, relative } from 'pathe'\n\n/**\n * Build a predicate that tells whether an absolute file path emitted by\n * chokidar matches any of the given globs. Patterns are interpreted as\n * project-relative; a leading `./` is stripped so user-supplied globs like\n * `./locales/**` behave identically to `locales/**`.\n */\nexport function createWatchedFileMatcher(patterns: string[], cwd: string) {\n  const normalized = patterns.map(p => p.replace(/^\\.\\//, ''))\n  return (file: string) => {\n    const rel = relative(cwd, file)\n    return normalized.some(p => matchesGlob(rel, p))\n  }\n}\n"],"mappings":";;;;;;;;AAQA,SAAgB,yBAAyB,UAAoB,KAAa;CACxE,MAAM,aAAa,SAAS,KAAI,MAAK,EAAE,QAAQ,SAAS,EAAE,CAAC;CAC3D,QAAQ,SAAiB;EACvB,MAAM,MAAM,SAAS,KAAK,IAAI;EAC9B,OAAO,WAAW,MAAK,MAAK,YAAY,KAAK,CAAC,CAAC;CACjD;AACF"}

package/node_modules/@clack/core/CHANGELOG.md

@@ -1,5 +1,49 @@
 # @clack/core
 
+## 1.4.1
+
+### Patch Changes
+
+- [#548](https://github.com/bombshell-dev/clack/pull/548) [`2356e97`](https://github.com/bombshell-dev/clack/commit/2356e97c1f46007ead55133c3a26910404ef1cfb) Thanks [@43081j](https://github.com/43081j)! - Remove sourcemaps and enable pretty-ish build output.
+
+## 1.4.0
+
+### Minor Changes
+
+- [#543](https://github.com/bombshell-dev/clack/pull/543) [`83428ac`](https://github.com/bombshell-dev/clack/commit/83428ac6d8bc5eda87615cc7b1f14e0c8b16e1b6) Thanks [@florian-lefebvre](https://github.com/florian-lefebvre)! - Adds support for Standard Schema validation
+
+  Prompts accept an optional `validate()` function to validate user input. While a function provides more flexibility and customization over your validation, it can be a bit verbose. To help solve this, there are libraries that provide schema-based validation to make shorthand and type-strict validation substantially easier.
+
+  Libraries following the [Standard Schema specification](https://github.com/standard-schema/standard-schema) are now natively supported. For example, using [Arktype](https://arktype.io/):
+
+  ```diff
+  import { text } from '@clack/prompts';
+  import { type } from 'arktype';
+
+  const name = await text({
+  	message: 'Enter your email',
+  +	validate: type('string.email').describe('Invalid email'),
+  });
+  ```
+
+### Patch Changes
+
+- [#534](https://github.com/bombshell-dev/clack/pull/534) [`3dcb31a`](https://github.com/bombshell-dev/clack/commit/3dcb31a7d63827d95a5a52ac630cbd48e3a68364) Thanks [@MattStypa](https://github.com/MattStypa)! - Fixed spaces and uppercase characters in multiline prompt
+
+## 1.3.1
+
+### Patch Changes
+
+- 54be8d7: Fix line wrapping and overflow computation in group multi-select and other list-like prompts.
+
+## 1.3.0
+
+### Minor Changes
+
+- 78fd3ae: Remove unused `debug` option key.
+- ea5702e: fix: add engines field expressing node >=20.12 requirement
+- 814ab9a: Add new multiline prompt for multi-line text input.
+
 ## 1.2.0
 
 ### Minor Changes

package/node_modules/@clack/core/dist/index.d.mts

@@ -93,14 +93,119 @@ interface ClackEvents<TValue> {
     beforePrompt: () => void;
 }
 
+/** The Standard Schema interface. */
+interface StandardSchemaV1<Input = unknown, Output = Input> {
+    /** The Standard Schema properties. */
+    readonly '~standard': StandardSchemaV1.Props<Input, Output>;
+}
+declare namespace StandardSchemaV1 {
+    /** The Standard Schema properties interface. */
+    interface Props<Input = unknown, Output = Input> {
+        /** The version number of the standard. */
+        readonly version: 1;
+        /** The vendor name of the schema library. */
+        readonly vendor: string;
+        /** Validates unknown input values. */
+        readonly validate: (value: unknown, options?: StandardSchemaV1.Options | undefined) => Result<Output> | Promise<Result<Output>>;
+        /** Inferred types associated with the schema. */
+        readonly types?: Types<Input, Output> | undefined;
+    }
+    /** The result interface of the validate function. */
+    type Result<Output> = SuccessResult<Output> | FailureResult;
+    /** The result interface if validation succeeds. */
+    interface SuccessResult<Output> {
+        /** The typed output value. */
+        readonly value: Output;
+        /** A falsy value for `issues` indicates success. */
+        readonly issues?: undefined;
+    }
+    interface Options {
+        /** Explicit support for additional vendor-specific parameters, if needed. */
+        readonly libraryOptions?: Record<string, unknown> | undefined;
+    }
+    /** The result interface if validation fails. */
+    interface FailureResult {
+        /** The issues of failed validation. */
+        readonly issues: ReadonlyArray<Issue>;
+    }
+    /** The issue interface of the failure output. */
+    interface Issue {
+        /** The error message of the issue. */
+        readonly message: string;
+        /** The path of the issue, if any. */
+        readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined;
+    }
+    /** The path segment interface of the issue. */
+    interface PathSegment {
+        /** The key representing a path segment. */
+        readonly key: PropertyKey;
+    }
+    /** The Standard Schema types interface. */
+    interface Types<Input = unknown, Output = Input> {
+        /** The input type of the schema. */
+        readonly input: Input;
+        /** The output type of the schema. */
+        readonly output: Output;
+    }
+    /** Infers the input type of a Standard Schema. */
+    type InferInput<Schema extends StandardSchemaV1> = NonNullable<Schema['~standard']['types']>['input'];
+    /** Infers the output type of a Standard Schema. */
+    type InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema['~standard']['types']>['output'];
+}
+
+/**
+ * A function or [Standard Schema](https://github.com/standard-schema/standard-schema)
+ * that validates user input. If a custom function is given, you should return a
+ * `string` or `Error` to show as a validation error, or `undefined` to accept the result.
+ *
+ * @example Using arktype
+ * ```ts
+ * import { text } from '@clack/prompts';
+ * import { type } from 'arktype';
+ *
+ * const name = await text({
+ *   message: 'Enter your name (letters only)',
+ *   validate: type('string.alpha').describe('Name can only contain letters'),
+ * });
+ * ```
+ *
+ * @example Custom validator
+ * ```ts
+ * import { text } from '@clack/prompts';
+ *
+ * const age = await text({
+ *   message: 'Enter your age:',
+ *   validate(value) {
+ *     if (!value) return 'Please enter a value';
+ *     const num = parseInt(value);
+ *     if (isNaN(num)) return 'Please enter a valid number';
+ *     if (num < 0 || num > 120) return 'Age must be between 0 and 120';
+ *     return undefined;
+ *   },
+ * });
+ * ```
+ */
+type Validate<TValue> = ((value: TValue | undefined) => string | Error | undefined) | StandardSchemaV1<TValue | undefined, unknown>;
+/**
+ * Runs the `validate()` option and normalizes the result
+ * @param validate - The validate option
+ * @param value - The user input
+ * @returns the validation result
+ */
+declare function runValidation<TValue>(validate: Validate<TValue>, value: TValue | undefined): string | Error | undefined;
+
 interface PromptOptions<TValue, Self extends Prompt<TValue>> {
     render(this: Omit<Self, 'prompt'>): string | undefined;
     initialValue?: any;
     initialUserInput?: string;
-    validate?: ((value: TValue | undefined) => string | Error | undefined) | undefined;
+    /**
+     * A function or a [Standard Schema](https://github.com/standard-schema/standard-schema)
+     * that validates user input. If a custom function is given, you should return a `string` or `Error`
+     * to show as a validation error, or `undefined` to accept the result.
+     */
+    validate?: Validate<TValue> | undefined;
     input?: Readable;
     output?: Writable;
-    debug?: boolean;
     signal?: AbortSignal;
 }
 declare class Prompt<TValue> {
@@ -148,6 +253,7 @@ declare class Prompt<TValue> {
     emit<T extends keyof ClackEvents<TValue>>(event: T, ...data: Parameters<ClackEvents<TValue>[T]>): void;
     prompt(): Promise<symbol | TValue | undefined>;
     protected _isActionKey(char: string | undefined, _key: Key): boolean;
+    protected _shouldSubmit(_char: string | undefined, _key: Key): boolean;
     protected _setValue(value: TValue | undefined): void;
     protected _setUserInput(value: string | undefined, write?: boolean): void;
     protected _clearUserInput(): void;
@@ -258,6 +364,20 @@ declare class GroupMultiSelectPrompt<T extends {
     constructor(opts: GroupMultiSelectOptions<T>);
 }
 
+interface MultiLineOptions extends PromptOptions<string, MultiLinePrompt> {
+    placeholder?: string;
+    defaultValue?: string;
+    showSubmit?: boolean;
+}
+declare class MultiLinePrompt extends Prompt<string> {
+    #private;
+    focused: 'editor' | 'submit';
+    get userInputWithCursor(): string;
+    get cursor(): number;
+    protected _shouldSubmit(_char: string | undefined, _key: Key): boolean;
+    constructor(opts: MultiLineOptions);
+}
+
 interface OptionLike {
     value: any;
     disabled?: boolean;
@@ -343,7 +463,7 @@ interface BlockOptions {
 declare function block({ input, output, overwrite, hideCursor, }?: BlockOptions): () => void;
 declare const getColumns: (output: Writable) => number;
 declare const getRows: (output: Writable) => number;
-declare function wrapTextWithPrefix(output: Writable | undefined, text: string, prefix: string, startPrefix?: string): string;
+declare function wrapTextWithPrefix(output: Writable | undefined, text: string, prefix: string, startPrefix?: string, endPrefix?: string, lineFormatter?: (line: string, index: number) => string): string;
 
-export { AutocompletePrompt, ConfirmPrompt, DatePrompt, GroupMultiSelectPrompt, MultiSelectPrompt, PasswordPrompt, Prompt, SelectKeyPrompt, SelectPrompt, TextPrompt, block, getColumns, getRows, isCancel, settings, updateSettings, wrapTextWithPrefix };
-export type { AutocompleteOptions, ClackSettings, ConfirmOptions, DateFormat, DateOptions, DateParts, GroupMultiSelectOptions, MultiSelectOptions, PasswordOptions, PromptOptions, SelectKeyOptions, SelectOptions, ClackState as State, TextOptions };
+export { AutocompletePrompt, ConfirmPrompt, DatePrompt, GroupMultiSelectPrompt, MultiLinePrompt, MultiSelectPrompt, PasswordPrompt, Prompt, SelectKeyPrompt, SelectPrompt, TextPrompt, block, getColumns, getRows, isCancel, runValidation, settings, updateSettings, wrapTextWithPrefix };
+export type { AutocompleteOptions, ClackSettings, ConfirmOptions, DateFormat, DateOptions, DateParts, GroupMultiSelectOptions, MultiLineOptions, MultiSelectOptions, PasswordOptions, PromptOptions, SelectKeyOptions, SelectOptions, ClackState as State, TextOptions, Validate };