@genesislcap/ai-assistant 14.409.0-FUI-2495.3 → 14.409.0-FUI-2495.4

package/dist/ai-assistant.api.json

@@ -3047,6 +3047,37 @@
               "isProtected": false,
               "isAbstract": false
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#chatConfigChanged:member(1)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "chatConfigChanged(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "chatConfigChanged"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#connectedCallback:member(1)",
@@ -4068,6 +4099,67 @@
               "isAbstract": false,
               "name": "showHaloChanged"
             },
+            {
+              "kind": "Property",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#showingSplash:member",
+              "docComment": "/**\n * Whether the splash overlay is currently showing (no messages and showSplash is enabled). Reflected as a boolean attribute on the host.\n */\n",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "showingSplash: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "boolean"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isReadonly": false,
+              "isOptional": false,
+              "releaseTag": "Beta",
+              "name": "showingSplash",
+              "propertyTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isStatic": false,
+              "isProtected": false,
+              "isAbstract": false
+            },
+            {
+              "kind": "Method",
+              "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#showingSplashChanged:member(1)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "showingSplashChanged(): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "void"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "releaseTag": "Beta",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "showingSplashChanged"
+            },
             {
               "kind": "Property",
               "canonicalReference": "@genesislcap/ai-assistant!FoundationAiAssistant#showLoadingIndicator:member",

package/dist/ai-assistant.d.ts

@@ -442,6 +442,8 @@ export declare class FoundationAiAssistant extends GenesisElement {
     showLoadingIndicator: boolean;
     /** Whether the settings panel is open. */
     settingsOpen: boolean;
+    /** Whether the splash overlay is currently showing (no messages and showSplash is enabled). Reflected as a boolean attribute on the host. */
+    showingSplash: boolean;
     private driver?;
     private loadingTimer;
     private unsubBus?;
@@ -460,6 +462,9 @@ export declare class FoundationAiAssistant extends GenesisElement {
     get visibleMessages(): ChatMessage[];
     connectedCallback(): void;
     disconnectedCallback(): void;
+    chatConfigChanged(): void;
+    showingSplashChanged(): void;
+    private syncShowingSplash;
     stateChanged(): void;
     messagesChanged(): void;
     showLoadingIndicatorChanged(): void;

package/dist/dts/main/main.d.ts

@@ -54,6 +54,8 @@ export declare class FoundationAiAssistant extends GenesisElement {
     showLoadingIndicator: boolean;
     /** Whether the settings panel is open. */
     settingsOpen: boolean;
+    /** Whether the splash overlay is currently showing (no messages and showSplash is enabled). Reflected as a boolean attribute on the host. */
+    showingSplash: boolean;
     private driver?;
     private loadingTimer;
     private unsubBus?;
@@ -72,6 +74,9 @@ export declare class FoundationAiAssistant extends GenesisElement {
     get visibleMessages(): ChatMessage[];
     connectedCallback(): void;
     disconnectedCallback(): void;
+    chatConfigChanged(): void;
+    showingSplashChanged(): void;
+    private syncShowingSplash;
     stateChanged(): void;
     messagesChanged(): void;
     showLoadingIndicatorChanged(): void;

package/dist/dts/main/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/main/main.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/main/main.ts"],"names":[],"mappings":"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"}

package/dist/dts/main/main.styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.styles.d.ts","sourceRoot":"","sources":["../../../src/main/main.styles.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,MAAM,iDAoflB,CAAC"}
+{"version":3,"file":"main.styles.d.ts","sourceRoot":"","sources":["../../../src/main/main.styles.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,MAAM,iDAqgBlB,CAAC"}

package/dist/dts/main/main.template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.template.d.ts","sourceRoot":"","sources":["../../../src/main/main.template.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,QAAQ,CAAC;AA6DpD,gBAAgB;AAChB,eAAO,MAAM,6BAA6B,GACxC,oBAAoB,MAAM,KACzB,YAAY,CAAC,qBAAqB,CAiWpC,CAAC"}
+{"version":3,"file":"main.template.d.ts","sourceRoot":"","sources":["../../../src/main/main.template.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,QAAQ,CAAC;AA6DpD,gBAAgB;AAChB,eAAO,MAAM,6BAA6B,GACxC,oBAAoB,MAAM,KACzB,YAAY,CAAC,qBAAqB,CAqWpC,CAAC"}

package/dist/esm/main/main.js

@@ -53,6 +53,8 @@ let FoundationAiAssistant = FoundationAiAssistant_1 = class FoundationAiAssistan
         this.showLoadingIndicator = false;
         /** Whether the settings panel is open. */
         this.settingsOpen = false;
+        /** Whether the splash overlay is currently showing (no messages and showSplash is enabled). Reflected as a boolean attribute on the host. */
+        this.showingSplash = false;
         this.haloStartPublished = false;
         this.showHalo = 'no';
     }
@@ -175,6 +177,7 @@ let FoundationAiAssistant = FoundationAiAssistant_1 = class FoundationAiAssistan
                 this.applyState(state);
             });
         }
+        this.syncShowingSplash();
         this.fetchSuggestions();
         logger.debug('FoundationAiAssistant connected');
     }
@@ -187,6 +190,24 @@ let FoundationAiAssistant = FoundationAiAssistant_1 = class FoundationAiAssistan
         this.unsubBus = undefined;
         this.driver = undefined;
     }
+    chatConfigChanged() {
+        this.syncShowingSplash();
+    }
+    showingSplashChanged() {
+        if (this.showingSplash) {
+            this.setAttribute('showing-splash', '');
+        }
+        else {
+            this.removeAttribute('showing-splash');
+        }
+    }
+    // Sets the observable which reflects as a boolean attribute on the host via showingSplashChanged.
+    // Must be an attribute on the host (not a shadow DOM class) so consumer CSS can target slotted
+    // light DOM content — shadow DOM classes are not visible to external stylesheets.
+    syncShowingSplash() {
+        var _a;
+        this.showingSplash = !!((_a = this.chatConfig.ui) === null || _a === void 0 ? void 0 : _a.showSplash) && this.messages.length === 0;
+    }
     stateChanged() {
         this.syncShowHalo();
     }
@@ -206,6 +227,7 @@ let FoundationAiAssistant = FoundationAiAssistant_1 = class FoundationAiAssistan
             }
         }
         this.syncShowHalo();
+        this.syncShowingSplash();
         // Publish halo-start whenever a new toolCalls message arrives.
         if (this.showHalo !== 'no' && ((_a = this.enabledAnimations) === null || _a === void 0 ? void 0 : _a.includes('halo'))) {
             const last = this.messages[this.messages.length - 1];
@@ -594,6 +616,9 @@ __decorate([
 __decorate([
     observable
 ], FoundationAiAssistant.prototype, "settingsOpen", void 0);
+__decorate([
+    observable
+], FoundationAiAssistant.prototype, "showingSplash", void 0);
 __decorate([
     observable
 ], FoundationAiAssistant.prototype, "showHalo", void 0);

package/dist/esm/main/main.styles.js

@@ -191,6 +191,23 @@ export const styles = css `
     }
   }
 
+  .splash-wrapper {
+    position: absolute;
+    inset: 0;
+    z-index: 10;
+    overflow: hidden;
+  }
+
+  :host(:not([showing-splash])) .splash-wrapper {
+    pointer-events: none;
+  }
+
+  ::slotted([slot='splash']) {
+    display: block;
+    width: 100%;
+    height: 100%;
+  }
+
   .messages {
     flex: 1;
     overflow-y: auto;

package/dist/esm/main/main.template.js

@@ -165,6 +165,10 @@ export const FoundationAiAssistantTemplate = (designSystemPrefix) => {
             `)}
         `)}
 
+      <div class="splash-wrapper" part="splash">
+        <slot name="splash"></slot>
+      </div>
+
       <div class="messages" part="messages">
 
         ${repeat((x) => x.visibleMessages, html `

package/docs/multi-agent-architecture.md

@@ -196,3 +196,71 @@ Option 1 + 2 together cover most real cases without requiring suspend/resume inf
 - [ ] Add `showAgentSwitchIndicator` to `ChatConfig` and implement the system-event message type + divider template
 - [ ] Write specialist configs for each new domain (allocations, settlement, etc.)
 - [ ] Decide on mid-flow handoff strategy (suppress re-routing vs. fallback tools vs. clarify)
+
+---
+
+## Splash slot
+
+A named slot (`slot="splash"`) lets consumers render a branded intro screen over the chat before any messages exist. It disappears once the first message is sent.
+
+### Enabling it
+
+```typescript
+chatConfig: {
+  ui: {
+    showSplash: true,
+  }
+}
+```
+
+The component reflects a `showing-splash` boolean attribute on the host while the splash is active (no messages). It is absent once the conversation starts.
+
+### Basic usage
+
+```html
+<foundation-ai-assistant :chatConfig="${() => chatConfig}">
+  <div slot="splash" class="my-splash">
+    <h2>Hello, how can I help?</h2>
+  </div>
+</foundation-ai-assistant>
+```
+
+### Animated exit
+
+The splash wrapper stays in the DOM when dismissed (it is never removed), so CSS transitions and keyframe animations work on exit. Use the `showing-splash` attribute as the CSS hook:
+
+```css
+.my-splash {
+  width: 100%;
+  height: 100%;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  transition: opacity 0.4s ease, transform 0.4s ease;
+}
+
+/* Dismissed state — triggers the exit transition */
+foundation-ai-assistant:not([showing-splash]) .my-splash {
+  opacity: 0;
+  transform: translateY(-8px);
+  pointer-events: none;
+}
+```
+
+Keyframe animations work the same way — add the animation class when `showing-splash` is present, remove it (or swap to an exit animation class) when it is absent. Because the element remains in the DOM, the exit animation plays in full before the element becomes visually irrelevant.
+
+### Container queries
+
+The component does not impose a container context on the splash wrapper. If you need the splash content to respond to the panel size, wrap your slotted element in its own container:
+
+```html
+<div slot="splash" style="container-type: inline-size; width: 100%; height: 100%;">
+  <div class="my-splash-content">...</div>
+</div>
+```
+
+```css
+@container (max-width: 400px) {
+  .my-splash-content { font-size: 0.9em; }
+}
+```

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/ai-assistant",
   "description": "Genesis AI Assistant micro-frontend",
-  "version": "14.409.0-FUI-2495.3",
+  "version": "14.409.0-FUI-2495.4",
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
   "types": "dist/ai-assistant.d.ts",
@@ -59,23 +59,23 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "14.409.0-FUI-2495.3",
-    "@genesislcap/genx": "14.409.0-FUI-2495.3",
-    "@genesislcap/rollup-builder": "14.409.0-FUI-2495.3",
-    "@genesislcap/ts-builder": "14.409.0-FUI-2495.3",
-    "@genesislcap/uvu-playwright-builder": "14.409.0-FUI-2495.3",
-    "@genesislcap/vite-builder": "14.409.0-FUI-2495.3",
-    "@genesislcap/webpack-builder": "14.409.0-FUI-2495.3",
+    "@genesislcap/foundation-testing": "14.409.0-FUI-2495.4",
+    "@genesislcap/genx": "14.409.0-FUI-2495.4",
+    "@genesislcap/rollup-builder": "14.409.0-FUI-2495.4",
+    "@genesislcap/ts-builder": "14.409.0-FUI-2495.4",
+    "@genesislcap/uvu-playwright-builder": "14.409.0-FUI-2495.4",
+    "@genesislcap/vite-builder": "14.409.0-FUI-2495.4",
+    "@genesislcap/webpack-builder": "14.409.0-FUI-2495.4",
     "@types/dompurify": "^3.0.5",
     "@types/marked": "^5.0.2"
   },
   "dependencies": {
-    "@genesislcap/foundation-ai": "14.409.0-FUI-2495.3",
-    "@genesislcap/foundation-logger": "14.409.0-FUI-2495.3",
-    "@genesislcap/foundation-ui": "14.409.0-FUI-2495.3",
-    "@genesislcap/foundation-utils": "14.409.0-FUI-2495.3",
-    "@genesislcap/rapid-design-system": "14.409.0-FUI-2495.3",
-    "@genesislcap/web-core": "14.409.0-FUI-2495.3",
+    "@genesislcap/foundation-ai": "14.409.0-FUI-2495.4",
+    "@genesislcap/foundation-logger": "14.409.0-FUI-2495.4",
+    "@genesislcap/foundation-ui": "14.409.0-FUI-2495.4",
+    "@genesislcap/foundation-utils": "14.409.0-FUI-2495.4",
+    "@genesislcap/rapid-design-system": "14.409.0-FUI-2495.4",
+    "@genesislcap/web-core": "14.409.0-FUI-2495.4",
     "dompurify": "^3.3.1",
     "marked": "^17.0.3"
   },
@@ -87,5 +87,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "e45ebf76f89b1217749fed0261f118b952c789bf"
+  "gitHead": "776a61e07afe56f5e9521ccee55034385cc03d44"
 }

package/src/main/main.styles.ts

@@ -197,6 +197,23 @@ export const styles = css`
     }
   }
 
+  .splash-wrapper {
+    position: absolute;
+    inset: 0;
+    z-index: 10;
+    overflow: hidden;
+  }
+
+  :host(:not([showing-splash])) .splash-wrapper {
+    pointer-events: none;
+  }
+
+  ::slotted([slot='splash']) {
+    display: block;
+    width: 100%;
+    height: 100%;
+  }
+
   .messages {
     flex: 1;
     overflow-y: auto;

package/src/main/main.template.ts

@@ -207,6 +207,10 @@ export const FoundationAiAssistantTemplate = (
         `,
       )}
 
+      <div class="splash-wrapper" part="splash">
+        <slot name="splash"></slot>
+      </div>
+
       <div class="messages" part="messages">
 
         ${repeat(

package/src/main/main.ts

@@ -102,6 +102,8 @@ export class FoundationAiAssistant extends GenesisElement {
   @observable showLoadingIndicator = false;
   /** Whether the settings panel is open. */
   @observable settingsOpen = false;
+  /** Whether the splash overlay is currently showing (no messages and showSplash is enabled). Reflected as a boolean attribute on the host. */
+  @observable showingSplash = false;
 
   private driver?: AiDriver;
   private loadingTimer: ReturnType<typeof setTimeout> | undefined;
@@ -241,6 +243,7 @@ export class FoundationAiAssistant extends GenesisElement {
       });
     }
 
+    this.syncShowingSplash();
     this.fetchSuggestions();
     logger.debug('FoundationAiAssistant connected');
   }
@@ -254,6 +257,25 @@ export class FoundationAiAssistant extends GenesisElement {
     this.driver = undefined;
   }
 
+  chatConfigChanged() {
+    this.syncShowingSplash();
+  }
+
+  showingSplashChanged() {
+    if (this.showingSplash) {
+      this.setAttribute('showing-splash', '');
+    } else {
+      this.removeAttribute('showing-splash');
+    }
+  }
+
+  // Sets the observable which reflects as a boolean attribute on the host via showingSplashChanged.
+  // Must be an attribute on the host (not a shadow DOM class) so consumer CSS can target slotted
+  // light DOM content — shadow DOM classes are not visible to external stylesheets.
+  private syncShowingSplash() {
+    this.showingSplash = !!this.chatConfig.ui?.showSplash && this.messages.length === 0;
+  }
+
   stateChanged() {
     this.syncShowHalo();
   }
@@ -272,6 +294,7 @@ export class FoundationAiAssistant extends GenesisElement {
       }
     }
     this.syncShowHalo();
+    this.syncShowingSplash();
     // Publish halo-start whenever a new toolCalls message arrives.
     if (this.showHalo !== 'no' && this.enabledAnimations?.includes('halo')) {
       const last = this.messages[this.messages.length - 1];