@fusion.dev/helix-headless 0.10.2 → 0.11.0

package/custom-elements.json

@@ -7287,6 +7287,10 @@
               "description": "The consumer's own markup.",
               "name": "content"
             },
+            {
+              "description": "The default wait, drawn only when nothing is slotted over it.",
+              "name": "indicator"
+            },
             {
               "description": "The status glyph beside a failure.",
               "name": "mark"
@@ -7329,6 +7333,10 @@
               "description": "Who said it.",
               "name": "avatar"
             },
+            {
+              "description": "The wait before the first token. Falls back to the typing indicator, so slotting nothing is what this has always done.",
+              "name": "indicator"
+            },
             {
               "description": "What it was said from: citations, documents, a retrieved page.",
               "name": "sources"
@@ -7445,6 +7453,17 @@
               },
               "description": "The status glyph, behind a seam so a tier can draw its own.\n\n`TONE_MARKS.danger` rather than a glyph chosen here: the library has one\nstatus vocabulary, `Callout`, `Toast.Item` and `Announcement` all read from\nit, and a reader meets these four marks in a passage, in a message and now\non a turn and has to read them as the same four things. It carries the\naccessible name with it, which is the half that matters: `danger` is the\nword the API uses and \"Error\" is the word a reader understands."
             },
+            {
+              "kind": "method",
+              "name": "renderIndicator",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "TemplateResult | typeof nothing"
+                }
+              },
+              "description": "The wait, for a consumer who slots nothing.\n\n**The slot and its fallback together, in a seam of its own**, because the\ntwo answer different people: the slot lets a consumer put their own\nindicator in the bubble, and the method lets the tier above replace what\nthey get when they do not, without reimplementing the template around it.\nHeadless draws a box and paints nothing on it."
+            },
             {
               "kind": "method",
               "name": "renderState",

package/dist/chat/message/chat-message.d.ts

@@ -24,6 +24,8 @@ import { nothing, type PropertyValues, type TemplateResult } from 'lit';
  * @slot - What was said.
  * @slot actions - What can be done with it: copy, retry, react.
  * @slot avatar - Who said it.
+ * @slot indicator - The wait before the first token. Falls back to the typing
+ * indicator, so slotting nothing is what this has always done.
  * @slot sources - What it was said from: citations, documents, a retrieved page.
  *
  * @event {HelixSendEvent} helix-send - Fired when the reader asks to send a failed message again, and cancelable.
@@ -32,6 +34,7 @@ import { nothing, type PropertyValues, type TemplateResult } from 'lit';
  * @csspart avatar - The leading slot's box.
  * @csspart body - What was said, and the line under it.
  * @csspart content - The consumer's own markup.
+ * @csspart indicator - The default wait, drawn only when nothing is slotted over it.
  * @csspart mark - The status glyph beside a failure.
  * @csspart message - The whole turn.
  * @csspart meta - The line under a turn: its time, its state, and its controls.
@@ -104,6 +107,16 @@ export declare class HelixHeadlessChatMessage extends HelixElement {
      * word the API uses and "Error" is the word a reader understands.
      */
     protected renderMark(): TemplateResult;
+    /**
+     * The wait, for a consumer who slots nothing.
+     *
+     * **The slot and its fallback together, in a seam of its own**, because the
+     * two answer different people: the slot lets a consumer put their own
+     * indicator in the bubble, and the method lets the tier above replace what
+     * they get when they do not, without reimplementing the template around it.
+     * Headless draws a box and paints nothing on it.
+     */
+    protected renderIndicator(): TemplateResult | typeof nothing;
     /**
      * What has happened to it, in words, and the way back from a failure.
      *

package/dist/chat/message/chat-message.js

@@ -61,6 +61,9 @@ let HelixHeadlessChatMessage = class HelixHeadlessChatMessage extends HelixEleme
       ${unsafeSVG(icon.content)}
     </svg>`;
     }
+    renderIndicator() {
+        return html `<slot name="indicator"><span part="indicator"></span></slot>`;
+    }
     renderState() {
         if (this.state === 'sending') {
             return html `<span part="state">${this.sendingLabel}</span>`;
@@ -94,7 +97,10 @@ let HelixHeadlessChatMessage = class HelixHeadlessChatMessage extends HelixEleme
         return html `<div part="message">
       <span part="avatar"><slot name="avatar"></slot></span>
       <div part="body">
-        <div part="content"><slot @slotchange=${this.handleFill}></slot></div>
+        <div part="content">
+          <slot @slotchange=${this.handleFill}></slot>
+          ${this.renderIndicator()}
+        </div>
         <div part="sources"><slot name="sources" @slotchange=${this.handleFill}></slot></div>
         <span part="meta"
           >${this.renderTime()} ${this.renderState()}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix-headless",
   "description": "Headless component tier. Structure, accessibility, state, and form participation. No styling.",
-  "version": "0.10.2",
+  "version": "0.11.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -45,14 +45,14 @@
   },
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
-    "@fusion.dev/helix-core": "0.10.2",
-    "@fusion.dev/helix-icons": "0.10.2",
+    "@fusion.dev/helix-core": "0.11.0",
+    "@fusion.dev/helix-icons": "0.11.0",
     "uqr": "^0.1.3"
   },
   "devDependencies": {
     "@custom-elements-manifest/analyzer": "^0.11.0",
-    "@fusion.dev/helix-cem": "0.10.2",
-    "@fusion.dev/helix-testing": "0.10.2",
+    "@fusion.dev/helix-cem": "0.11.0",
+    "@fusion.dev/helix-testing": "0.11.0",
     "@fusion.dev/scripts": "0.0.0-dev",
     "@happy-dom/global-registrator": "^20.0.0",
     "@lit-labs/ssr": "^3.3.0",

package/types/jsx.d.ts

@@ -17070,6 +17070,7 @@ export type CustomElements = {
    * - `(default)`: What was said.
    * - `actions`: What can be done with it: copy, retry, react.
    * - `avatar`: Who said it.
+   * - `indicator`: The wait before the first token. Falls back to the typing indicator, so slotting nothing is what this has always done.
    * - `sources`: What it was said from: citations, documents, a retrieved page.
    *
    * ## CSS Parts
@@ -17080,6 +17081,7 @@ export type CustomElements = {
    * - `avatar`: The leading slot's box.
    * - `body`: What was said, and the line under it.
    * - `content`: The consumer's own markup.
+   * - `indicator`: The default wait, drawn only when nothing is slotted over it.
    * - `mark`: The status glyph beside a failure.
    * - `message`: The whole turn.
    * - `meta`: The line under a turn: its time, its state, and its controls.
@@ -31282,6 +31284,7 @@ export type CustomElementsSolidJs = {
    * - `(default)`: What was said.
    * - `actions`: What can be done with it: copy, retry, react.
    * - `avatar`: Who said it.
+   * - `indicator`: The wait before the first token. Falls back to the typing indicator, so slotting nothing is what this has always done.
    * - `sources`: What it was said from: citations, documents, a retrieved page.
    *
    * ## CSS Parts
@@ -31292,6 +31295,7 @@ export type CustomElementsSolidJs = {
    * - `avatar`: The leading slot's box.
    * - `body`: What was said, and the line under it.
    * - `content`: The consumer's own markup.
+   * - `indicator`: The default wait, drawn only when nothing is slotted over it.
    * - `mark`: The status glyph beside a failure.
    * - `message`: The whole turn.
    * - `meta`: The line under a turn: its time, its state, and its controls.