@kidd-cli/core 0.4.0 → 0.5.1

package/dist/middleware/auth.d.ts

@@ -1,4 +1,4 @@
-import { p as Context, u as Middleware } from "../types-U73X_oQ_.js";
+import { f as Middleware, h as Context } from "../types-s-yUj9Zj.js";
 import { AsyncResult } from "@kidd-cli/utils/fp";
 
 //#region src/middleware/auth/require.d.ts

package/dist/middleware/auth.js

@@ -1,6 +1,6 @@
-import { n as decorateContext, t as middleware } from "../middleware-BWnPSRWR.js";
-import "../project-D0g84bZY.js";
-import { t as createStore } from "../create-store-OHdkm_Yt.js";
+import { n as decorateContext, t as middleware } from "../middleware-BewRXb2G.js";
+import "../project-CoWHMVc8.js";
+import { t as createStore } from "../create-store-CGeHrTcl.js";
 import { join } from "node:path";
 import { attempt, attemptAsync, isPlainObject, match, ok } from "@kidd-cli/utils/fp";
 import { z } from "zod";

package/dist/middleware/http.d.ts

@@ -1,4 +1,4 @@
-import { p as Context, u as Middleware } from "../types-U73X_oQ_.js";
+import { f as Middleware, h as Context } from "../types-s-yUj9Zj.js";
 
 //#region src/middleware/http/types.d.ts
 /**

package/dist/middleware/http.js

@@ -1,4 +1,4 @@
-import { n as decorateContext, t as middleware } from "../middleware-BWnPSRWR.js";
+import { n as decorateContext, t as middleware } from "../middleware-BewRXb2G.js";
 import { attemptAsync } from "@kidd-cli/utils/fp";
 //#region src/middleware/http/create-http-client.ts
 /**

package/dist/middleware/icons.d.ts

@@ -0,0 +1,119 @@
+import { f as Middleware } from "../types-s-yUj9Zj.js";
+import { AsyncResult } from "@kidd-cli/utils/fp";
+
+//#region src/middleware/icons/types.d.ts
+/**
+* A single icon definition with both Nerd Font glyph and emoji fallback.
+*/
+interface IconDefinition {
+  readonly nerdFont: string;
+  readonly emoji: string;
+}
+/**
+* Supported icon categories for grouping icons by domain.
+*/
+type IconCategory = "git" | "devops" | "status" | "files";
+/**
+* Error returned by icons middleware operations.
+*/
+interface IconsError {
+  readonly type: "detection_failed" | "install_failed";
+  readonly message: string;
+}
+/**
+* Options accepted by the `icons()` middleware factory.
+*
+* @property icons - Custom icon definitions to merge with defaults.
+* @property autoSetup - When true, prompts to install Nerd Fonts if not detected.
+* @property font - The Nerd Font family to install (defaults to JetBrainsMono).
+* @property forceSetup - When true, always show the install prompt even if fonts are detected.
+*/
+interface IconsOptions {
+  readonly icons?: Readonly<Record<string, IconDefinition>>;
+  readonly autoSetup?: boolean;
+  readonly font?: string;
+  readonly forceSetup?: boolean;
+}
+/**
+* Icons context decorated onto `ctx.icons` by the icons middleware.
+*
+* Provides methods to resolve icon names to glyphs, check installation
+* status, and interactively install Nerd Fonts.
+*/
+interface IconsContext {
+  /**
+  * Resolve an icon name to its glyph string.
+  *
+  * @param name - The icon name to resolve.
+  * @returns The resolved glyph string, or empty string if not found.
+  */
+  readonly get: (name: string) => string;
+  /**
+  * Check whether an icon name is defined.
+  *
+  * @param name - The icon name to check.
+  * @returns True when the icon name exists in definitions.
+  */
+  readonly has: (name: string) => boolean;
+  /**
+  * Check whether Nerd Fonts are detected on the system.
+  *
+  * @returns True when Nerd Fonts are installed.
+  */
+  readonly installed: () => boolean;
+  /**
+  * Interactively prompt to install Nerd Fonts.
+  *
+  * @returns A Result with true on success or an IconsError on failure.
+  */
+  readonly setup: () => AsyncResult<boolean, IconsError>;
+  /**
+  * Get all resolved icons for a given category.
+  *
+  * @param cat - The icon category to retrieve.
+  * @returns A record mapping icon names to resolved glyph strings.
+  */
+  readonly category: (cat: IconCategory) => Readonly<Record<string, string>>;
+}
+/**
+* Factory function type for the icons middleware.
+*/
+type IconsFactory = (options?: IconsOptions) => Middleware;
+/**
+* Augments the base {@link Context} with an optional `icons` property.
+*
+* When a consumer imports `@kidd-cli/core/icons`, this declaration merges
+* `icons` onto `Context` so that `ctx.icons` is typed without manual casting.
+*/
+declare module "@kidd-cli/core" {
+  interface Context {
+    readonly icons: IconsContext;
+  }
+}
+//#endregion
+//#region src/middleware/icons/icons.d.ts
+/**
+* Create an icons middleware that decorates `ctx.icons`.
+*
+* Detects whether Nerd Fonts are installed. When `autoSetup` is enabled
+* and fonts are missing, prompts the user to install them. Merges any
+* custom icon definitions with the built-in defaults.
+*
+* @param options - Optional middleware configuration.
+* @returns A Middleware instance.
+*
+* @example
+* ```ts
+* import { icons } from '@kidd-cli/core/icons'
+*
+* cli({
+*   middleware: [
+*     icons({ autoSetup: true, font: 'JetBrainsMono' }),
+*   ],
+* })
+* ```
+*/
+declare function icons(options?: IconsOptions): Middleware;
+//#endregion
+export { type IconCategory, type IconDefinition, type IconsContext, type IconsError, type IconsFactory, type IconsOptions, icons };
+//# sourceMappingURL=icons.d.ts.map

package/dist/middleware/icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.d.ts","names":[],"sources":["../../src/middleware/icons/types.ts","../../src/middleware/icons/icons.ts"],"mappings":";;;;;;;UAoBiB,cAAA;EAAA,SACN,QAAA;EAAA,SACA,KAAA;AAAA;;;AAoCX;KA1BY,YAAA;;;;UASK,UAAA;EAAA,SACN,IAAA;EAAA,SACA,OAAA;AAAA;;;;;;;;;UAeM,YAAA;EAAA,SACN,KAAA,GAAQ,QAAA,CAAS,MAAA,SAAe,cAAA;EAAA,SAChC,SAAA;EAAA,SACA,IAAA;EAAA,SACA,UAAA;AAAA;;;;;;;UAaM,YAAA;;;;;;;WAON,GAAA,GAAM,IAAA;;;;;;AAwCjB;WAhCW,GAAA,GAAM,IAAA;;;;;;WAON,SAAA;EAyB4C;AAAA;;;;EAAA,SAlB5C,KAAA,QAAa,WAAA,UAAqB,UAAA;;;;;;;WAQlC,QAAA,GAAW,GAAA,EAAK,YAAA,KAAiB,QAAA,CAAS,MAAA;AAAA;ACnErD;;;AAAA,KD6EY,YAAA,IAAgB,OAAA,GAAU,YAAA,KAAiB,UAAA;;;;;;;;YAa3C,OAAA;IAAA,SACC,KAAA,EAAO,YAAA;EAAA;AAAA;;;;;AApHpB;;;;;AAYA;;;;;AASA;;;;;AAiBA;;;;iBCbgB,KAAA,CAAM,OAAA,GAAU,YAAA,GAAe,UAAA"}