@smart-cloud/ai-kit-ui 1.4.11 → 1.4.13

package/dist/poweredBy.d.ts

@@ -0,0 +1,4 @@
+import { FC } from "react";
+export declare const PoweredBy: FC<{
+    variation?: "default" | "modal";
+}>;

package/dist/useAiRun.d.ts

@@ -0,0 +1,38 @@
+import { AiKitLanguageCode, type AiKitStatusEvent } from "@smart-cloud/ai-kit-core";
+export type AiRunState<T> = {
+    busy: boolean;
+    error: string | null;
+    statusEvent: AiKitStatusEvent | null;
+    result: T | null;
+    isCancelled: boolean;
+    /** Last known execution source (best-effort). */
+    lastSource: "on-device" | "backend" | null;
+};
+export type AiFeatureFunction<T> = (args: {
+    signal: AbortSignal;
+    onStatus: (e: AiKitStatusEvent) => void;
+}) => Promise<T>;
+export type UseAiRunResult<T> = AiRunState<T> & {
+    run: (func: AiFeatureFunction<T>) => Promise<T | null>;
+    cancel: () => void;
+    reset: () => void;
+    /** Current AbortSignal, if a run is in-flight. */
+    signal: AbortSignal | null;
+};
+/**
+ * Returns true if backend routing is configured in the current AiKit settings.
+ *
+ * This is intentionally conservative: it only checks *configuration*, not reachability.
+ */
+export declare function isBackendConfigured(): Promise<boolean>;
+export declare function readDefaultOutputLanguage(): AiKitLanguageCode;
+/**
+ * Removes a single surrounding Markdown code fence.
+ *
+ * Handles common model outputs like:
+ * ```json
+ * {"a":1}
+ * ```
+ */
+export declare function stripCodeFence(text: string): string;
+export declare function useAiRun<T>(): UseAiRunResult<T>;

package/dist/withAiKitShell.d.ts

@@ -0,0 +1,7 @@
+import { AiWorkerProps } from "@smart-cloud/ai-kit-core";
+import { type ComponentType } from "react";
+export type AiKitShellInjectedProps = {
+    language?: string;
+    rootElement: HTMLElement;
+};
+export declare function withAiKitShell<P extends object>(RootComponent: ComponentType<P & AiKitShellInjectedProps>, propOverrides?: Partial<AiWorkerProps>): import("react").FC<P & Partial<AiWorkerProps>>;

package/package.json

@@ -1,16 +1,18 @@
 {
   "name": "@smart-cloud/ai-kit-ui",
-  "version": "1.4.11",
+  "version": "1.4.13",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "license": "ISC",
   "scripts": {
-    "build": "tsup --minify",
+    "build": "yarn build:js && yarn build:types",
+    "build:js": "tsup --minify",
+    "build:types": "tsc -p tsconfig.types.json",
     "lint": "eslint 'src/**/*.{ts,tsx}' --report-unused-disable-directives --max-warnings 0",
     "test": "echo \"Error: no test specified\" && exit 1",
-    "publish": "WPSUITE_PREMIUM=true tsup --minify && npm publish --access=public"
+    "publish": "WPSUITE_PREMIUM=true yarn build && npm publish --access=public"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
@@ -19,16 +21,16 @@
   "dependencies": {
     "@emotion/cache": "^11.14.0",
     "@emotion/react": "^11.14.0",
-    "@mantine/colors-generator": "^8.3.16",
-    "@smart-cloud/ai-kit-core": "^1.4.7",
-    "@smart-cloud/wpsuite-core": "^2.2.10",
-    "@tabler/icons-react": "^3.40.0",
+    "@mantine/colors-generator": "^8.3.18",
+    "@smart-cloud/ai-kit-core": "^1.4.8",
+    "@smart-cloud/wpsuite-core": "^2.2.11",
+    "@tabler/icons-react": "^3.41.1",
     "chroma-js": "^3.2.0",
-    "country-flag-icons": "^1.6.15",
+    "country-flag-icons": "^1.6.16",
     "react-markdown": "^10.1.0",
     "rehype-parse": "^9.0.1",
     "rehype-raw": "^7.0.0",
-    "rehype-remark": "^10.0.0",
+    "rehype-remark": "^10.0.1",
     "rehype-sanitize": "^6.0.0",
     "rehype-stringify": "^10.0.1",
     "remark-gfm": "^4.0.1",
@@ -38,36 +40,36 @@
     "unified": "^11.0.5"
   },
   "peerDependencies": {
-    "@mantine/core": "^8.3.16",
-    "@mantine/hooks": "^8.3.16",
-    "@mantine/modals": "^8.3.16",
-    "@wordpress/data": "^10.41.0",
-    "aws-amplify": "^6.16.3",
+    "@mantine/core": "^8.3.18",
+    "@mantine/hooks": "^8.3.18",
+    "@mantine/modals": "^8.3.18",
+    "@wordpress/data": "^10.44.0",
+    "aws-amplify": "^6.16.4",
     "react": "^18.3.1",
     "react-dom": "^18.3.1"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@mantine/core": "^8.3.16",
-    "@mantine/hooks": "^8.3.16",
-    "@mantine/modals": "^8.3.16",
-    "@types/dom-chromium-ai": "^0.0.15",
+    "@mantine/core": "^8.3.18",
+    "@mantine/hooks": "^8.3.18",
+    "@mantine/modals": "^8.3.18",
+    "@types/dom-chromium-ai": "^0.0.16",
     "@types/jquery": "^4.0.0",
     "@types/react": "^18.3.23",
     "@types/react-dom": "^18.3.7",
-    "@typescript-eslint/eslint-plugin": "^8.57.0",
-    "@typescript-eslint/parser": "^8.57.0",
-    "@wordpress/data": "^10.41.0",
+    "@typescript-eslint/eslint-plugin": "^8.58.2",
+    "@typescript-eslint/parser": "^8.58.2",
+    "@wordpress/data": "^10.44.0",
     "ajv": "^8.18.0",
-    "aws-amplify": "^6.16.3",
-    "eslint": "^10.0.3",
-    "globals": "^17.4.0",
+    "aws-amplify": "^6.16.4",
+    "eslint": "^10.2.1",
+    "globals": "^17.5.0",
     "jquery": "^4.0.0",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "tsup": "^8.5.1",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.57.0"
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.58.2"
   },
   "exports": {
     ".": {

package/src/doc-search/DocSearch.tsx

@@ -19,6 +19,7 @@ import {
 import {
   AiKitDocSearchIcon,
   CapabilityDecision,
+  type ContextKind,
   dispatchBackend,
   resolveBackend,
   sendSearchMessage,
@@ -51,8 +52,75 @@ I18n.putVocabularies(translations);
 
 type Props = DocSearchProps & AiKitShellInjectedProps;
 
+type MetadataOptions = {
+  allowedCategories: Record<string, string[]>;
+  allowedTags: string[];
+};
+
+const metadataOptionsCache = new Map<string, MetadataOptions>();
+const metadataOptionsRequestCache = new Map<string, Promise<MetadataOptions>>();
+
 const USE_AUDIO = false; // Set to true to enable audio recording feature (requires backend support for audio input)
 
+async function loadMetadataOptionsFromBackend(
+  context: ContextKind,
+): Promise<MetadataOptions> {
+  const cached = metadataOptionsCache.get(context);
+  if (cached) {
+    return cached;
+  }
+
+  const inFlight = metadataOptionsRequestCache.get(context);
+  if (inFlight) {
+    return inFlight;
+  }
+
+  const request = (async () => {
+    const backend = await resolveBackend();
+
+    if (!backend.available) {
+      throw new Error("Backend not available for metadata options");
+    }
+
+    const decision: CapabilityDecision = {
+      feature: "prompt",
+      source: "backend",
+      mode: "backend-only",
+      onDeviceAvailable: false,
+      backendAvailable: backend.available,
+      backendTransport: backend.transport,
+      backendApiName: backend.apiName,
+      backendBaseUrl: backend.baseUrl,
+      reason: backend.reason ?? "",
+    };
+
+    const data = (await dispatchBackend(
+      decision,
+      context,
+      "/kb/metadata-options",
+      "GET",
+      null,
+      {},
+    )) as MetadataOptions;
+
+    const normalized: MetadataOptions = {
+      allowedCategories: data.allowedCategories || {},
+      allowedTags: data.allowedTags || [],
+    };
+
+    metadataOptionsCache.set(context, normalized);
+    return normalized;
+  })();
+
+  metadataOptionsRequestCache.set(context, request);
+
+  try {
+    return await request;
+  } finally {
+    metadataOptionsRequestCache.delete(context);
+  }
+}
+
 function groupChunksByDoc(result: SearchResult | null) {
   const docs = result?.citations?.docs ?? [];
   const chunks = result?.citations?.chunks ?? [];
@@ -157,10 +225,8 @@ const DocSearchBase: FC<Props> = (props) => {
   );
   const [selectedTags, setSelectedTags] = useState<string[]>([]);
   const [tagSearchValue, setTagSearchValue] = useState<string>("");
-  const [metadataOptions, setMetadataOptions] = useState<{
-    allowedCategories: Record<string, string[]>;
-    allowedTags: string[];
-  } | null>(null);
+  const [metadataOptions, setMetadataOptions] =
+    useState<MetadataOptions | null>(null);
   const [loadingMetadata, setLoadingMetadata] = useState(false);
   const animationFrameRef = useRef<number | null>(null);
 
@@ -351,6 +417,8 @@ const DocSearchBase: FC<Props> = (props) => {
   useEffect(() => {
     if (!enableUserFilters) return;
 
+    if (showOpenButton && !featureOpen) return;
+
     // Use provided options if available
     if (availableCategories || availableTags) {
       setMetadataOptions({
@@ -362,43 +430,14 @@ const DocSearchBase: FC<Props> = (props) => {
 
     // Otherwise fetch from backend
     const loadMetadata = async () => {
+      const effectiveContext: ContextKind =
+        context === "admin" ? "admin" : "frontend";
+
       setLoadingMetadata(true);
       try {
-        const backend = await resolveBackend();
-
-        if (!backend.available) {
-          console.error("Backend not available for metadata options");
-          return;
-        }
+        const data = await loadMetadataOptionsFromBackend(effectiveContext);
 
-        const decision: CapabilityDecision = {
-          feature: "prompt",
-          source: "backend",
-          mode: "backend-only",
-          onDeviceAvailable: false,
-          backendAvailable: backend.available,
-          backendTransport: backend.transport,
-          backendApiName: backend.apiName,
-          backendBaseUrl: backend.baseUrl,
-          reason: backend.reason ?? "",
-        };
-
-        const data = (await dispatchBackend(
-          decision,
-          context ?? "frontend",
-          "/kb/metadata-options",
-          "GET",
-          null,
-          {},
-        )) as {
-          allowedCategories: Record<string, string[]>;
-          allowedTags: string[];
-        };
-
-        setMetadataOptions({
-          allowedCategories: data.allowedCategories || {},
-          allowedTags: data.allowedTags || [],
-        });
+        setMetadataOptions(data);
       } catch (error) {
         console.error("Failed to load metadata options:", error);
       } finally {
@@ -407,7 +446,14 @@ const DocSearchBase: FC<Props> = (props) => {
     };
 
     void loadMetadata();
-  }, [enableUserFilters, availableCategories, availableTags, context]);
+  }, [
+    enableUserFilters,
+    availableCategories,
+    availableTags,
+    context,
+    featureOpen,
+    showOpenButton,
+  ]);
 
   const onSearch = useCallback(async () => {
     let q: string | undefined;

package/tsconfig.types.json

@@ -0,0 +1,13 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "noEmit": false,
+    "declaration": true,
+    "emitDeclarationOnly": true,
+    "declarationMap": false,
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src"],
+  "exclude": ["dist", "build", "node_modules", "tsup.config.ts"]
+}

package/tsup.config.ts

@@ -7,7 +7,7 @@ export default defineConfig({
 
   entry: ["src/index.tsx"],
   format: ["cjs", "esm"],
-  dts: true,
+  dts: false,
   splitting: false,
   sourcemap: false,
   clean: true,

package/dist/index.d.cts

@@ -1,112 +0,0 @@
-import * as _smart_cloud_ai_kit_core from '@smart-cloud/ai-kit-core';
-import { AiModePreference, HistoryStorageMode, AiChatbotLabels, AiKitStatusEvent, AiKitLanguageCode, AiWorkerProps } from '@smart-cloud/ai-kit-core';
-import * as React from 'react';
-import React__default, { FC, ComponentType } from 'react';
-
-declare const AiFeature: FC<_smart_cloud_ai_kit_core.AiWorkerProps & {
-    mode: _smart_cloud_ai_kit_core.AiFeatureMode;
-    context?: _smart_cloud_ai_kit_core.ContextKind;
-    modeOverride?: AiModePreference;
-    autoRun?: boolean;
-    onDeviceTimeout?: number;
-    editable?: boolean;
-    acceptButtonTitle?: string;
-    showRegenerateOnBackendButton?: boolean;
-    optionsDisplay?: "collapse" | "horizontal" | "vertical";
-    default?: _smart_cloud_ai_kit_core.AiFeatureOptions & {
-        getText?: Promise<string> | (() => Promise<string>);
-        image?: Blob;
-    };
-    allowOverride?: {
-        text?: boolean;
-        instructions?: boolean;
-        tone?: boolean;
-        length?: boolean;
-        type?: boolean;
-        outputLanguage?: boolean;
-        outputFormat?: boolean;
-    };
-    onAccept?: (result: unknown) => void;
-    onOptionsChanged?: (options: _smart_cloud_ai_kit_core.AiFeatureOptions) => void;
-} & Partial<_smart_cloud_ai_kit_core.AiWorkerProps>>;
-
-declare const markdownToHtml: (markdown: string) => Promise<string>;
-
-declare const DEFAULT_CHATBOT_LABELS: Required<AiChatbotLabels>;
-declare const AiChatbot: React__default.FC<_smart_cloud_ai_kit_core.AiWorkerProps & {
-    context?: _smart_cloud_ai_kit_core.ContextKind;
-    placeholder?: string;
-    maxImages?: number;
-    maxImageBytes?: number;
-    previewMode?: boolean;
-    historyStorage?: HistoryStorageMode;
-    emptyHistoryAfterDays?: number;
-    labels?: AiChatbotLabels;
-    openButtonIconLayout?: _smart_cloud_ai_kit_core.OpenButtonIconLayout;
-    openButtonPosition?: _smart_cloud_ai_kit_core.OpenButtonPosition;
-} & Partial<_smart_cloud_ai_kit_core.AiWorkerProps>>;
-
-declare const DocSearch: FC<_smart_cloud_ai_kit_core.AiWorkerProps & {
-    context?: _smart_cloud_ai_kit_core.ContextKind;
-    autoRun?: boolean;
-    title?: string;
-    getSearchText?: () => string;
-    searchButtonIcon?: string;
-    showSearchButtonTitle?: boolean;
-    showSearchButtonIcon?: boolean;
-    showSources?: boolean;
-    topK?: number;
-    snippetMaxChars?: number;
-    onClickDoc?: (doc: _smart_cloud_ai_kit_core.RetrievedDoc) => void;
-    enableUserFilters?: boolean;
-    availableCategories?: Record<string, string[]>;
-    availableTags?: string[];
-} & Partial<_smart_cloud_ai_kit_core.AiWorkerProps>>;
-
-type AiRunState<T> = {
-    busy: boolean;
-    error: string | null;
-    statusEvent: AiKitStatusEvent | null;
-    result: T | null;
-    isCancelled: boolean;
-    /** Last known execution source (best-effort). */
-    lastSource: "on-device" | "backend" | null;
-};
-type AiFeatureFunction<T> = (args: {
-    signal: AbortSignal;
-    onStatus: (e: AiKitStatusEvent) => void;
-}) => Promise<T>;
-type UseAiRunResult<T> = AiRunState<T> & {
-    run: (func: AiFeatureFunction<T>) => Promise<T | null>;
-    cancel: () => void;
-    reset: () => void;
-    /** Current AbortSignal, if a run is in-flight. */
-    signal: AbortSignal | null;
-};
-/**
- * Returns true if backend routing is configured in the current AiKit settings.
- *
- * This is intentionally conservative: it only checks *configuration*, not reachability.
- */
-declare function isBackendConfigured(): Promise<boolean>;
-declare function readDefaultOutputLanguage(): AiKitLanguageCode;
-/**
- * Removes a single surrounding Markdown code fence.
- *
- * Handles common model outputs like:
- * ```json
- * {"a":1}
- * ```
- */
-declare function stripCodeFence(text: string): string;
-declare function useAiRun<T>(): UseAiRunResult<T>;
-
-type AiKitShellInjectedProps = {
-    language?: string;
-    rootElement: HTMLElement;
-};
-declare function withAiKitShell<P extends object>(RootComponent: ComponentType<P & AiKitShellInjectedProps>, propOverrides?: Partial<AiWorkerProps>): React.FC<P & Partial<AiWorkerProps>>;
-
-declare const translations: Record<string, Record<string, string>>;
-
-export { AiChatbot, AiFeature, type AiFeatureFunction, type AiRunState, DEFAULT_CHATBOT_LABELS, DocSearch, type UseAiRunResult, isBackendConfigured, markdownToHtml, readDefaultOutputLanguage, stripCodeFence, translations, useAiRun, withAiKitShell };