@acarmisc/backstage-plugin-litellm 0.26.0 → 0.28.0

package/dist/components/GenerateKeyButton.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+/**
+ * The single "create a key" call-to-action used everywhere in the plugin —
+ * the plugin page (header, keys table) and the homepage budget card all
+ * render this instead of their own inline `Button`, so the copy, icon and
+ * styling stay identical.
+ */
+export interface GenerateKeyButtonProps {
+    /** Deep-link target (e.g. `/litellm?generate=1`). Ignored when `onClick` is set. */
+    to?: string;
+    /** Click handler. Takes precedence over `to` when both are given. */
+    onClick?: () => void;
+    /** Override the default `Generate New Key` copy (e.g. empty-state variants). */
+    label?: string;
+    /** Button size — card footers use `small`, page headers the default. */
+    size?: 'small' | 'medium' | 'large';
+    /** Stretch to the container width (card-footers). Defaults to false. */
+    fullWidth?: boolean;
+    /** Disabled state (e.g. until the account data loads). A disabled `to` renders inert. */
+    disabled?: boolean;
+}
+export declare const GenerateKeyButton: React.FC<GenerateKeyButtonProps>;

package/dist/components/LiteLLMBudgetGauges.d.ts

@@ -1,19 +1,26 @@
 /**
  * Condensed budget card for a homepage column: one ring gauge per
- * enforcement level (key → personal → team), each showing the limit nearest
- * its cap. Where the full `LiteLLMBudgetWidget` lists every limit as a
- * spend-vs-cap meter, this trades detail for density — a single row of rings
- * with a label and spend figure under each.
+ * enforcement level (key → personal → team) plus a month-to-date daily
+ * token-usage mini-chart, in a fixed four-column row. Each gauge shows the
+ * limit nearest its cap; where the full `LiteLLMBudgetWidget` lists every
+ * limit as a spend-vs-cap meter, this trades detail for density — a single
+ * row with a label and spend figure under each gauge, and the MTD token
+ * total under the chart.
  *
  * Gauges are always rendered in the same order, with an empty ring when the
  * user has no cap at that level, so the card keeps a stable shape as data
  * loads and across users. When a level holds several limits, the ring shows
  * the one closest to its cap and a "+N more" link counts the rest.
  *
- * The bottom action bar is composable: pass any subset of `ctas` — mint a new
- * key, open the LiteLLM module, or expand the full per-limit list in place —
- * in the order you want. `action` remains an escape hatch for a fully custom
- * node; when either is present it renders below a divider.
+ * The usage period is frozen to month-to-date (no period selector): the
+ * chart always covers the 1st of the current month through today.
+ *
+ * The bottom action bar is composable: pass any subset of `ctas` — generate
+ * a new key, open the LiteLLM module, or expand the full per-limit list in
+ * place — in the order you want. `action` remains an escape hatch for a
+ * fully custom node; when either is present it renders below a divider. The
+ * `new-key` CTA renders the shared `GenerateKeyButton`, identical to the
+ * one on the plugin page.
  */
 import React from 'react';
 /** Preset action-bar buttons. `label` overrides the default copy. */
@@ -35,8 +42,9 @@ export interface LiteLLMBudgetGaugesProps {
     /** Where the module CTA points. Defaults to the LiteLLM page. */
     moduleHref?: string;
     /**
-     * Called when the "new key" CTA is used. When omitted, the CTA deep-links
-     * to the module with `?generate=1`, which opens the generate-key dialog.
+     * Called when the "Generate New Key" CTA is used. When omitted, the CTA
+     * deep-links to the module with `?generate=1`, which opens the
+     * generate-key dialog.
      */
     onCreateKey?: () => void;
     /**
@@ -56,4 +64,9 @@ export interface LiteLLMBudgetGaugesProps {
     /** Fully custom node pinned below the CTAs, below a divider. */
     action?: React.ReactNode;
 }
+/** Month-to-date range as `YYYY-MM-DD` strings: the 1st of the current month through today. */
+export declare function monthToDateRange(now?: Date): {
+    startDate: string;
+    endDate: string;
+};
 export declare const LiteLLMBudgetGauges: React.FC<LiteLLMBudgetGaugesProps>;