@umbraco-ai/core 17.4.0-rc.4 → 17.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umbraco-ai/core",
-  "version": "17.4.0-rc.4",
+  "version": "17.4.0",
   "type": "module",
   "types": "./types/umbraco-ai-public-types.d.ts",
   "files": [

package/types/umbraco-ai-public-types.d.ts

@@ -5,6 +5,7 @@ import type { ManifestApi } from '@umbraco-cms/backoffice/extension-api';
 import type { ManifestBase } from '@umbraco-cms/backoffice/extension-api';
 import type { ManifestMenuItem } from '@umbraco-cms/backoffice/menu';
 import type { ManifestRepository } from '@umbraco-cms/backoffice/extension-registry';
+import { nothing } from '@umbraco-cms/backoffice/external/lit';
 import { Observable } from '@umbraco-cms/backoffice/external/rxjs';
 import { Observable as Observable_2 } from 'rxjs';
 import { TemplateResult } from 'lit-html';
@@ -718,6 +719,8 @@ export declare const UAI_CONFIGURATION_MENU_ALIAS = "Uai.Menu.Configuration";
  */
 export declare const UAI_CORE_MENU_ALIAS = "Uai.Menu.Configuration";
 
+export declare const UAI_DISCLOSURE_CONTEXT: UmbContextToken<UaiDisclosureContext, UaiDisclosureContext>;
+
 /**
  * A constant representing an empty GUID.
  * @public
@@ -1036,6 +1039,78 @@ export declare interface UaiDetectedEntity {
     workspaceContext: object;
 }
 
+/**
+ * Global context providing the AI disclosure notice state.
+ * Registered as a globalContext manifest - auto-instantiated at backoffice root.
+ */
+export declare class UaiDisclosureContext extends UmbControllerBase {
+    #private;
+    /** Type guard marker for context resolution. */
+    readonly IS_DISCLOSURE_CONTEXT = true;
+    /** The configured notice mode, or undefined while loading. */
+    readonly mode: Observable<UaiDisclosureNoticeMode | undefined>;
+    /** Whether the notice can be dismissed by the user. */
+    readonly canDismiss: Observable<boolean>;
+    /**
+     * Whether the notice should be shown right now at the given location.
+     * @param location A short key for the AI surface, e.g. "chat" or "prompt".
+     */
+    showNoticeFor(location: string): Observable<boolean>;
+    constructor(host: UmbControllerHost);
+    /**
+     * Updates the mode without a reload, e.g. straight after the AI settings are saved.
+     */
+    setMode(mode: UaiDisclosureNoticeMode): void;
+    /**
+     * Hides the notice at the given location for this browser. Other locations are unaffected.
+     * Only has an effect when the mode is Dismissible.
+     * @param location A short key for the AI surface, e.g. "chat" or "prompt" (letters, digits, dashes).
+     */
+    dismiss(location: string): void;
+}
+
+/**
+ * The "Responses are AI-generated" notice, shown next to AI output.
+ *
+ * Follows the global AI Disclosure Notice setting: always shown, dismissible (per location,
+ * remembered per browser) or never shown. Renders nothing while hidden, so hosts can place
+ * it unconditionally.
+ *
+ * Styling hooks for hosts:
+ * - `--uai-disclosure-notice-background` (default: transparent)
+ * - `--uai-disclosure-notice-padding` (default: 0)
+ * - `--uai-disclosure-notice-border-radius` (default: 0)
+ *
+ * @example
+ * ```html
+ * <uai-disclosure-notice location="chat"></uai-disclosure-notice>
+ * ```
+ */
+export declare class UaiDisclosureNoticeElement extends UmbLitElement {
+    #private;
+    /**
+     * A short key for where the notice is shown, e.g. "chat" or "prompt" (letters, digits, dashes).
+     * Dismissing the notice only hides it at this location.
+     */
+    location: string;
+    /** Reflected so hosts can style around the notice, and so it takes no space while hidden. */
+    visible: boolean;
+    private _canDismiss;
+    constructor();
+    updated(changed: Map<PropertyKey, unknown>): void;
+    render(): TemplateResult<1> | typeof nothing;
+    static styles: CSSResult;
+}
+
+/**
+ * How the backoffice shows the notice that tells users a response is AI-generated.
+ *
+ * - `Always`: always shown.
+ * - `Dismissible`: shown until the user dismisses it; the dismissal is remembered per browser.
+ * - `Off`: never shown.
+ */
+export declare type UaiDisclosureNoticeMode = "Always" | "Dismissible" | "Off";
+
 /**
  * Adapter for Umbraco document entities.
  */