@belonguniverseai/react-sdk 0.6.31 → 0.6.32

package/dist/components/guide/GuideSettings.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Settings → Guide: the Simetrik agent Guide, a small help center about the
+ * agent in the dock's own language (spec decisions 1, 2, 11–14).
+ *
+ * The guide is fetched when this section opens (`useGuide`), already filtered
+ * by what the deployment has switched on. The view is the hub or one article.
+ * Its state lives here, above the fetch states, so a language switch refetches
+ * and comes back to whichever was open; an article that is no longer served
+ * falls back to the hub. Every hub ↔ article change calls `onNavigate`, so the
+ * settings panel can reset its scroll.
+ *
+ * Focus: an opened article focuses its title (`GuideArticleView`), and Back
+ * puts focus on the hub item that opened it — or on the search box when the
+ * reader got there through a `guide:` link.
+ *
+ * Quiet by design (§42): loading is one muted line, and a failed fetch is a
+ * calm "Couldn't load the guide" with a Retry that refetches. An older cloud
+ * without the route (404) says the guide isn't available here yet, with no
+ * Retry, since retrying could never help. Nothing here is red.
+ */
+export declare const GuideSettings: ({ onNavigate }: {
+    readonly onNavigate?: () => void;
+}) => import("react").JSX.Element;

package/dist/components/guide/figures/ComposerIndicatorsFigure.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The `composer-indicators` figure: a static drawing of the dock's message box
+ * with numbered callouts, placed by the `on-screen` article.
+ *
+ *   1 — the percentage ring just above the box, outside it (`UsageMeter`),
+ *       drawn at 25%;
+ *   2 — the execution-mode button inside the box, in its default mode;
+ *   3 — the activity line in the conversation ("Working on it…").
+ *
+ * The article's numbered list follows the same order. Every label the real
+ * dock shows comes from the dock's OWN catalog entry — the mode name, the
+ * activity line, the Simetrik composer placeholder — so the drawing relabels
+ * with the dock and cannot drift from the screen. Theme tokens only, no red
+ * (§42). Presentational: one `role="img"` with a spoken description.
+ */
+export declare const ComposerIndicatorsFigure: () => import("react").JSX.Element;

package/dist/components/guide/figures/SharedTaskCopiesFigure.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The `shared-task-copies` figure: why a shared scheduled task can run twice.
+ * The original task and the copy a second account enabled are each ACTIVE, and
+ * each active copy is its own schedule, so one time of day adds up to two runs.
+ * Placed by the `task-ran-twice` and `scheduled-tasks` articles.
+ *
+ * The status chip, the cadence line and the "Share" step read the Scheduled
+ * view's OWN catalog entries, and the time is formatted the way that view
+ * formats it, so the drawing cannot drift from the screen. Theme tokens only,
+ * no red (§42). Presentational: one `role="img"` with a spoken description.
+ */
+export declare const SharedTaskCopiesFigure: () => import("react").JSX.Element;

package/dist/components/guide/figures/index.d.ts

@@ -0,0 +1,3 @@
+import { ComponentType } from 'react';
+import { GuideFigureId } from '@belong/codec/guide';
+export declare const GUIDE_FIGURES: Readonly<Record<GuideFigureId, ComponentType>>;

package/dist/components/guide/guide-fixtures.d.ts

@@ -0,0 +1,3 @@
+import { GuideResponse } from '@belong/codec/guide';
+export declare const GUIDE_FIXTURE_EN: GuideResponse;
+export declare const GUIDE_FIXTURE_ES: GuideResponse;

package/dist/components/guide/guide-icons.d.ts

@@ -0,0 +1,3 @@
+import { LucideIcon } from 'lucide-react';
+import { GuideIconKey } from '@belong/codec/guide';
+export declare const GUIDE_ICONS: Readonly<Record<GuideIconKey, LucideIcon>>;

package/dist/components/guide/guide-link.d.ts

@@ -0,0 +1,12 @@
+import { StreamdownComponents } from '../ai-elements/dock-link.tsx';
+/** What a guide link can open: the served article ids, and how to open one. */
+export type GuideNavigation = {
+    readonly knownIds: ReadonlySet<string>;
+    readonly open: (articleId: string) => void;
+};
+/** Provided by the article view; `null` everywhere else (links read as text). */
+export declare const GuideNavigationContext: import('react').Context<GuideNavigation | null>;
+/** Rewrites each `](guide:<id>)` target to the sanitizer-safe `](#guide:<id>)`. */
+export declare const withGuideLinkTargets: (markdown: string) => string;
+/** Module-level, so the identity is stable across renders (Streamdown memoises on it). */
+export declare const guideMarkdownComponents: StreamdownComponents;

package/dist/components/guide/guide-search.d.ts

@@ -0,0 +1,15 @@
+import { GuideArticle } from '@belong/codec/guide';
+/** NFD, accents dropped, lowercased, whitespace collapsed and trimmed. */
+export declare const normalizeForSearch: (text: string) => string;
+/**
+ * What a reader sees of an article body: marker comments, heading hashes,
+ * emphasis and code ticks, and link targets removed (the link text is kept).
+ * Linear in the body's length, whatever the body holds.
+ */
+export declare const guidePlainText: (markdown: string) => string;
+/**
+ * Articles whose title or plain-text body contains the query. Title matches
+ * come first, then body-only matches; each group keeps the input order. A query
+ * that is empty once normalized (only spaces) is no query, and finds nothing.
+ */
+export declare const searchGuide: (articles: readonly GuideArticle[], query: string) => readonly GuideArticle[];

package/dist/components/ui/button.d.ts

@@ -2,7 +2,7 @@ import { VariantProps } from 'class-variance-authority';
 import * as React from "react";
 declare const buttonVariants: (props?: ({
     variant?: "default" | "link" | "destructive" | "secondary" | "outline" | "ghost" | null | undefined;
-    size?: "default" | "xs" | "sm" | "lg" | "icon" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
+    size?: "default" | "icon" | "xs" | "sm" | "lg" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
 } & import('class-variance-authority/types').ClassProp) | undefined) => string;
 type ButtonProps = React.ComponentProps<"button"> & VariantProps<typeof buttonVariants> & {
     asChild?: boolean;

package/dist/components/ui/input-group.d.ts

@@ -7,7 +7,7 @@ declare const inputGroupAddonVariants: (props?: ({
 declare function InputGroupAddon({ className, align, ...props }: React.ComponentProps<"div"> & VariantProps<typeof inputGroupAddonVariants>): React.JSX.Element;
 declare const InputGroupButton: React.ForwardRefExoticComponent<Omit<Omit<Omit<React.ClassAttributes<HTMLButtonElement> & React.ButtonHTMLAttributes<HTMLButtonElement> & VariantProps<(props?: ({
     variant?: "default" | "link" | "destructive" | "secondary" | "outline" | "ghost" | null | undefined;
-    size?: "default" | "xs" | "sm" | "lg" | "icon" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
+    size?: "default" | "icon" | "xs" | "sm" | "lg" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
 } & import('class-variance-authority/types').ClassProp) | undefined) => string> & {
     asChild?: boolean;
 }, "ref"> & React.RefAttributes<HTMLButtonElement>, "size"> & VariantProps<(props?: ({

package/dist/i18n/messages/en.d.ts

@@ -377,6 +377,8 @@ export declare const en: {
         aboutDescription: string;
         apiKeys: string;
         apiKeysDescription: string;
+        guide: string;
+        guideDescription: string;
         apiKeysName: string;
         apiKeysCreate: string;
         apiKeysRevoke: string;
@@ -898,6 +900,34 @@ export declare const en: {
         readonly ageDays: "{{count}}d ago";
         readonly attachmentFallback: "attachment";
     };
+    readonly guide: {
+        readonly summaryTitle: "In 30 seconds";
+        readonly searchPlaceholder: "Search the guide";
+        readonly searchLabel: "Search the guide";
+        readonly commonQuestions: "Common questions";
+        readonly topics: "Topics";
+        readonly backToGuide: "Guide";
+        readonly backLabel: "Back to the guide";
+        readonly resultsCount_one: "{{count}} result";
+        readonly resultsCount_other: "{{count}} results";
+        readonly noResults: "Nothing in the guide matches “{{query}}”.";
+        readonly loading: "Loading the guide…";
+        readonly loadFailed: "Couldn't load the guide.";
+        readonly unavailable: "The guide isn't available here yet.";
+        readonly retry: "Try again";
+        readonly figures: {
+            readonly composer: {
+                readonly alt: "The message box with three numbered parts: 1, the percentage above the box; 2, the mode button; 3, the activity line in the conversation.";
+            };
+            readonly sharedTask: {
+                readonly alt: "The same scheduled task active in two accounts: the original and a shared copy. Each active copy runs on its own, so the task runs twice at the same time.";
+                readonly original: "Original task · first account";
+                readonly copy: "Shared copy · second account";
+                readonly total_one: "{{count}} run at {{time}}";
+                readonly total_other: "{{count}} runs at {{time}}";
+            };
+        };
+    };
     readonly feedback: {
         readonly goodResponse: "Good response";
         readonly badResponse: "Bad response";

package/dist/i18n/messages/surfaces/guide.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Settings → Guide chrome (the Simetrik agent Guide): the hub's headings, the
+ * search box, the article back button, the loading and failure lines, and the
+ * labels the two figures draw that the dock has no catalog entry for yet.
+ *
+ * The articles themselves are served by belong-cloud; only chrome lives here.
+ * A figure label that the real dock already shows (the mode name, the activity
+ * line, the composer placeholder, a schedule's status and cadence) is NOT
+ * repeated here: the figures read the dock's own entry, so they cannot drift.
+ * Quiet by design (§42): the failure line is calm and offers a retry.
+ */
+export declare const guideEn: {
+    readonly guide: {
+        readonly summaryTitle: "In 30 seconds";
+        readonly searchPlaceholder: "Search the guide";
+        readonly searchLabel: "Search the guide";
+        readonly commonQuestions: "Common questions";
+        readonly topics: "Topics";
+        readonly backToGuide: "Guide";
+        readonly backLabel: "Back to the guide";
+        readonly resultsCount_one: "{{count}} result";
+        readonly resultsCount_other: "{{count}} results";
+        readonly noResults: "Nothing in the guide matches “{{query}}”.";
+        readonly loading: "Loading the guide…";
+        readonly loadFailed: "Couldn't load the guide.";
+        readonly unavailable: "The guide isn't available here yet.";
+        readonly retry: "Try again";
+        readonly figures: {
+            readonly composer: {
+                readonly alt: "The message box with three numbered parts: 1, the percentage above the box; 2, the mode button; 3, the activity line in the conversation.";
+            };
+            readonly sharedTask: {
+                readonly alt: "The same scheduled task active in two accounts: the original and a shared copy. Each active copy runs on its own, so the task runs twice at the same time.";
+                readonly original: "Original task · first account";
+                readonly copy: "Shared copy · second account";
+                readonly total_one: "{{count}} run at {{time}}";
+                readonly total_other: "{{count}} runs at {{time}}";
+            };
+        };
+    };
+};
+export declare const guideEs: {
+    guide: {
+        summaryTitle: string;
+        searchPlaceholder: string;
+        searchLabel: string;
+        commonQuestions: string;
+        topics: string;
+        backToGuide: string;
+        backLabel: string;
+        resultsCount_one: string;
+        resultsCount_other: string;
+        noResults: string;
+        loading: string;
+        loadFailed: string;
+        unavailable: string;
+        retry: string;
+        figures: {
+            composer: {
+                alt: string;
+            };
+            sharedTask: {
+                alt: string;
+                original: string;
+                copy: string;
+                total_one: string;
+                total_other: string;
+            };
+        };
+    };
+};
+export declare const guidePt: {
+    guide: {
+        summaryTitle: string;
+        searchPlaceholder: string;
+        searchLabel: string;
+        commonQuestions: string;
+        topics: string;
+        backToGuide: string;
+        backLabel: string;
+        resultsCount_one: string;
+        resultsCount_other: string;
+        noResults: string;
+        loading: string;
+        loadFailed: string;
+        unavailable: string;
+        retry: string;
+        figures: {
+            composer: {
+                alt: string;
+            };
+            sharedTask: {
+                alt: string;
+                original: string;
+                copy: string;
+                total_one: string;
+                total_other: string;
+            };
+        };
+    };
+};
+export declare const guideIt: {
+    guide: {
+        summaryTitle: string;
+        searchPlaceholder: string;
+        searchLabel: string;
+        commonQuestions: string;
+        topics: string;
+        backToGuide: string;
+        backLabel: string;
+        resultsCount_one: string;
+        resultsCount_other: string;
+        noResults: string;
+        loading: string;
+        loadFailed: string;
+        unavailable: string;
+        retry: string;
+        figures: {
+            composer: {
+                alt: string;
+            };
+            sharedTask: {
+                alt: string;
+                original: string;
+                copy: string;
+                total_one: string;
+                total_other: string;
+            };
+        };
+    };
+};

package/dist/i18n/messages/surfaces/settings.d.ts

@@ -20,6 +20,8 @@ export declare const settingsEn: {
         aboutDescription: string;
         apiKeys: string;
         apiKeysDescription: string;
+        guide: string;
+        guideDescription: string;
         apiKeysName: string;
         apiKeysCreate: string;
         apiKeysRevoke: string;
@@ -84,6 +86,8 @@ export declare const settingsEs: {
         aboutDescription: string;
         apiKeys: string;
         apiKeysDescription: string;
+        guide: string;
+        guideDescription: string;
         apiKeysName: string;
         apiKeysCreate: string;
         apiKeysRevoke: string;
@@ -148,6 +152,8 @@ export declare const settingsPt: {
         aboutDescription: string;
         apiKeys: string;
         apiKeysDescription: string;
+        guide: string;
+        guideDescription: string;
         apiKeysName: string;
         apiKeysCreate: string;
         apiKeysRevoke: string;
@@ -212,6 +218,8 @@ export declare const settingsIt: {
         aboutDescription: string;
         apiKeys: string;
         apiKeysDescription: string;
+        guide: string;
+        guideDescription: string;
         apiKeysName: string;
         apiKeysCreate: string;
         apiKeysRevoke: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@belonguniverseai/react-sdk",
-  "version": "0.6.31",
+  "version": "0.6.32",
   "description": "Belong — embeddable React AI assistant dock. Mount <BelongWidget> in your app tree with getToken dependency-injection auth.",
   "license": "UNLICENSED",
   "type": "module",

package/dist/component/flowDiagram-UKHOOZJN-CjSeviPw.js

@@ -1,19 +0,0 @@
-globalThis.process = globalThis.process || { env: {} }, globalThis.global = globalThis.global || globalThis;
-import "./chunk-Y2CYZVJY-CiUSrfaV.js";
-import "./src-CKo8cHWB.js";
-import "./chunk-I66GZJ75-CGsmSAKB.js";
-import "./chunk-NSK5VX7P-dusZw8pp.js";
-import "./chunk-ZIRB5QZD-DmX0SXRC.js";
-import "./chunk-W5SLKNZC-CRG_NQXu.js";
-import "./chunk-UBXNYLIW-CJHU4Dfa.js";
-import "./chunk-4I5QYGJK-CDPqoPOq.js";
-import "./chunk-WRU74C26-D8hrtupL.js";
-import "./chunk-QR6OTTB3-Bb0pFQ-m.js";
-import "./chunk-7BUUIJ7U-DJJ8ycYS.js";
-import "./chunk-7Z6QIM7H-BgV4nQ80.js";
-import "./chunk-J7OUQ5F2-D0GPh9LA.js";
-import "./chunk-5VM5RSS4-BuOiQaWo.js";
-import "./chunk-2GRJ4B5K-CBAw5kla.js";
-import "./chunk-XXDRQBXY-BP7ld7ls.js";
-import "./chunk-KBJHAD2P-_EJQ1rNN.js";
-export { n as diagram } from "./chunk-JQJVKLGR-D4zeU7rQ.js";