@neuronection/assistant-ui 0.53.0 → 0.54.0

package/dist/provider-logo.d.ts

@@ -0,0 +1,16 @@
+import * as React from 'react';
+
+interface ProviderLogoProps extends React.ComponentProps<'span'> {
+    /** Preset key (`'openai'`, `'gemini'`, …) — unknown/unshipped marks fall
+     * back to a monogram of the key's first letter. */
+    preset: string;
+    /** Square icon size in px. */
+    size?: number;
+}
+/** Provider mark for setup tiles and rows: simple-icons path data keyed by
+ * preset key, monogram fallback (openai/groq marks are gone upstream),
+ * `currentColor` so it inherits app identity. Decorative by default
+ * (`aria-hidden`) — name the tile/button it lives in. */
+declare const ProviderLogo: React.ForwardRefExoticComponent<Omit<ProviderLogoProps, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+
+export { ProviderLogo, type ProviderLogoProps };

package/dist/provider-logo.js

@@ -0,0 +1,3 @@
+export { ProviderLogo } from './chunk-7IP3JP3Z.js';
+//# sourceMappingURL=provider-logo.js.map
+//# sourceMappingURL=provider-logo.js.map

package/dist/provider-logo.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"provider-logo.js"}

package/dist/provider-setup-form.d.ts

@@ -0,0 +1,74 @@
+import * as React from 'react';
+
+/** The shared §15 error-routing enum (family contract — apps key their i18n
+ * off exactly these codes). */
+declare const SETUP_ERROR_CODES: readonly ["invalid_key", "insufficient_credit", "new_user_quota", "region_unavailable", "timeout", "local_not_running", "unknown"];
+type SetupErrorCode = (typeof SETUP_ERROR_CODES)[number];
+/** English fallback copy per code — apps inject translated labels via
+ * `errorLabels` (the library ships no i18n engine, ADR-006). */
+declare const DEFAULT_SETUP_ERROR_COPY: Record<SetupErrorCode, string>;
+/** Guided-setup preset slice (app data; snake_case API fields map app-side). */
+interface ProviderSetupFormPreset {
+    name: string;
+    keyUrl?: string;
+    steps?: string[];
+    freeTierNote?: string;
+    fixedBase?: boolean;
+    baseUrl: string;
+    /** Keyless local preset — renders `noKeyLabel` instead of the key field. */
+    local?: boolean;
+}
+interface ProviderSetupFormValue {
+    name: string;
+    apiKey: string;
+    baseUrl?: string;
+}
+/** Classified setup failure (§15 error routing) — copy comes from
+ * `errorLabels`, keyed off the code. */
+interface ProviderSetupFormError {
+    code: SetupErrorCode | string;
+    suspectedVendor?: string | null;
+}
+interface ProviderSetupFormProps extends Omit<React.ComponentProps<'form'>, 'onChange' | 'onSubmit'> {
+    preset: ProviderSetupFormPreset;
+    /** Controlled field values. */
+    value: ProviderSetupFormValue;
+    error?: ProviderSetupFormError | null;
+    /** Validation/connection test in flight — disables + marks the submit. */
+    testing?: boolean;
+    onSubmit: (value: ProviderSetupFormValue) => void;
+    onCancel?: () => void;
+    onChange: (value: ProviderSetupFormValue) => void;
+    /** Translated error copy per §15 code (`{vendor}` interpolates in the hint). */
+    errorLabels?: Partial<Record<string, string>>;
+    suspectedVendorHint?: string;
+    /** Notified when a checklist step is copied (Electron apps mirror the copy
+     * through their IPC clipboard; the browser write always happens). */
+    onCopyStep?: (step: string) => void;
+    /** Opens the key page — render an anchor by default; Electron apps pass
+     * their `openExternal` bridge to get a button instead. */
+    onOpenKeyUrl?: (url: string) => void;
+    /** Extra app content inside the Advanced disclosure (hosting toggle,
+     * country select — study/health pattern). */
+    advancedExtra?: React.ReactNode;
+    checklistLabel?: string;
+    copyLabel?: string;
+    getKeyLabel?: string;
+    nameLabel?: string;
+    apiKeyLabel?: string;
+    keyPlaceholder?: string;
+    noKeyLabel?: string;
+    advancedLabel?: string;
+    baseUrlLabel?: string;
+    baseUrlHint?: string;
+    submitLabel?: string;
+    cancelLabel?: string;
+}
+/** Guided one-click setup form (plan 26 §6): vendor checklist with copy
+ * buttons and key link, connection name, write-only API key
+ * (`autoComplete="new-password"`), and an Advanced disclosure whose base URL
+ * is read-only for fixed-endpoint presets. Validation, secrets and IPC are
+ * the app's business (ADR-006) — the form reports `onSubmit`. */
+declare const ProviderSetupForm: React.ForwardRefExoticComponent<Omit<ProviderSetupFormProps, "ref"> & React.RefAttributes<HTMLFormElement>>;
+
+export { DEFAULT_SETUP_ERROR_COPY, ProviderSetupForm, type ProviderSetupFormError, type ProviderSetupFormPreset, type ProviderSetupFormProps, type ProviderSetupFormValue, SETUP_ERROR_CODES, type SetupErrorCode };

package/dist/provider-setup-form.js

@@ -0,0 +1,3 @@
+export { DEFAULT_SETUP_ERROR_COPY, ProviderSetupForm, SETUP_ERROR_CODES } from './chunk-6G7H6YP6.js';
+//# sourceMappingURL=provider-setup-form.js.map
+//# sourceMappingURL=provider-setup-form.js.map

package/dist/provider-setup-form.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"provider-setup-form.js"}

package/dist/provider-setup-tiles.d.ts

@@ -0,0 +1,41 @@
+import * as React from 'react';
+
+/** One preset entry (ADR-006: the catalog is app data — the tiles only
+ * render it, in the order given, with equal weight). */
+interface ProviderSetupTileData {
+    key: string;
+    name: string;
+    /** Keyless local preset (e.g. Ollama) — renders the `localLabel` caption. */
+    local?: boolean;
+    /** Disabled tiles render inert with their reason (health's overlay). */
+    disabled?: boolean;
+    disabledReason?: string;
+    /** The preset ships a key-prefix hint (informational for the app). */
+    hasKeyPrefixHint?: boolean;
+}
+interface ProviderSetupTilesProps extends Omit<React.ComponentProps<'div'>, 'onSelect' | 'children'> {
+    /** Presets in the app's family order — the grid keeps it verbatim. */
+    presets: ProviderSetupTileData[];
+    /** Preset keys already configured (renders the `configuredLabel` badge). */
+    configured?: string[];
+    /** Key of a tile the app's paste-prefix match suggests (highlight only —
+     * never a "recommended" ranking; all tiles stay equal weight). */
+    suggestedKey?: string;
+    /** Fires with the preset key of the activated tile. */
+    onSelect: (key: string) => void;
+    /** Extra grid cell (e.g. the "Manual / custom" tile) — app-composed. */
+    children?: React.ReactNode;
+    label?: string;
+    localLabel?: string;
+    configuredLabel?: string;
+    /** Visually-hidden text marking the suggested tile. */
+    suggestedLabel?: string;
+}
+/** Neutral, equal-weight provider picker grid — step one of the family's
+ * one-click setup (plan 26 §6): tiles in family order, no "recommended"
+ * anywhere, local presets visible, disabled presets explain themselves. */
+declare const ProviderSetupTiles: React.ForwardRefExoticComponent<Omit<ProviderSetupTilesProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+/** The "manual / custom" tile apps append as `children` of the grid. */
+declare const ProviderSetupManualTile: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+
+export { ProviderSetupManualTile, type ProviderSetupTileData, ProviderSetupTiles, type ProviderSetupTilesProps };

package/dist/provider-setup-tiles.js

@@ -0,0 +1,3 @@
+export { ProviderSetupManualTile, ProviderSetupTiles } from './chunk-65JY3ATO.js';
+//# sourceMappingURL=provider-setup-tiles.js.map
+//# sourceMappingURL=provider-setup-tiles.js.map

package/dist/provider-setup-tiles.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"provider-setup-tiles.js"}

package/dist/setup-first-run-card.d.ts

@@ -0,0 +1,23 @@
+import * as React from 'react';
+
+interface SetupFirstRunCardProps extends Omit<React.ComponentProps<'section'>, 'title'> {
+    title: React.ReactNode;
+    body?: React.ReactNode;
+    /** The app is probing for a local engine (e.g. Ollama) — renders the
+     * `probingLabel` status line while it runs. */
+    localProbing?: boolean;
+    onSetup: () => void;
+    /** Optional dismiss — omit to render the card without a dismiss action. */
+    onDismiss?: () => void;
+    /** App content between body and actions (e.g. a detected-local banner). */
+    children?: React.ReactNode;
+    setupLabel?: string;
+    dismissLabel?: string;
+    probingLabel?: string;
+}
+/** Empty-state CTA for the AI-settings surface when no provider is
+ * configured yet (plan 26 §6) — the entry point of the setup flow. Chat
+ * empty states deep-link to the settings surface that renders this card. */
+declare const SetupFirstRunCard: React.ForwardRefExoticComponent<Omit<SetupFirstRunCardProps, "ref"> & React.RefAttributes<HTMLElement>>;
+
+export { SetupFirstRunCard, type SetupFirstRunCardProps };

package/dist/setup-first-run-card.js

@@ -0,0 +1,3 @@
+export { SetupFirstRunCard } from './chunk-YDQW2WJH.js';
+//# sourceMappingURL=setup-first-run-card.js.map
+//# sourceMappingURL=setup-first-run-card.js.map

package/dist/setup-first-run-card.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"setup-first-run-card.js"}

package/dist/setup-review.d.ts

@@ -0,0 +1,51 @@
+import * as React from 'react';
+import { LucideIcon } from 'lucide-react';
+
+/** One curated model card (capability icons render from `caps`). */
+interface SetupReviewModel {
+    id: string;
+    name: string;
+    caps?: string[];
+    selected: boolean;
+}
+/** The five-bind option keys of the §15 options body (camelCase — desktop
+ * IPC; Python apps convert to snake_case app-side). */
+type SetupReviewOptionsKey = 'bindChat' | 'bindVision' | 'bindStt' | 'bindDecision';
+/** One gap-fill switch. Pass one slot per `optionsKey` — chat presets show
+ * text/vision/stt slots, decision-only presets show the decision slot only;
+ * the current value of every slot the bind would fill rides `currentValue`. */
+interface SetupReviewSlot {
+    id: string;
+    label: string;
+    bind: boolean;
+    currentValue?: string;
+    optionsKey: SetupReviewOptionsKey;
+}
+/** The options body a setup run carries (plan 26 D14) — `curatedIds` in the
+ * order the cards are given, one bind flag per capability group. */
+interface SetupReviewOptions {
+    curatedIds: string[];
+    bindChat: boolean;
+    bindVision: boolean;
+    bindStt: boolean;
+    bindDecision: boolean;
+}
+interface SetupReviewProps extends React.ComponentProps<'div'> {
+    models: SetupReviewModel[];
+    slots: SetupReviewSlot[];
+    /** Emits the full options body on every card/switch edit — controlled:
+     * feed the changed state back through `models`/`slots`. */
+    onOptionsChange: (options: SetupReviewOptions) => void;
+    /** Per-capability icon override (capability string → icon). */
+    capIcons?: Partial<Record<string, LucideIcon>>;
+    modelsLabel?: string;
+    footnote?: string;
+}
+/** Editable pre-flight review (plan 26 §6): model-select cards with
+ * capability icons plus gap-fill switch rows with `now:` sub-lines and the
+ * never-removes footnote. Emits the five-bind options body
+ * `{curatedIds, bindChat, bindVision, bindStt, bindDecision}` — append
+ * semantics mean nothing existing is ever removed. */
+declare const SetupReview: React.ForwardRefExoticComponent<Omit<SetupReviewProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+
+export { SetupReview, type SetupReviewModel, type SetupReviewOptions, type SetupReviewOptionsKey, type SetupReviewProps, type SetupReviewSlot };

package/dist/setup-review.js

@@ -0,0 +1,3 @@
+export { SetupReview } from './chunk-FY3NCPFO.js';
+//# sourceMappingURL=setup-review.js.map
+//# sourceMappingURL=setup-review.js.map

package/dist/setup-review.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"setup-review.js"}