@fabric-msft/copilot-web 7.0.0

package/dts/components/prompt-starter/prompt-starter.d.ts

@@ -0,0 +1,160 @@
+import { FASTElement } from "@microsoft/fast-element";
+import { Tooltip } from "@fabric-msft/fabric-web";
+import type { FeedbackGroup } from "../feedback-group/feedback-group.js";
+import { type PromptStarterFeedbackState } from "./prompt-starter.options.js";
+export declare class PromptStarter extends FASTElement {
+    #private;
+    /**
+     * The prompt starter's prompt content.
+     *
+     * @type {string}
+     * @public
+     */
+    prompt: string;
+    /**
+     * The prompt starter's category.
+     *
+     * @type {string}
+     * @public
+     */
+    category: string;
+    /**
+     * The main text content derived from slotted content
+     * Lowercase and trimmed - used for filtering
+     * @public
+     */
+    mainText: string;
+    /**
+     * The default slotted content.
+     *
+     * @internal
+     */
+    slottedPrompt: HTMLElement[];
+    /**
+     * Toolbar actions content slotted into the tooltip.
+     *
+     * @internal
+     */
+    slottedToolbarActions: HTMLElement[];
+    /**
+     * Slotted like button elements (pass-through to feedback-group).
+     * @internal
+     */
+    slottedLikeButton: HTMLElement[];
+    /**
+     * Slotted dislike button elements (pass-through to feedback-group).
+     * @internal
+     */
+    slottedDislikeButton: HTMLElement[];
+    /**
+     * The target element ID to append the prompt to when selected.
+     * @public
+     */
+    target: string;
+    /**
+     * All placeholder texts extracted from slotted content, in order of detection.
+     * Derived from elements with IDs prefixed with 'prompt-placeholder'.
+     * When present, placeholders are removed from the appended text and cursor
+     * is positioned at the first placeholder location.
+     * @public
+     * @readonly
+     */
+    placeholders: string[];
+    /**
+     * The first placeholder text, for convenience.
+     * Returns empty string if no placeholders exist.
+     * @public
+     * @readonly
+     */
+    get placeholderText(): string;
+    /**
+     * Indicates whether the prompt starter has been activated/pressed.
+     * @public
+     */
+    pressed: boolean;
+    /**
+     * The feedback state of the prompt starter.
+     * Accepts 'none', 'liked', or 'disliked'. Writable for state persistence.
+     * @public
+     */
+    feedback: PromptStarterFeedbackState;
+    component: HTMLButtonElement;
+    contentContainer: HTMLElement;
+    /**
+     * Reference to the feedback group element.
+     * @internal
+     */
+    feedbackGroup: FeedbackGroup;
+    /**
+     * Reference to the tooltip element.
+     * @internal
+     */
+    tooltip: Tooltip;
+    /** Current feedback state (readonly). Returns the feedback attribute value. */
+    get feedbackState(): PromptStarterFeedbackState;
+    /**
+     * Handles changes to the feedback attribute.
+     * Syncs the feedback state to the internal feedback group.
+     * @internal
+     */
+    feedbackChanged(_oldValue: PromptStarterFeedbackState, newValue: PromptStarterFeedbackState): void;
+    /** The id used to anchor the internal tooltip. */
+    get tooltipAnchorId(): string;
+    /**
+     * Handles changes to the feedback group reference.
+     * Attaches event listeners when the feedback group is available.
+     * @internal
+     */
+    feedbackGroupChanged(): void;
+    /**
+     * Handles changes to the slotted toolbar actions.
+     * Attaches keydown listeners to new slotted elements for arrow key navigation.
+     * @internal
+     */
+    slottedToolbarActionsChanged(): void;
+    /**
+     * Handles changes to the slotted like button.
+     * Re-attaches listeners when custom like button is slotted.
+     * @internal
+     */
+    slottedLikeButtonChanged(): void;
+    /**
+     * Handles changes to the slotted dislike button.
+     * Re-attaches listeners when custom dislike button is slotted.
+     * @internal
+     */
+    slottedDislikeButtonChanged(): void;
+    /**
+     * Handles changes to the slottedPrompt
+     * @param prev - Previous slotted nodes
+     * @param next - New slotted nodes
+     */
+    slottedPromptChanged(_prev: HTMLElement[] | undefined, next: HTMLElement[] | undefined): void;
+    buttonChanged(_prev: HTMLButtonElement | null, next: HTMLButtonElement | null): void;
+    /**
+     * Appends the current prompt to the configured target element (if any).
+     * Supports native inputs/textareas and custom elements exposing a `value` prop
+     * (e.g., fabric-textarea). Emits input/change events after mutation.
+     * If a placeholder is defined, the placeholder text is excluded from the appended
+     * content and the cursor is positioned where the placeholder would have been.
+     * @internal
+     */
+    appendPromptToTarget(): void;
+    /**
+     * Handles the click event and triggers the submission.
+     * Ignores clicks originating from interactive elements within the card.
+     * This currently only handles link entities.
+     */
+    handleClick: (e: Event) => boolean;
+    /** Prevent tooltip interactions from selecting the card. */
+    handleTooltipClick: (e: Event) => void;
+    connectedCallback(): void;
+    /**
+     * Lifecycle callback when component is disconnected from the DOM.
+     * Removes event listeners.
+     *
+     * @public
+     */
+    disconnectedCallback(): void;
+}
+//# sourceMappingURL=prompt-starter.d.ts.map

package/dts/components/prompt-starter/prompt-starter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-starter.d.ts","sourceRoot":"","sources":["../../../../src/components/prompt-starter/prompt-starter.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EAIZ,MAAM,yBAAyB,CAAC;AASjC,OAAO,EAAqB,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAIrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAQzE,OAAO,EAGL,KAAK,0BAA0B,EAGhC,MAAM,6BAA6B,CAAC;AAmErC,qBAAa,aAAc,SAAQ,WAAW;;IAS5C;;;;;OAKG;IAEI,MAAM,EAAE,MAAM,CAAM;IAE3B;;;;;OAKG;IAEI,QAAQ,EAAE,MAAM,CAAM;IAE7B;;;;OAIG;IAEI,QAAQ,EAAE,MAAM,CAAM;IAE7B;;;;OAIG;IAEI,aAAa,EAAG,WAAW,EAAE,CAAC;IAErC;;;;OAIG;IAEI,qBAAqB,EAAG,WAAW,EAAE,CAAC;IAE7C;;;OAGG;IAEI,iBAAiB,EAAE,WAAW,EAAE,CAAM;IAE7C;;;OAGG;IAEI,oBAAoB,EAAE,WAAW,EAAE,CAAM;IAEhD;;;OAGG;IAEI,MAAM,EAAE,MAAM,CAAM;IAE3B;;;;;;;OAOG;IAEI,YAAY,EAAE,MAAM,EAAE,CAAM;IAEnC;;;;;OAKG;IACH,IAAW,eAAe,IAAI,MAAM,CAEnC;IAED;;;OAGG;IAEI,OAAO,EAAE,OAAO,CAAS;IAEhC;;;;OAIG;IAEI,QAAQ,EAAE,0BAA0B,CACR;IAG5B,SAAS,EAAG,iBAAiB,CAAC;IAG9B,gBAAgB,EAAG,WAAW,CAAC;IAEtC;;;OAGG;IAEI,aAAa,EAAG,aAAa,CAAC;IAErC;;;OAGG;IAEI,OAAO,EAAG,OAAO,CAAC;IAEzB,+EAA+E;IAC/E,IAAW,aAAa,IAAI,0BAA0B,CAErD;IAED;;;;OAIG;IACI,eAAe,CACpB,SAAS,EAAE,0BAA0B,EACrC,QAAQ,EAAE,0BAA0B,GACnC,IAAI;IAMP,kDAAkD;IAClD,IAAW,eAAe,IAAI,MAAM,CAInC;IAyCD;;;;OAIG;IACI,oBAAoB,IAAI,IAAI;IAUnC;;;;OAIG;IACI,4BAA4B,IAAI,IAAI;IAI3C;;;;OAIG;IACI,wBAAwB,IAAI,IAAI;IAIvC;;;;OAIG;IACI,2BAA2B,IAAI,IAAI;IAW1C;;;;OAIG;IACI,oBAAoB,CACzB,KAAK,EAAE,WAAW,EAAE,GAAG,SAAS,EAChC,IAAI,EAAE,WAAW,EAAE,GAAG,SAAS,GAC9B,IAAI;IAQA,aAAa,CAClB,KAAK,EAAE,iBAAiB,GAAG,IAAI,EAC/B,IAAI,EAAE,iBAAiB,GAAG,IAAI,GAC7B,IAAI;IAkEP;;;;;;;OAOG;IACI,oBAAoB,IAAI,IAAI;IAiHnC;;;;OAIG;IACI,WAAW,GAAI,GAAG,KAAK,KAAG,OAAO,CAmBtC;IAuBF,4DAA4D;IACrD,kBAAkB,GAAI,GAAG,KAAK,KAAG,IAAI,CAE1C;IA+PK,iBAAiB,IAAI,IAAI;IAUhC;;;;;OAKG;IACI,oBAAoB,IAAI,IAAI;CAkHpC"}

package/dts/components/prompt-starter/prompt-starter.definition.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Composed element definition for `<fabric-prompt-starter>`, registering the
+ * `fabric-tooltip` and `fabric-feedback-group` (and its dependencies) before
+ * the element itself.
+ *
+ * @public
+ * @remarks
+ * HTML Element: `<fabric-prompt-starter>`
+ */
+export declare const definition: import("@fabric-msft/fabric-web").FabricElementDefinition;
+//# sourceMappingURL=prompt-starter.definition.d.ts.map

package/dts/components/prompt-starter/prompt-starter.definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-starter.definition.d.ts","sourceRoot":"","sources":["../../../../src/components/prompt-starter/prompt-starter.definition.ts"],"names":[],"mappings":"AAkBA;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,2DAItB,CAAC"}

package/dts/components/prompt-starter/prompt-starter.options.d.ts

@@ -0,0 +1,58 @@
+import type { ValuesOf } from "@microsoft/fast-foundation";
+/**
+ * Accessibility configuration for feedback buttons (like/dislike).
+ * @public
+ */
+export interface FeedbackButtonA11y {
+    /** The aria-label for the button. */
+    ariaLabel?: string;
+    /** The aria-labelledby reference for the button. */
+    ariaLabelledby?: string;
+    /** The aria-describedby reference for the button. */
+    ariaDescribedby?: string;
+}
+/**
+ * @public
+ * Prompt Card event names
+ */
+export declare const PromptStarterEvents: {
+    readonly promptSelect: "prompt-select";
+};
+export type PromptStarterEvent = ValuesOf<typeof PromptStarterEvents>;
+/**
+ * @public
+ * Aggregate feedback state for the PromptStarter.
+ */
+export declare const PromptStarterFeedbackStates: {
+    readonly none: "none";
+    readonly liked: "liked";
+    readonly disliked: "disliked";
+};
+/**
+ * @public
+ * Aggregate feedback state type for the PromptStarter.
+ */
+export type PromptStarterFeedbackState = ValuesOf<typeof PromptStarterFeedbackStates>;
+/**
+ * Represents an element that can be used as a prompt target.
+ * Supports native inputs/textareas and custom elements with value/inputRef properties.
+ * @public
+ */
+export type PromptTargetElement = HTMLElement & {
+    value?: string;
+    handleInput?: () => void;
+    inputRef?: HTMLTextAreaElement | HTMLInputElement | null;
+};
+/**
+ * Detail payload for the `prompt-select` event.
+ * @public
+ */
+export interface PromptSelectEventDetail {
+    /** Reference to the PromptStarter element that emitted the event. */
+    target: HTMLElement;
+    /** The prompt text value. */
+    prompt: string;
+    /** All placeholder texts extracted from slotted content, in order of detection. Empty array if none. */
+    placeholders: string[];
+}
+//# sourceMappingURL=prompt-starter.options.d.ts.map

package/dts/components/prompt-starter/prompt-starter.options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-starter.options.d.ts","sourceRoot":"","sources":["../../../../src/components/prompt-starter/prompt-starter.options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;CAEtB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;CAI9B,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAC/C,OAAO,2BAA2B,CACnC,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,mBAAmB,GAAG,gBAAgB,GAAG,IAAI,CAAC;CAC1D,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,qEAAqE;IACrE,MAAM,EAAE,WAAW,CAAC;IACpB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,wGAAwG;IACxG,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB"}

package/dts/components/prompt-starter/prompt-starter.styles.d.ts

@@ -0,0 +1,2 @@
+export declare const styles: import("@microsoft/fast-element").ElementStyles;
+//# sourceMappingURL=prompt-starter.styles.d.ts.map

package/dts/components/prompt-starter/prompt-starter.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-starter.styles.d.ts","sourceRoot":"","sources":["../../../../src/components/prompt-starter/prompt-starter.styles.ts"],"names":[],"mappings":"AAsBA,eAAO,MAAM,MAAM,iDAgFlB,CAAC"}

package/dts/components/prompt-starter/prompt-starter.template.d.ts

@@ -0,0 +1,9 @@
+import type { ElementViewTemplate } from "@microsoft/fast-element";
+import type { PromptStarter } from "./prompt-starter.js";
+/**
+ * The template for the {@link @fabric-msft/copilot-web#(promptStarter:class)} component.
+ * @public
+ */
+export declare function promptStarterTemplate<T extends PromptStarter>(): ElementViewTemplate<T>;
+export declare const template: ElementViewTemplate<PromptStarter>;
+//# sourceMappingURL=prompt-starter.template.d.ts.map

package/dts/components/prompt-starter/prompt-starter.template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-starter.template.d.ts","sourceRoot":"","sources":["../../../../src/components/prompt-starter/prompt-starter.template.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,CAAC,SAAS,aAAa,KACpB,mBAAmB,CAAC,CAAC,CAAC,CAkF1B;AAED,eAAO,MAAM,QAAQ,EAAE,mBAAmB,CAAC,aAAa,CAC/B,CAAC"}

package/dts/components/reference/define.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=define.d.ts.map

package/dts/components/reference/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../../../src/components/reference/define.ts"],"names":[],"mappings":""}

package/dts/components/reference/index.d.ts

@@ -0,0 +1,5 @@
+export { Reference } from "./reference.js";
+export { definition as ReferenceDefinition } from "./reference.definition.js";
+export { template as ReferenceTemplate } from "./reference.template.js";
+export { styles as ReferenceStyles } from "./reference.styles.js";
+//# sourceMappingURL=index.d.ts.map

package/dts/components/reference/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/reference/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,IAAI,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,QAAQ,IAAI,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dts/components/reference/reference.d.ts

@@ -0,0 +1,239 @@
+import { FASTElement } from "@microsoft/fast-element";
+/**
+ * Reference
+ * @summary A comprehensive reference component that displays citation information with expandable content, interactive elements, and text input capabilities. Provides keyboard navigation, focus management, and accessibility features for reference interaction and editing.
+ *
+ * @example
+ * ```html
+ * <fabric-reference citation-href="https://example.com">
+ *   <span slot="index">1</span>
+ *   <span slot="label">Example Reference</span>
+ *   <span slot="metadata-text-one">Metadata One</span>
+ *   <span slot="metadata-text-two">Metadata Two</span>
+ *   <span slot="metadata-text-three">Metadata Three</span>
+ *   <span slot="excerpt">This is an excerpt from the reference content.</span>
+ * </fabric-reference>
+ * ```
+ *
+ * @attr {string} citation-href - URL associated with the citation
+ * @attr {string} error-message - Custom error message to display
+ * @attr {boolean} disabled - Whether the reference is in a disabled state
+ * @attr {number} max-length - Maximum character limit for the text area
+ * @attr {string} placeholder - Placeholder text for the text area
+ * @attr {boolean} hide-character-count - Controls visibility of character count
+ *
+ * @prop {HTMLElement[]} actions - Array of action elements (menus, buttons) in the reference
+ * @prop {Array<HTMLElement>} actionsButtons - Array of action buttons extracted from the actions array
+ * @prop {number} index - The numeric index of this reference
+ * @prop {Array<HTMLElement>} indexReference - Array of elements in the index slot
+ * @prop {Array<HTMLElement>} metadataTextOne - Array of elements in the first metadata text slot
+ * @prop {boolean} hasMetadataTextOne - Flag indicating if first metadata text slot has content
+ * @prop {Array<HTMLElement>} metadataTextTwo - Array of elements in the second metadata text slot
+ * @prop {boolean} hasMetadataTextTwo - Flag indicating if second metadata text slot has content
+ * @prop {Array<HTMLElement>} metadataTextThree - Array of elements in the third metadata text slot
+ * @prop {boolean} hasMetadataTextThree - Flag indicating if third metadata text slot has content
+ * @prop {string} citationHref - URL associated with the citation
+ * @prop {boolean} loading - Flag indicating if the reference is in a loading state
+ * @prop {boolean} expanded - Flag indicating if the reference content is expanded
+ * @prop {string} svgColor - Color for SVG icons in normal state
+ * @prop {string} svgColorDisabled - Color for SVG icons in disabled state
+ * @prop {boolean} hasMaxCharLimit - Whether max character limit has been reached
+ * @prop {number} characterCount - Current character count
+ * @prop {boolean} hasButtons - Whether action buttons are present
+ * @prop {HTMLElement[]} buttons - Collection of action buttons
+ * @prop {boolean} hasMessages - Whether messages are present
+ * @prop {HTMLElement[]} messages - Collection of message elements
+ * @prop {boolean} hasAttachments - Whether attachments are present
+ * @prop {HTMLElement[]} attachments - Collection of attachment elements
+ * @prop {HTMLTextAreaElement} inputRef - Reference to the textarea element
+ * @prop {string} value - Current value of the textarea
+ *
+ * @slot index - The citation index number
+ * @slot reference-icon - Icon representing the reference type
+ * @slot label - The title or label of the reference
+ * @slot actions - Additional actionable elements like menus or buttons
+ * @slot metadata-icon-start - Icon displayed at the start of metadata section
+ * @slot metadata-text-one - First line of metadata text
+ * @slot metadata-text-two - Second line of metadata text
+ * @slot metadata-text-three - Third line of metadata text
+ * @slot metadata-icon-end - Icon displayed at the end of metadata section
+ * @slot excerpt - The reference content or excerpt text
+ *
+ * @csspart base - The base container of the reference
+ * @csspart textarea-root - The root container for the textarea element
+ * @csspart messages-row - Container for messages and error states
+ * @csspart attachments-row - Container for attachments
+ * @csspart interactions-row - Container for interactive elements
+ * @csspart interactions-left-col - Left column of interactions section
+ * @csspart interactions-center-col - Center column of interactions section
+ * @csspart interactions-right-col - Right column of interactions section
+ * @csspart character-count - The character count display
+ * @csspart submit-button - The submit/send button
+ * @csspart divider - Visual divider between sections
+ *
+ * @method actionsChanged - Handles changes to the actions array by gathering menu buttons and regular buttons
+ * @method indexReferenceChanged - Updates the index when the indexReference changes
+ * @method metadataTextOneChanged - Updates hasMetadataTextOne flag when metadataTextOne changes
+ * @method metadataTextTwoChanged - Updates hasMetadataTextTwo flag when metadataTextTwo changes
+ * @method metadataTextThreeChanged - Updates hasMetadataTextThree flag when metadataTextThree changes
+ * @method expandedChanged - Dispatches change event when expanded state changes
+ * @method emitDismissEvent - Emits dismiss event when reference is dismissed
+ * @method _activeIndexChanged - Focuses the element at activeIndex when it changes
+ * @method handleIndexUp - Increments the active index
+ * @method handleIndexDown - Decrements the active index
+ * @method handleKeyEvents - Handles keyboard events for focus management and interaction
+ * @method trapFocus - Sets up focus trapping and handles keyboard events
+ * @method handleBlur - Handles blur events by resetting active index
+ * @method gatherFocusableElements - Gathers all focusable elements within the reference
+ * @method connectedCallback - Lifecycle callback when component is connected to DOM
+ * @method disconnectedCallback - Lifecycle callback when component is disconnected from DOM
+ *
+ * @fires change - Fires when the textarea value changes
+ * @fires referenceDismiss - Fires when the reference is dismissed
+ * @fires select - Fires when text is selected
+ * @fires focus - Fires when the reference gains focus
+ * @fires blur - Fires when the reference loses focus
+ * @fires submit - Fires when content is submitted
+ *
+ * @extends FASTElement
+ * @tagname fabric-reference
+ * @public
+ */
+export declare class Reference extends FASTElement {
+    /**
+     * Array of action elements (menus, buttons) in the reference
+     */
+    actions: HTMLElement[];
+    /**
+     * Handles changes to the actions array by gathering menu buttons and regular buttons
+     */
+    actionsChanged(): void;
+    /**
+     * Array of action buttons extracted from the actions array
+     */
+    actionsButtons: Array<HTMLElement>;
+    /**
+     * The numeric index of this reference
+     */
+    index?: number;
+    /**
+     * Array of elements in the index slot
+     */
+    indexReference: Array<HTMLElement>;
+    /**
+     * Updates the index when the indexReference changes
+     */
+    indexReferenceChanged(): void;
+    /**
+     * Array of elements in the first metadata text slot
+     */
+    metadataTextOne: Array<HTMLElement>;
+    /**
+     * Updates hasMetadataTextOne flag when metadataTextOne changes
+     */
+    metadataTextOneChanged(): void;
+    /**
+     * Flag indicating if first metadata text slot has content
+     */
+    hasMetadataTextOne: boolean;
+    /**
+     * Array of elements in the second metadata text slot
+     */
+    metadataTextTwo: Array<HTMLElement>;
+    /**
+     * Updates hasMetadataTextTwo flag when metadataTextTwo changes
+     */
+    metadataTextTwoChanged(): void;
+    /**
+     * Flag indicating if second metadata text slot has content
+     */
+    hasMetadataTextTwo: boolean;
+    /**
+     * Array of elements in the third metadata text slot
+     */
+    metadataTextThree: Array<HTMLElement>;
+    /**
+     * Updates hasMetadataTextThree flag when metadataTextThree changes
+     */
+    metadataTextThreeChanged(): void;
+    /**
+     * Flag indicating if third metadata text slot has content
+     */
+    hasMetadataTextThree: boolean;
+    /**
+     * URL associated with the citation
+     */
+    citationHref?: string;
+    /**
+     * Flag indicating if the reference is in a loading state
+     */
+    loading: boolean;
+    /**
+     * Flag indicating if the reference content is expanded
+     */
+    expanded?: boolean;
+    /**
+     * Dispatches change event when expanded state changes
+     */
+    expandedChanged(): void;
+    /**
+     * Emits dismiss event when reference is dismissed
+     */
+    emitDismissEvent(): void;
+    /**
+     * Array of focusable elements within the reference
+     */
+    private _focusableElements;
+    /**
+     * Index of currently active (focused) element
+     */
+    private _activeIndex;
+    /**
+     * Focuses the element at activeIndex when it changes
+     */
+    _activeIndexChanged(): void;
+    /**
+     * Gets the current active index
+     */
+    get activeIndex(): number | undefined;
+    /**
+     * Sets the active index with bounds checking
+     */
+    set activeIndex(newIndex: number | undefined);
+    /**
+     * Increments the active index
+     */
+    handleIndexUp(): void;
+    /**
+     * Decrements the active index
+     */
+    handleIndexDown(): void;
+    /**
+     * Handles keyboard events for focus management and interaction
+     * @param event - The keyboard event
+     */
+    handleKeyEvents(event: KeyboardEvent): void;
+    /**
+     * Sets up focus trapping and handles keyboard events
+     * @param event - The keyboard event
+     */
+    trapFocus(event: KeyboardEvent): void;
+    /**
+     * Handles blur events by resetting active index
+     * @param event - The blur event
+     */
+    handleBlur(_event: Event): void;
+    /**
+     * Gathers all focusable elements within the reference
+     */
+    gatherFocusableElements(): void;
+    /**
+     * Sets up component when connected to DOM
+     */
+    connectedCallback(): void;
+    /**
+     * Cleans up event listeners when disconnected from DOM
+     */
+    disconnectedCallback(): void;
+}
+//# sourceMappingURL=reference.d.ts.map

package/dts/components/reference/reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../../../src/components/reference/reference.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,WAAW,EAEZ,MAAM,yBAAyB,CAAC;AAIjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmGG;AACH,qBAAa,SAAU,SAAQ,WAAW;IACxC;;OAEG;IAEI,OAAO,EAAE,WAAW,EAAE,CAAM;IAEnC;;OAEG;IACI,cAAc,IAAI,IAAI;IAa7B;;OAEG;IAEI,cAAc,EAAE,KAAK,CAAC,WAAW,CAAC,CAAM;IAE/C;;OAEG;IAEI,KAAK,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IAEI,cAAc,EAAE,KAAK,CAAC,WAAW,CAAC,CAAM;IAE/C;;OAEG;IACH,qBAAqB;IAIrB;;OAEG;IAEI,eAAe,EAAE,KAAK,CAAC,WAAW,CAAC,CAAM;IAEhD;;OAEG;IACH,sBAAsB;IAMtB;;OAEG;IAEH,kBAAkB,EAAE,OAAO,CAAS;IAEpC;;OAEG;IAEI,eAAe,EAAE,KAAK,CAAC,WAAW,CAAC,CAAM;IAEhD;;OAEG;IACH,sBAAsB;IAMtB;;OAEG;IAEH,kBAAkB,EAAE,OAAO,CAAS;IAEpC;;OAEG;IAEI,iBAAiB,EAAE,KAAK,CAAC,WAAW,CAAC,CAAM;IAElD;;OAEG;IACH,wBAAwB;IAMxB;;OAEG;IAEH,oBAAoB,EAAE,OAAO,CAAS;IAEtC;;OAEG;IAEI,YAAY,CAAC,EAAE,MAAM,CAAC;IAE7B;;OAEG;IAEI,OAAO,EAAE,OAAO,CAAS;IAEhC;;OAEG;IAEI,QAAQ,CAAC,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,eAAe;IAaf;;OAEG;IACI,gBAAgB;IAYvB;;OAEG;IACH,OAAO,CAAC,kBAAkB,CAA0B;IAEpD;;OAEG;IAEH,OAAO,CAAC,YAAY,CAAiC;IAErD;;OAEG;IACH,mBAAmB;IASnB;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED;;OAEG;IACH,IAAI,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAM3C;IAED;;OAEG;IACI,aAAa;IAQpB;;OAEG;IACI,eAAe;IAKtB;;;OAGG;IACI,eAAe,CAAC,KAAK,EAAE,aAAa;IA2B3C;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,aAAa;IAQ9B;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,KAAK;IAIxB;;OAEG;IACH,uBAAuB;IAavB;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAUzB;;OAEG;IACH,oBAAoB,IAAI,IAAI;CAK7B"}

package/dts/components/reference/reference.definition.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Composed element definition for `<fabric-reference>`, registering the
+ * `fabric-citation` and `fluent-button` dependencies before the element itself.
+ *
+ * @public
+ * @remarks
+ * HTML Element: `<fabric-reference>`
+ */
+export declare const definition: import("@fabric-msft/fabric-web/build/dts/util/element-definition.js").FabricElementDefinition;
+//# sourceMappingURL=reference.definition.d.ts.map

package/dts/components/reference/reference.definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.definition.d.ts","sourceRoot":"","sources":["../../../../src/components/reference/reference.definition.ts"],"names":[],"mappings":"AAmBA;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,gGAItB,CAAC"}

package/dts/components/reference/reference.styles.d.ts

@@ -0,0 +1,2 @@
+export declare const styles: import("@microsoft/fast-element").ElementStyles;
+//# sourceMappingURL=reference.styles.d.ts.map

package/dts/components/reference/reference.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.styles.d.ts","sourceRoot":"","sources":["../../../../src/components/reference/reference.styles.ts"],"names":[],"mappings":"AAsBA,eAAO,MAAM,MAAM,iDA+FlB,CAAC"}

package/dts/components/reference/reference.template.d.ts

@@ -0,0 +1,9 @@
+import type { ElementViewTemplate } from "@microsoft/fast-element";
+import type { Reference } from "./reference.js";
+/**
+ * The template for the Reference component.
+ * @public
+ */
+export declare function ReferenceTemplate<T extends Reference>(): ElementViewTemplate<T>;
+export declare const template: ElementViewTemplate<Reference>;
+//# sourceMappingURL=reference.template.d.ts.map

package/dts/components/reference/reference.template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.template.d.ts","sourceRoot":"","sources":["../../../../src/components/reference/reference.template.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AA+ChD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,CAAC,SAAS,SAAS,KAChB,mBAAmB,CAAC,CAAC,CAAC,CA0F1B;AAED,eAAO,MAAM,QAAQ,EAAE,mBAAmB,CAAC,SAAS,CAAuB,CAAC"}

package/dts/components/reference-group/define.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=define.d.ts.map

package/dts/components/reference-group/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../../../src/components/reference-group/define.ts"],"names":[],"mappings":""}

package/dts/components/reference-group/index.d.ts

@@ -0,0 +1,5 @@
+export { ReferenceGroup } from "./reference-group.js";
+export { definition as ReferenceGroupDefinition } from "./reference-group.definition.js";
+export { template as ReferenceGroupTemplate } from "./reference-group.template.js";
+export { styles as ReferenceGroupStyles } from "./reference-group.styles.js";
+//# sourceMappingURL=index.d.ts.map

package/dts/components/reference-group/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/reference-group/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,IAAI,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AACzF,OAAO,EAAE,QAAQ,IAAI,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAAE,MAAM,IAAI,oBAAoB,EAAE,MAAM,6BAA6B,CAAC"}

package/dts/components/reference-group/reference-group.d.ts

@@ -0,0 +1,48 @@
+import { FASTElement } from "@microsoft/fast-element";
+import { ReferenceList } from "../reference-list/index.js";
+/**
+ * ReferenceGroup
+ * @summary A reference group component that encapsulates a reference list and adds expandable/collapsible functionality. Provides keyboard navigation and accessibility features for managing groups of references with visual feedback.
+ *
+ * @example
+ * ```html
+ * <fabric-reference-group tabindex="0" expanded>
+ *   <span slot="default">Group Title (3 references)</span>
+ *   <fabric-reference-list slot="reference-list">
+ *     <!-- Reference items here -->
+ *   </fabric-reference-list>
+ * </fabric-reference-group>
+ * ```
+ *
+ * @attr {boolean} expanded - Controls whether the reference group content is expanded or collapsed
+ * @attr {number} tabindex - Sets the tab order of the reference group
+ *
+ * @prop {Array<ReferenceList>} referenceList - Collection of reference lists contained within the group
+ * @prop {number} tabindex - Sets the tab order of the reference group
+ * @prop {boolean} expanded - Indicates whether the reference group content is expanded or collapsed
+ *
+ * @slot - Content displayed as the group label/title, typically showing the number of references
+ * @slot reference-list - Contains the reference list component that holds individual references
+ *
+ * @csspart reference-group-label - The label container showing the group title and expand/collapse button
+ * @csspart group-expand-button-container - Container for the expand/collapse button
+ * @csspart group-expand-button - The expand/collapse button
+ * @csspart reference-list-container - Container for the reference list slot
+ *
+ * @method expandedChanged - Invoked when the 'expanded' property changes and dispatches change event
+ * @method connectedCallback - Lifecycle callback when component is connected to DOM
+ *
+ * @fires change - Fires when the group is expanded or collapsed
+ *
+ * @extends FASTElement
+ * @tagname fabric-reference-group
+ * @public
+ */
+export declare class ReferenceGroup extends FASTElement {
+    referenceList: Array<ReferenceList>;
+    tabindex: number;
+    expanded: boolean;
+    expandedChanged(): void;
+    connectedCallback(): void;
+}
+//# sourceMappingURL=reference-group.d.ts.map

package/dts/components/reference-group/reference-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-group.d.ts","sourceRoot":"","sources":["../../../../src/components/reference-group/reference-group.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,WAAW,EAEZ,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAEtC,aAAa,EAAE,KAAK,CAAC,aAAa,CAAC,CAAM;IAGhD,QAAQ,EAAE,MAAM,CAAK;IAGd,QAAQ,EAAE,OAAO,CAAS;IAEjC,eAAe;IAYf,iBAAiB,IAAI,IAAI;CAI1B"}

package/dts/components/reference-group/reference-group.definition.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Composed element definition for `<fabric-reference-group>`, registering the
+ * `fluent-button` dependency before the element itself.
+ *
+ * @public
+ * @remarks
+ * HTML Element: `<fabric-reference-group>`
+ */
+export declare const definition: import("@fabric-msft/fabric-web/build/dts/util/element-definition.js").FabricElementDefinition;
+//# sourceMappingURL=reference-group.definition.d.ts.map

package/dts/components/reference-group/reference-group.definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-group.definition.d.ts","sourceRoot":"","sources":["../../../../src/components/reference-group/reference-group.definition.ts"],"names":[],"mappings":"AAkBA;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,gGAGtB,CAAC"}