@singlebase/elements 0.7.0 → 0.9.0

package/dist/chat-messages.d.ts

@@ -52,6 +52,10 @@ export interface SinglebaseChatMessages {
     restore: string;
     minimize: string;
     exportHeading: string;
+    viewOptions: string;
+    viewHeading: string;
+    viewFollowups: string;
+    viewSources: string;
     exportMarkdown: string;
     exportJson: string;
     exportText: string;
@@ -80,6 +84,7 @@ export interface SinglebaseChatMessages {
     sourceLabel: string;
     openSource: string;
     citedPassage: string;
+    passageCount: string;
     copyReference: string;
     alsoCited: string;
     close: string;

package/dist/chat.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./chat-ezUmd9II.cjs");Object.defineProperty(exports,"SinglebaseChat",{enumerable:!0,get:()=>e.SinglebaseChat});exports.adaptBlocks=e.adaptBlocks;exports.citedNumbers=e.citedNumbers;exports.defaultChatMessages=e.defaultChatMessages;exports.describeSource=e.describeSource;exports.parseInline=e.parseInline;exports.parseMarkdown=e.parseMarkdown;exports.resolveChatMessages=e.resolveChatMessages;exports.settleStreaming=e.settleStreaming;exports.splitFollowups=e.splitFollowups;exports.svgDataUrl=e.svgDataUrl;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./chat-Bj6DrOaW.cjs");Object.defineProperty(exports,"SinglebaseChat",{enumerable:!0,get:()=>e.SinglebaseChat});exports.adaptBlocks=e.adaptBlocks;exports.citedNumbers=e.citedNumbers;exports.defaultChatMessages=e.defaultChatMessages;exports.describeSource=e.describeSource;exports.parseInline=e.parseInline;exports.parseMarkdown=e.parseMarkdown;exports.resolveChatMessages=e.resolveChatMessages;exports.settleStreaming=e.settleStreaming;exports.splitFollowups=e.splitFollowups;exports.svgDataUrl=e.svgDataUrl;
 //# sourceMappingURL=chat.cjs.map

package/dist/chat.js

@@ -1,4 +1,4 @@
-import { S as e, a as r, c as t, d as l, b as o, p, e as d, r as g, s as i, f as c, g as n } from "./chat-BH_3e1jT.js";
+import { S as e, a as r, c as t, d as l, b as o, p, e as d, r as g, s as i, f as c, g as n } from "./chat-DNiqYF6F.js";
 export {
   e as SinglebaseChat,
   r as adaptBlocks,

package/dist/elements/authui-account.d.ts

@@ -38,7 +38,6 @@ export declare class SinglebaseAccountScreen extends SinglebaseFormBase {
     private accessor emailCode;
     private accessor emailError;
     private accessor emailSaved;
-    private accessor curPass;
     private accessor newPass;
     private accessor confirmPass;
     private settingsCtl;

package/dist/elements/authui-buttons.d.ts

@@ -20,7 +20,7 @@ export declare class SinglebaseAuthButtons extends SinglebaseFormBase {
     accessor intent: OAuthIntent;
     /** link: the provider to connect to the signed-in account. */
     accessor provider: string;
-    /** link: display name, when it differs from the provider id. */
+    /** link: label override. By default it's the project's `provider_name`. */
     accessor providerName: string;
     /** Inside a card that already supplies chrome, drop this element's own. */
     accessor embedded: boolean;

package/dist/elements/authui.d.ts

@@ -108,7 +108,6 @@ export declare class SinglebaseAuthScreen extends SinglebaseElementBase {
     private accessor emailError;
     private accessor passError;
     private accessor newPassError;
-    private accessor attempts;
     private accessor needsMfaCode;
     private settingsCtl;
     private bridge;
@@ -153,8 +152,16 @@ export declare class SinglebaseAuthScreen extends SinglebaseElementBase {
     private get redirectParam();
     /** Navigates to the post-login destination if there is a safe one. */
     private followRedirect;
+    /**
+     * Only the OAuth return counts: `?access_code=`, `?error=oauth_denied` or
+     * `?oauth_error=<CODE>`. Any other `?error=` belongs to the host page.
+     */
     private get isOAuthCallback();
     private accessor callbackDone;
+    /** Where the OAuth return stands once its URL has been cleaned. */
+    private accessor callbackPhase;
+    /** "{name} is now connected", after a provider link completes. */
+    private accessor linkNotice;
     /** Strips the provider's parameters so a reload cannot replay the exchange. */
     private cleanCallbackUrl;
     /**
@@ -173,6 +180,17 @@ export declare class SinglebaseAuthScreen extends SinglebaseElementBase {
     private setScreen;
     private withLoading;
     private describeError;
+    /**
+     * The message for a code the backend sent back on the redirect. The code is
+     * only ever looked up, never shown, so a crafted URL can't put text on the page.
+     */
+    private describeOAuthError;
+    /** The requirements hint under a field that creates a password. */
+    private get passwordHint();
+    /** The placeholder for a field that creates a password. */
+    private get newPasswordHint();
+    /** The project's password rules, checked wherever a password is created. */
+    private checkNewPassword;
     private get codeValue();
     private onSubmit;
     private abortController;
@@ -206,6 +224,12 @@ export declare class SinglebaseAuthScreen extends SinglebaseElementBase {
     private onInterstitialSignOut;
     /** The Terms/Privacy consent line, rendered only when the host supplies a link. */
     private renderConsent;
+    /**
+     * The OAuth return is handled after the first render, not during it: state
+     * set while rendering is dropped, so the widget wouldn't leave the callback
+     * screen once the URL is cleaned.
+     */
+    protected updated(changed: PropertyValues): void;
     protected render(): typeof nothing | import("lit").TemplateResult<1>;
 }
 declare global {

package/dist/elements/chat.d.ts

@@ -23,6 +23,8 @@ export type ChatClient = {
 export interface ChatSummary {
     _id: string;
     title: string | null;
+    /** The caller-chosen key this chat can also be opened by. */
+    key?: string | null;
     bookmarked?: boolean;
     message_count?: number;
     _created_at?: string;
@@ -97,6 +99,7 @@ export interface ChatConfig {
     client: ChatClient | null;
     /** Opens this saved chat. */
     chatId: string;
+    chatKey: string;
     embed: ChatEmbed;
     mode: ChatMode;
     format: ChatFormat;
@@ -135,6 +138,7 @@ export interface ChatConfig {
     saveAttachments: boolean;
     showFollowups: boolean;
     showSources: boolean;
+    allowViewOptions: boolean;
     showNewChat: boolean;
     showBookmarked: boolean;
     allowSearch: boolean;
@@ -151,6 +155,7 @@ export interface ChatConfig {
 /** A readable view of whatever shape the server recorded for a source. */
 export declare function describeSource(source: Record<string, unknown>, n: number): {
     n: number;
+    doc: string;
     title: string;
     section: string;
     path: string;
@@ -159,6 +164,20 @@ export declare function describeSource(source: Record<string, unknown>, n: numbe
     text: string;
     score: number | null;
 };
+type DescribedSource = ReturnType<typeof describeSource>;
+/** One document and the passages of it that a reply used. */
+export interface SourceGroup {
+    doc: string;
+    /** The first passage: it supplies the title, path and preview. */
+    first: DescribedSource;
+    items: DescribedSource[];
+}
+/**
+ * Groups passages by the document they come from, keeping first-seen order.
+ * A file split into passages comes back as several numbered sources; shown one
+ * by one it looks like the same document repeated.
+ */
+export declare function groupSources(sources: DescribedSource[]): SourceGroup[];
 /**
  * An AI chat workspace backed by the `llm.*` service.
  *
@@ -204,9 +223,9 @@ export declare class SinglebaseChat extends LitElement {
      */
     accessor docsets: string | string[];
     /**
-     * How attached files reach the service: `retrieval` (this message only;
-     * works with every service version) or `payload` (as `attachments`, which
-     * the service keeps on the chat for later turns).
+     * How attached files reach the service: `payload` (as `attachments`, which
+     * the service keeps on the chat for later turns) or `retrieval` (with this
+     * message only).
      */
     accessor attachmentsMode: "retrieval" | "payload";
     /** With attachments-mode="payload": keep attached files on the chat. */
@@ -221,6 +240,11 @@ export declare class SinglebaseChat extends LitElement {
     accessor showBookmarked: boolean;
     /** Show the follow-up questions under the latest reply. */
     accessor showFollowups: boolean;
+    /**
+     * Adds a header menu where the reader can hide suggested questions and
+     * sources for a cleaner view. Their choice is remembered in this browser.
+     */
+    accessor allowViewOptions: boolean;
     /** The search box in the chat list. */
     accessor allowSearch: boolean;
     /** Replace the provisional title with a model-written one after the first reply. */
@@ -245,6 +269,12 @@ export declare class SinglebaseChat extends LitElement {
     accessor showTitle: boolean;
     /** Opens this chat on load. */
     accessor chatIdAttr: string;
+    /**
+     * A key of your own for this conversation, unique per signed-in user. The
+     * chat with this key is opened if there is one; otherwise the first message
+     * creates it, so the same key reopens it later. `chat-id` wins if both are set.
+     */
+    accessor chatKey: string;
     /** Used in placeholders, exports and labels. Never shown above messages. */
     accessor assistantName: string;
     accessor logoUrl: string;
@@ -254,7 +284,9 @@ export declare class SinglebaseChat extends LitElement {
     accessor eyebrow: string | undefined;
     /**
      * Suggested prompts: `|`-separated in markup, an array in JavaScript.
-     * `"none"` or `[]` shows no suggestions.
+     * `"none"` or `[]` shows no suggestions. `"auto"` asks the service for
+     * starter questions drawn from the chat's context (`retrieval`, `docsets`
+     * and saved attachments); they're stored on the chat and reused on reload.
      */
     accessor prompts: string | (string | ChatPrompt)[];
     accessor bubbleText: string;
@@ -306,6 +338,9 @@ export declare class SinglebaseChat extends LitElement {
     private accessor width;
     private accessor panel;
     private accessor menuOpen;
+    private accessor viewOpen;
+    /** What the reader chose to hide, when `allow-view-options` lets them. */
+    private accessor viewHidden;
     private accessor editingKey;
     private accessor editDraft;
     private accessor editingTitle;
@@ -335,10 +370,22 @@ export declare class SinglebaseChat extends LitElement {
     private renamed;
     private observer;
     private observed;
+    private resizeTimer;
+    private shownPassage;
     private media;
     private focusNext;
     private bubbleScheduled;
     private pendingChatId;
+    /** Starter questions the service generated for this chat's context. */
+    private accessor starterList;
+    private accessor startersLoading;
+    /** The key the open conversation is created under, until the user leaves it. */
+    private boundKey;
+    /** The open chat was prepared but has no messages yet. */
+    private prepared;
+    private syncedKey;
+    private syncSignature;
+    private syncRun;
     get msg(): SinglebaseChatMessages;
     /** An explicit `.client`, else the page default. */
     get resolvedClient(): ChatClient | null;
@@ -346,6 +393,8 @@ export declare class SinglebaseChat extends LitElement {
     get chatId(): string | null;
     /** The open conversation's messages. */
     get thread(): readonly ChatMessage[];
+    /** The starter questions from `prompts="auto"`, if any. */
+    get starters(): readonly string[];
     /** `format`, falling back to the default for anything unknown. */
     /** `docsets` as a clean list of ids. */
     private get docsetIds();
@@ -386,6 +435,26 @@ export declare class SinglebaseChat extends LitElement {
     newChat(): void;
     /** Opens a saved conversation. */
     openChat(id: string): Promise<void>;
+    /** Suggested questions under answers: the page's setting, then the reader's. */
+    private get followupsVisible();
+    /** Source cards and the "searched" row: the page's setting, then the reader's. */
+    private get sourcesVisible();
+    private toggleView;
+    /** Puts a chat from `llm.get_chat` (or `llm.prepare_chat`) on screen. */
+    private showChat;
+    private get wantsStarters();
+    /** The user moved to another conversation: stop tying messages to the key. */
+    private leaveKeyedChat;
+    /** Docsets first, then the page's own retrieval entries. */
+    private baseRetrieval;
+    /**
+     * Opens the chat for `chat-key`, and with `prompts="auto"` prepares the chat
+     * with its context so the service returns stored starter questions.
+     *
+     * It runs when the key or the context changes. A change of context alone
+     * never replaces a conversation that already has messages.
+     */
+    private syncKeyedChat;
     /** Sends a message; with no argument, sends the composer's text. */
     send(text?: string): Promise<void>;
     /** Stops waiting for, or revealing, the current reply. */
@@ -465,6 +534,8 @@ export declare class SinglebaseChat extends LitElement {
     private renderSidebar;
     private renderThreadRow;
     private renderHeader;
+    /** Lets the reader hide suggested questions and sources for a cleaner view. */
+    private renderViewMenu;
     private renderExportMenu;
     /** The suggestion cards. `[]` or `"none"` shows none; unset uses the mode's. */
     private promptList;
@@ -491,3 +562,4 @@ declare global {
         "singlebase-chat": SinglebaseChat;
     }
 }
+export {};

package/dist/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./authui-display-CMVHTNFz.cjs"),r=require("./uploader-COP8PkJ6.cjs"),s=require("@singlebase/core"),a=require("./files-4T62wkwj.cjs"),t=require("./chat-ezUmd9II.cjs");exports.AuthController=e.AuthController;exports.SettingsController=e.SettingsController;Object.defineProperty(exports,"SinglebaseAccountScreen",{enumerable:!0,get:()=>e.SinglebaseAccountScreen});Object.defineProperty(exports,"SinglebaseAuthButtons",{enumerable:!0,get:()=>e.SinglebaseAuthButtons});Object.defineProperty(exports,"SinglebaseAuthDisplay",{enumerable:!0,get:()=>e.SinglebaseAuthDisplay});Object.defineProperty(exports,"SinglebaseAuthGuard",{enumerable:!0,get:()=>e.SinglebaseAuthGuard});Object.defineProperty(exports,"SinglebaseAuthScreen",{enumerable:!0,get:()=>e.SinglebaseAuthScreen});exports.defaultMessages=e.defaultMessages;exports.fullNameOf=e.fullNameOf;exports.initialsOf=e.initialsOf;exports.isGuestScreen=e.isGuestScreen;exports.isProtectedScreen=e.isProtectedScreen;exports.isScreen=e.isScreen;exports.resolveMessages=e.resolveMessages;Object.defineProperty(exports,"SinglebaseUploader",{enumerable:!0,get:()=>r.SinglebaseUploader});exports.inspectFile=r.inspectFile;exports.isInspectable=r.isInspectable;exports.resolveRedirectTarget=r.resolveRedirectTarget;Object.defineProperty(exports,"OPERATORS",{enumerable:!0,get:()=>s.OPERATORS});Object.defineProperty(exports,"matchesPredicate",{enumerable:!0,get:()=>s.matchesPredicate});Object.defineProperty(exports,"validatePredicate",{enumerable:!0,get:()=>s.validatePredicate});exports.TOKEN_DEFAULTS=a.TOKEN_DEFAULTS;exports.defaultUploadMessages=a.defaultUploadMessages;exports.resolveUploadMessages=a.resolveUploadMessages;Object.defineProperty(exports,"SinglebaseChat",{enumerable:!0,get:()=>t.SinglebaseChat});exports.adaptBlocks=t.adaptBlocks;exports.citedNumbers=t.citedNumbers;exports.defaultChatMessages=t.defaultChatMessages;exports.describeSource=t.describeSource;exports.parseInline=t.parseInline;exports.parseMarkdown=t.parseMarkdown;exports.resolveChatMessages=t.resolveChatMessages;exports.settleStreaming=t.settleStreaming;exports.splitFollowups=t.splitFollowups;exports.svgDataUrl=t.svgDataUrl;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./authui-display-C2o9gApg.cjs"),r=require("./uploader-C57vgFME.cjs"),s=require("@singlebase/core"),a=require("./files-4T62wkwj.cjs"),t=require("./chat-Bj6DrOaW.cjs");exports.AuthController=e.AuthController;exports.SettingsController=e.SettingsController;Object.defineProperty(exports,"SinglebaseAccountScreen",{enumerable:!0,get:()=>e.SinglebaseAccountScreen});Object.defineProperty(exports,"SinglebaseAuthButtons",{enumerable:!0,get:()=>e.SinglebaseAuthButtons});Object.defineProperty(exports,"SinglebaseAuthDisplay",{enumerable:!0,get:()=>e.SinglebaseAuthDisplay});Object.defineProperty(exports,"SinglebaseAuthGuard",{enumerable:!0,get:()=>e.SinglebaseAuthGuard});Object.defineProperty(exports,"SinglebaseAuthScreen",{enumerable:!0,get:()=>e.SinglebaseAuthScreen});exports.defaultMessages=e.defaultMessages;exports.fullNameOf=e.fullNameOf;exports.initialsOf=e.initialsOf;exports.isGuestScreen=e.isGuestScreen;exports.isProtectedScreen=e.isProtectedScreen;exports.isScreen=e.isScreen;exports.resolveMessages=e.resolveMessages;Object.defineProperty(exports,"SinglebaseUploader",{enumerable:!0,get:()=>r.SinglebaseUploader});exports.inspectFile=r.inspectFile;exports.isInspectable=r.isInspectable;exports.resolveRedirectTarget=r.resolveRedirectTarget;Object.defineProperty(exports,"OPERATORS",{enumerable:!0,get:()=>s.OPERATORS});Object.defineProperty(exports,"matchesPredicate",{enumerable:!0,get:()=>s.matchesPredicate});Object.defineProperty(exports,"validatePredicate",{enumerable:!0,get:()=>s.validatePredicate});exports.TOKEN_DEFAULTS=a.TOKEN_DEFAULTS;exports.defaultUploadMessages=a.defaultUploadMessages;exports.resolveUploadMessages=a.resolveUploadMessages;Object.defineProperty(exports,"SinglebaseChat",{enumerable:!0,get:()=>t.SinglebaseChat});exports.adaptBlocks=t.adaptBlocks;exports.citedNumbers=t.citedNumbers;exports.defaultChatMessages=t.defaultChatMessages;exports.describeSource=t.describeSource;exports.parseInline=t.parseInline;exports.parseMarkdown=t.parseMarkdown;exports.resolveChatMessages=t.resolveChatMessages;exports.settleStreaming=t.settleStreaming;exports.splitFollowups=t.splitFollowups;exports.svgDataUrl=t.svgDataUrl;
 //# sourceMappingURL=index.cjs.map

package/dist/index.js

@@ -1,8 +1,8 @@
-import { A as a, S as r, a as t, b as l, c as i, d as o, e as n, f as c, g as S, i as d, h as g, j as p, k as u, r as f } from "./authui-display-BM_F3-5e.js";
-import { S as h, i as m, a as A, r as M } from "./uploader-tdMU9Gxv.js";
+import { A as a, S as r, a as t, b as l, c as i, d as o, e as n, f as c, g as S, i as d, h as g, j as p, k as u, r as f } from "./authui-display-CRUABt43.js";
+import { S as h, i as m, a as A, r as M } from "./uploader-Cz9yfzfV.js";
 import { OPERATORS as x, matchesPredicate as C, validatePredicate as O } from "@singlebase/core";
 import { T as U, d as P, r as k } from "./files-DS-H-3yN.js";
-import { S as E, a as F, c as N, d as R, b as w, p as B, e as G, r as I, s as j, f as y, g as K } from "./chat-BH_3e1jT.js";
+import { S as E, a as F, c as N, d as R, b as w, p as B, e as G, r as I, s as j, f as y, g as K } from "./chat-DNiqYF6F.js";
 export {
   a as AuthController,
   x as OPERATORS,

package/dist/messages.d.ts

@@ -45,9 +45,16 @@ export interface SinglebaseAuthMessages {
     passwordPlaceholder: string;
     newPasswordLabel: string;
     newPasswordPlaceholder: string;
+    newPasswordPlaceholderPlain: string;
+    passwordRulesLabel: string;
+    passwordRuleLength: string;
+    passwordRuleMinLength: string;
+    passwordRuleLowercase: string;
+    passwordRuleUppercase: string;
+    passwordRuleNumber: string;
+    passwordRuleSymbol: string;
     confirmPasswordLabel: string;
     confirmPasswordPlaceholder: string;
-    currentPasswordLabel: string;
     firstNameLabel: string;
     firstNamePlaceholder: string;
     lastNameLabel: string;
@@ -63,7 +70,6 @@ export interface SinglebaseAuthMessages {
     footActionSignUp: string;
     resendQuestion: string;
     resendCta: string;
-    oauthPrimaryLabel: string;
     oauthContinueWith: string;
     blockedTitleDisabled: string;
     blockedTitleUnavailable: string;
@@ -115,10 +121,28 @@ export interface SinglebaseAuthMessages {
     codeSentNeutral: string;
     invalidEmailError: string;
     requiredError: string;
-    passwordMinError: string;
+    passwordTooShortError: string;
+    passwordTooLongError: string;
+    passwordNeedsLowercaseError: string;
+    passwordNeedsUppercaseError: string;
+    passwordNeedsNumberError: string;
+    passwordNeedsSymbolError: string;
+    invalidPasswordMessage: string;
     passwordMatchError: string;
+    invalidCodeError: string;
+    invalidCredentialsError: string;
+    codeResentNotice: string;
+    confirmNewPasswordLabel: string;
+    notSignedInNote: string;
+    connectProviderLabel: string;
+    digitLabel: string;
+    accountCreatedNotice: string;
+    inviteCodeLabel: string;
+    submittingStatus: string;
+    doneStatus: string;
     codeIncompleteError: string;
     invalidPhoneError: string;
+    firstNameRequiredError: string;
     notYetSupported: string;
     alreadySignedInTitle: string;
     alreadySignedInSub: string;
@@ -140,6 +164,13 @@ export interface SinglebaseAuthMessages {
     oauthCallbackTitle: string;
     oauthCallbackSub: string;
     oauthDenied: string;
+    oauthRetryMessage: string;
+    oauthUnavailableMessage: string;
+    oauthVerifiedEmailMessage: string;
+    providerConnectedNotice: string;
+    signInToLinkMessage: string;
+    providerAlreadyLinkedMessage: string;
+    oauthNoAccountMessage: string;
 }
 export declare const defaultMessages: SinglebaseAuthMessages;
 export declare function resolveMessages(overrides?: Partial<SinglebaseAuthMessages>): SinglebaseAuthMessages;