sv 1.0.0-next.7 → 1.0.0

package/dist/{engine-BKdrqoIo.d.mts → engine-D2x5kvrf.d.mts}

@@ -1,5 +1,4 @@
 import { AgentName } from "@sveltejs/sv-utils";
-
 //#region src/addons/index.d.ts
 type OfficialAddons = {
   prettier: Addon<any>;
@@ -7,6 +6,7 @@ type OfficialAddons = {
   vitest: Addon<any>;
   playwright: Addon<any>;
   tailwindcss: Addon<any>;
+  enhancedImg: Addon<any>;
   sveltekitAdapter: Addon<any>;
   drizzle: Addon<any>;
   betterAuth: Addon<any>;
@@ -58,54 +58,57 @@ type BaseQuestion<Args extends OptionDefinition> = {
   question: string;
   group?: string;
   /**
-  * When this condition explicitly returns `false`, the question's value will
-  * always be `undefined` and will not fallback to the specified `default` value.
-  */
+   * When this condition explicitly returns `false`, the question's value will
+   * always be `undefined` and will not fallback to the specified `default` value.
+   */
   condition?: (options: OptionValues<Args>) => boolean;
 };
 type Question<Args extends OptionDefinition = OptionDefinition> = BaseQuestion<Args> & (BooleanQuestion | StringQuestion | NumberQuestion | SelectQuestion<any> | MultiSelectQuestion<any>);
 type OptionDefinition = Record<string, Question<any>>;
-type OptionValues<Args extends OptionDefinition> = { [K in keyof Args]: Args[K] extends StringQuestion ? string : Args[K] extends BooleanQuestion ? boolean : Args[K] extends NumberQuestion ? number : Args[K] extends SelectQuestion<infer Value> ? Value : Args[K] extends MultiSelectQuestion<infer Value> ? Value[] : Args[K] extends Question<any> ? unknown : "ERROR: The value for this type is invalid. Ensure that the `default` value exists in `options`." };
+type OptionValues<Args extends OptionDefinition> = { [K in keyof Args]: Args[K] extends StringQuestion ? string : Args[K] extends BooleanQuestion ? boolean : Args[K] extends NumberQuestion ? number : Args[K] extends SelectQuestion<infer Value> ? Value : Args[K] extends MultiSelectQuestion<infer Value> ? Value[] : Args[K] extends Question<any> ? unknown : "ERROR: The value for this type is invalid. Ensure that the `default` value exists in `options`."; };
 //#endregion
 //#region src/core/workspace.d.ts
 type WorkspaceOptions<Args extends OptionDefinition> = OptionValues<Args>;
 type Workspace = {
   cwd: string;
   /**
-  * Returns the dependency version declared in the package.json.
-  * This may differ from the installed version.
-  * Includes both dependencies and devDependencies.
-  * Also checks parent package.json files if called in a monorepo.
-  * @param pkg the package to check for
-  * @returns the dependency version with any leading characters such as ^ or ~ removed
-  */
-  dependencyVersion: (pkg: string) => string | undefined; /** to know if the workspace is using typescript or javascript */
+   * Returns the dependency version declared in the package.json.
+   * This may differ from the installed version.
+   * Includes both dependencies and devDependencies.
+   * Also checks parent package.json files if called in a monorepo.
+   * @param pkg the package to check for
+   * @returns the dependency version with any leading characters such as ^ or ~ removed
+   */
+  dependencyVersion: (pkg: string) => string | undefined;
+  /** to know if the workspace is using typescript or javascript */
   language: "ts" | "js";
   file: {
     viteConfig: "vite.config.js" | "vite.config.ts";
-    typeConfig: "jsconfig.json" | "tsconfig.json" | undefined; /** `${directory.routes}/layout.css` or `src/app.css` */
+    typeConfig: "jsconfig.json" | "tsconfig.json" | undefined;
+    /** `${directory.routes}/layout.css` or `src/app.css` */
     stylesheet: `${string}/layout.css` | "src/app.css";
     package: "package.json";
-    gitignore: ".gitignore"; /** Get the relative path between two files */
-    getRelative: ({
-      from,
-      to
-    }: {
+    gitignore: ".gitignore";
+    /** Get the relative path between two files */
+    getRelative: ({ from, to }: {
       from?: string;
       to: string;
     }) => string;
     /**
-    * Find a file by walking up the directory tree from cwd.
-    * Returns the relative path from cwd, or the filename itself if not found.
-    */
+     * Find a file by walking up the directory tree from cwd.
+     * Returns the relative path from cwd, or the filename itself if not found.
+     */
     findUp: (filename: string) => string;
   };
   isKit: boolean;
   directory: {
-    src: string; /** In SvelteKit taking `kit.files.lib` automatically. Falls back to `src/lib` in non-Kit projects */
-    lib: string; /** In SvelteKit taking `kit.files.routes` automatically. Falls back to `src/routes` in non-Kit projects */
+    src: string;
+    /** In SvelteKit taking `kit.files.lib` automatically. Falls back to `src/lib` in non-Kit projects */
+    lib: string;
+    /** In SvelteKit taking `kit.files.routes` automatically. Falls back to `src/routes` in non-Kit projects */
     kitRoutes: string;
-  }; /** The package manager used to install dependencies */
+  };
+  /** The package manager used to install dependencies */
   packageManager: AgentName;
 };
 //#endregion
@@ -114,97 +117,114 @@ type ConditionDefinition = (Workspace: Workspace) => boolean;
 type FileEdit = (content: string) => string | false;
 type FileEditMultiple = (content: string, path: string) => string | false;
 type SvApi = {
-  /** Add a package to the dependencies. */dependency: (pkg: string, version: string) => void; /** Add a package to the dev dependencies. */
-  devDependency: (pkg: string, version: string) => void; /** Execute a command in the workspace. */
+  /** Add a package to the dependencies. */
+  dependency: (pkg: string, version: string) => void;
+  /** Add a package to the dev dependencies. */
+  devDependency: (pkg: string, version: string) => void;
+  /** Execute a command in the workspace. */
   execute: (args: string[], stdio: "inherit" | "pipe") => Promise<void>;
   /**
-  * Edit a file in the workspace. (will create it if it doesn't exist)
-  *
-  * Return `false` from the callback to abort - the original content is returned unchanged.
-  */
-  file: (path: string, edit: FileEdit) => void; /** Remove a file from the workspace. Respects the migration file filter. */
+   * Edit a file in the workspace. (will create it if it doesn't exist)
+   *
+   * Return `false` from the callback to abort - the original content is returned unchanged.
+   */
+  file: (path: string, edit: FileEdit) => void;
+  /** Remove a file from the workspace. Respects the migration file filter. */
   removeFile: (path: string) => void;
   /**
-  * Edits matching files in the workspace.
-  * The `include` and `exclude` patterns are glob patterns relative to the workspace root.
-  * For each matching file, the `edit` callback is called with the file content,
-  * and should return the new content (or `false` to abort editing that file).
-  *
-  * Note: always adds excludes for `node_modules` and dot-prefixed directories
-  */
+   * Edits matching files in the workspace.
+   * The `include` and `exclude` patterns are glob patterns relative to the workspace root.
+   * For each matching file, the `edit` callback is called with the file content,
+   * and should return the new content (or `false` to abort editing that file).
+   *
+   * Note: always adds excludes for `node_modules` and dot-prefixed directories
+   */
   files: (options: {
-    /** Glob patterns to include */include: string | string[]; /** Glob patterns to exclude */
+    /** Glob patterns to include */
+    include: string | string[];
+    /** Glob patterns to exclude */
     exclude?: string[];
     /**
-    * Only run `edit` for files whose current content matches this predicate.
-    * Useful for avoiding expensive transforms on unrelated files.
-    */
+     * Only run `edit` for files whose current content matches this predicate.
+     * Useful for avoiding expensive transforms on unrelated files.
+     */
     where?: (content: string) => boolean;
   }, edit: FileEditMultiple) => void;
 };
 type Addon<Args extends OptionDefinition, Id extends string = string, Setup extends Record<string, unknown> = Record<string, unknown>> = {
   id: Id;
-  alias?: string; /** one-liner shown in prompts  */
-  shortDescription?: string; /** link to docs/repo */
-  homepage?: string; /** If true, this addon won't appear in the interactive prompt but can still be used via CLI */
+  alias?: string;
+  /** one-liner shown in prompts  */
+  shortDescription?: string;
+  /** link to docs/repo */
+  homepage?: string;
+  /** If true, this addon won't appear in the interactive prompt but can still be used via CLI */
   hidden?: boolean;
-  options: Args; /** Setup the addon. Will be called before the addon is run. */
+  options: Args;
+  /** Setup the addon. Will be called before the addon is run. */
   setup?: (workspace: Workspace & {
-    /** On what official addons does this addon depend on? */dependsOn: (name: keyof typeof officialAddons) => void;
+    /** On what official addons does this addon depend on? */
+    dependsOn: (name: keyof typeof officialAddons) => void;
     /**
-    * Why is this addon not supported?
-    * @example
-    * if (!isKit) unsupported('Requires SvelteKit');
-    */
-    unsupported: (reason: string) => void; /** On what official addons does this addon run after? */
-    runsAfter: (name: keyof typeof officialAddons) => void; /** Dynamically add an option to be prompted to the user */
+     * Why is this addon not supported?
+     * @example
+     * if (!isKit) unsupported('Requires SvelteKit');
+     */
+    unsupported: (reason: string) => void;
+    /** On what official addons does this addon run after? */
+    runsAfter: (name: keyof typeof officialAddons) => void;
+    /** Dynamically add an option to be prompted to the user */
     addOption: <K extends Extract<keyof Setup, string>>(key: K, question: SetupOptions<Setup>[K]) => void;
-  }) => MaybePromise<void>; /** Run the addon. The actual execution of the addon... Add files, edit files, etc. */
+  }) => MaybePromise<void>;
+  /** Run the addon. The actual execution of the addon... Add files, edit files, etc. */
   run: (workspace: Workspace & {
-    /** Add-on options (includes dynamically added options from setup) */options: WorkspaceOptions<Args> & Record<string, unknown>; /** Api to interact with the workspace. */
+    /** Add-on options (includes dynamically added options from setup) */
+    options: WorkspaceOptions<Args> & Record<string, unknown>;
+    /** Api to interact with the workspace. */
     sv: SvApi;
     /** Cancel the addon at any time!
-    * @example
-    * return cancel('There is a problem with...');
-    */
+     * @example
+     * return cancel('There is a problem with...');
+     */
     cancel: (reason: string) => void;
-  }) => MaybePromise<void>; /** Next steps to display after the addon is run. */
+  }) => MaybePromise<void>;
+  /** Next steps to display after the addon is run. */
   nextSteps?: (workspace: Workspace & {
     options: WorkspaceOptions<Args> & Record<string, unknown>;
   }) => string[];
 };
 /** Maps value types to question definitions for dynamic setup options */
-type SetupOptions<T extends Record<string, unknown>> = { [K in keyof T]: BaseQuestion<any> & (T[K] extends boolean ? BooleanQuestion : T[K] extends string ? StringQuestion : T[K] extends number ? NumberQuestion : T[K] extends Array<infer V> ? MultiSelectQuestion<V> : Question<any>) };
+type SetupOptions<T extends Record<string, unknown>> = { [K in keyof T]: BaseQuestion<any> & (T[K] extends boolean ? BooleanQuestion : T[K] extends string ? StringQuestion : T[K] extends number ? NumberQuestion : T[K] extends Array<infer V> ? MultiSelectQuestion<V> : Question<any>); };
 /**
-* The entry point for your add-on.
-*
-* ```ts
-* const addon = defineAddon({ id: 'my-addon', options, run });
-* ```
-*
-* If your add-on adds dynamic options via `addOption` during setup, pass their
-* types as a type argument:
-* ```ts
-* const addon = defineAddon<{ extra: boolean }>()({ ... });
-* // Take note of the extra call here:         👆   👆
-* // This works around Typescript's lack of partial type arguments
-* addon.options.extra.default; // boolean
-* ```
-*/
+ * The entry point for your add-on.
+ *
+ * ```ts
+ * const addon = defineAddon({ id: 'my-addon', options, run });
+ * ```
+ *
+ * If your add-on adds dynamic options via `addOption` during setup, pass their
+ * types as a type argument:
+ * ```ts
+ * const addon = defineAddon<{ extra: boolean }>()({ ... });
+ * // Take note of the extra call here:         👆   👆
+ * // This works around Typescript's lack of partial type arguments
+ * addon.options.extra.default; // boolean
+ * ```
+ */
 declare function defineAddon<const Id extends string, Args extends OptionDefinition>(config: Addon<Args, Id>): Addon<Args, Id>;
 declare function defineAddon<SetupValues extends Record<string, unknown>>(): <const Id extends string, Args extends OptionDefinition>(config: Omit<Addon<Args & SetupOptions<SetupValues>, Id, SetupValues>, "options"> & {
   options: Args;
 }) => Addon<Args & SetupOptions<SetupValues>, Id, SetupValues>;
 /**
-* Stage 1: Raw CLI input - what the user typed
-*/
+ * Stage 1: Raw CLI input - what the user typed
+ */
 type AddonInput = {
   readonly specifier: string;
   readonly options: string[];
 };
 /**
-* Stage 2: Classified source - knows where addon comes from
-*/
+ * Stage 2: Classified source - knows where addon comes from
+ */
 type AddonSource = {
   readonly kind: "official";
   readonly id: string;
@@ -224,27 +244,27 @@ type AddonReference = {
   readonly source: AddonSource;
 };
 /**
-* Stage 3: Code loaded - addon definition is always present
-*/
+ * Stage 3: Code loaded - addon definition is always present
+ */
 type LoadedAddon = {
   readonly reference: AddonReference;
   readonly addon: AddonDefinition;
 };
 /**
-* Stage 4: Setup done - has dependency info
-*/
+ * Stage 4: Setup done - has dependency info
+ */
 type PreparedAddon = LoadedAddon & {
   readonly setupResult: SetupResult;
 };
 /**
-* Stage 5: User configured - has answers to questions
-*/
+ * Stage 5: User configured - has answers to questions
+ */
 type ConfiguredAddon = PreparedAddon & {
   readonly answers: OptionValues<any>;
 };
 /**
-* Stage 6: Execution result
-*/
+ * Stage 6: Execution result
+ */
 type AddonResult = {
   readonly id: string;
   readonly status: "success" | {
@@ -260,45 +280,46 @@ type SetupResult = {
 };
 type AddonDefinition<Id extends string = string> = Addon<Record<string, Question<any>>, Id>;
 type MaybePromise<T> = Promise<T> | T;
-type Prettify<T> = { [K in keyof T]: T[K] } & unknown;
+type Prettify<T> = { [K in keyof T]: T[K]; } & unknown;
 type OptionBuilder<T extends OptionDefinition> = {
   /**
-  * This type is a bit complex, but in usage, it's quite simple!
-  *
-  * The idea is to `add()` options one by one, with the key and the question.
-  *
-  * ```ts
-  *   .add('demo', {
-  *     question: 'Do you want to add a demo?',
-  *     type: 'boolean',  // string, number, select, multiselect
-  *     default: true,
-  *     // condition: (o) => o.previousOption === 'ok',
-  *   })
-  * ```
-  */
-  add<K extends string, const Q extends Question<T & Record<K, Q>>>(key: K, question: Q): OptionBuilder<T & Record<K, Q>>; /** Finalize all options of your `add-on`. */
+   * This type is a bit complex, but in usage, it's quite simple!
+   *
+   * The idea is to `add()` options one by one, with the key and the question.
+   *
+   * ```ts
+   *   .add('demo', {
+   *     question: 'Do you want to add a demo?',
+   *     type: 'boolean',  // string, number, select, multiselect
+   *     default: true,
+   *     // condition: (o) => o.previousOption === 'ok',
+   *   })
+   * ```
+   */
+  add<K extends string, const Q extends Question<T & Record<K, Q>>>(key: K, question: Q): OptionBuilder<T & Record<K, Q>>;
+  /** Finalize all options of your `add-on`. */
   build(): Prettify<T>;
 };
 /**
-* Options for an addon.
-*
-* Will be prompted to the user if there are not answered by args when calling the cli.
-*
-* ```ts
-* const options = defineAddonOptions()
-*   .add('demo', {
-*     question: `demo? ${color.optional('(a cool one!)')}`
-*     type: string | boolean | number | select | multiselect,
-*     default: true,
-*   })
-*   .build();
-* ```
-*
-* To define by args, you can do
-* ```sh
-* npx sv add <addon>=<option1>:<value1>+<option2>:<value2>
-* ```
-*/
+ * Options for an addon.
+ *
+ * Will be prompted to the user if there are not answered by args when calling the cli.
+ *
+ * ```ts
+ * const options = defineAddonOptions()
+ *   .add('demo', {
+ *     question: `demo? ${color.optional('(a cool one!)')}`
+ *     type: string | boolean | number | select | multiselect,
+ *     default: true,
+ *   })
+ *   .build();
+ * ```
+ *
+ * To define by args, you can do
+ * ```sh
+ * npx sv add <addon>=<option1>:<value1>+<option2>:<value2>
+ * ```
+ */
 declare function defineAddonOptions(): OptionBuilder<{}>;
 //#endregion
 //#region src/core/engine.d.ts
@@ -312,25 +333,15 @@ type AddonMap = Record<string, Addon<any, any>>;
 type AddonById<Addons extends AddonMap, Id extends string> = Extract<Addons[keyof Addons], {
   id: Id;
 }>;
-type OptionMap<Addons extends AddonMap> = { [Id in Addons[keyof Addons]["id"]]: Partial<OptionValues<AddonById<Addons, Id>["options"]>> };
-declare function add<Addons extends AddonMap>({
-  addons,
-  cwd,
-  options,
-  packageManager
-}: InstallOptions<Addons>): Promise<ReturnType<typeof applyAddons>>;
+type OptionMap<Addons extends AddonMap> = { [Id in Addons[keyof Addons]["id"]]: Partial<OptionValues<AddonById<Addons, Id>["options"]>>; };
+declare function add<Addons extends AddonMap>({ addons, cwd, options, packageManager }: InstallOptions<Addons>): Promise<ReturnType<typeof applyAddons>>;
 type ApplyAddonOptions = {
   loadedAddons: LoadedAddon[];
   options: OptionMap<AddonMap>;
   workspace: Workspace;
   setupResults: Record<string, SetupResult>;
 };
-declare function applyAddons({
-  loadedAddons,
-  workspace,
-  setupResults,
-  options
-}: ApplyAddonOptions): Promise<{
+declare function applyAddons({ loadedAddons, workspace, setupResults, options }: ApplyAddonOptions): Promise<{
   filesToFormat: string[];
   status: Record<string, string[] | "success">;
   installNeeded: boolean;