@fluentui-copilot/react-reference 0.15.4 → 0.16.0

package/CHANGELOG.json

@@ -2,7 +2,51 @@
   "name": "@fluentui-copilot/react-reference",
   "entries": [
     {
-      "date": "Mon, 19 May 2025 18:03:24 GMT",
+      "date": "Thu, 12 Jun 2025 17:49:28 GMT",
+      "tag": "@fluentui-copilot/react-reference_v0.16.0",
+      "version": "0.16.0",
+      "comments": {
+        "minor": [
+          {
+            "author": "jiangemma@microsoft.com",
+            "package": "@fluentui-copilot/react-reference",
+            "commit": "518dd2e5e4fed30451abe6e9a657a14440c872d4",
+            "comment": "chore: Remove deprecated Reference, ReferenceList, ReferenceGroupToggle components"
+          },
+          {
+            "author": "jiangemma@microsoft.com",
+            "package": "@fluentui-copilot/react-reference",
+            "commit": "20deef335194400cc40c70dd60ea4f69b5829c9e",
+            "comment": "chore: Export ReferenceV2 as Reference and ReferenceListV2 as ReferenceList."
+          }
+        ],
+        "patch": [
+          {
+            "author": "Humberto.Morimoto@microsoft.com",
+            "package": "@fluentui-copilot/react-reference",
+            "commit": "53a6e5419e6170dea520ebec933d347ce0bedb60",
+            "comment": "chore: Update typographyStyles import to use @fluentui-copilot/tokens instead of @fluentui/react-components"
+          }
+        ]
+      }
+    },
+    {
+      "date": "Wed, 28 May 2025 16:45:32 GMT",
+      "tag": "@fluentui-copilot/react-reference_v0.15.5",
+      "version": "0.15.5",
+      "comments": {
+        "patch": [
+          {
+            "author": "mgodbolt@microsoft.com",
+            "package": "@fluentui-copilot/react-reference",
+            "commit": "5f0ad3bf1731d25041cfd0b24d690201799162a5",
+            "comment": "Citation: Add padding to prevent numbers from touching the border"
+          }
+        ]
+      }
+    },
+    {
+      "date": "Mon, 19 May 2025 18:04:28 GMT",
       "tag": "@fluentui-copilot/react-reference_v0.15.4",
       "version": "0.15.4",
       "comments": {

package/CHANGELOG.md

@@ -1,9 +1,32 @@
 # Change Log - @fluentui-copilot/react-reference
 
-This log was last generated on Sat, 03 May 2025 01:27:44 GMT and should not be manually modified.
+This log was last generated on Thu, 12 Jun 2025 17:49:28 GMT and should not be manually modified.
 
 <!-- Start content -->
 
+## [0.16.0](https://github.com/microsoft/fluentai/tree/@fluentui-copilot/react-reference_v0.16.0)
+
+Thu, 12 Jun 2025 17:49:28 GMT 
+[Compare changes](https://github.com/microsoft/fluentai/compare/@fluentui-copilot/react-reference_v0.15.5..@fluentui-copilot/react-reference_v0.16.0)
+
+### Minor changes
+
+- chore: Remove deprecated Reference, ReferenceList, ReferenceGroupToggle components ([PR #3073](https://github.com/microsoft/fluentai/pull/3073) by jiangemma@microsoft.com)
+- chore: Export ReferenceV2 as Reference and ReferenceListV2 as ReferenceList. ([PR #3088](https://github.com/microsoft/fluentai/pull/3088) by jiangemma@microsoft.com)
+
+### Patches
+
+- chore: Update typographyStyles import to use @fluentui-copilot/tokens instead of @fluentui/react-components ([PR #3125](https://github.com/microsoft/fluentai/pull/3125) by Humberto.Morimoto@microsoft.com)
+
+## [0.15.5](https://github.com/microsoft/fluentai/tree/@fluentui-copilot/react-reference_v0.15.5)
+
+Wed, 28 May 2025 16:45:32 GMT 
+[Compare changes](https://github.com/microsoft/fluentai/compare/@fluentui-copilot/react-reference_v0.15.4..@fluentui-copilot/react-reference_v0.15.5)
+
+### Patches
+
+- Citation: Add padding to prevent numbers from touching the border ([PR #3054](https://github.com/microsoft/fluentai/pull/3054) by mgodbolt@microsoft.com)
+
 ## [0.15.3](https://github.com/microsoft/fluentai/tree/@fluentui-copilot/react-reference_v0.15.3)
 
 Sat, 03 May 2025 01:27:44 GMT 

package/dist/index.d.ts

@@ -1,14 +1,13 @@
 /// <reference types="react" />
 
-import type { Button } from '@fluentui/react-components';
 import type { ComponentProps } from '@fluentui/react-components';
 import type { ComponentState } from '@fluentui/react-components';
 import type { Context } from '@fluentui/react-context-selector';
 import type { ContextSelector } from '@fluentui/react-context-selector';
-import type { CopilotMode } from '@fluentui-copilot/react-provider';
 import type { DesignVersion } from '@fluentui-copilot/react-provider';
 import { FC } from 'react';
 import type { ForwardRefComponent } from '@fluentui/react-components';
+import { ForwardRefComponent as ForwardRefComponent_2 } from '@fluentui/react-utilities';
 import type { PreviewHeaderProps } from '@fluentui-copilot/react-preview';
 import type { PreviewMetadataProps } from '@fluentui-copilot/react-preview';
 import type { PreviewProps } from '@fluentui-copilot/react-preview';
@@ -16,9 +15,11 @@ import type { PreviewSurfaceProps } from '@fluentui-copilot/react-preview';
 import { Provider } from 'react';
 import { ProviderProps } from 'react';
 import * as React_2 from 'react';
+import { Ref } from 'react';
 import type { SensitivityLabelProps } from '@fluentui-copilot/react-sensitivity-label';
 import type { Slot } from '@fluentui/react-components';
 import type { SlotClassNames } from '@fluentui/react-components';
+import { SlotClassNames as SlotClassNames_2 } from '@fluentui/react-utilities';
 
 export declare const Citation: ForwardRefComponent<CitationProps>;
 
@@ -67,62 +68,28 @@ export declare type CitationState = ComponentState<CitationSlots> & Required<Pic
  */
 export declare const generateReferenceCitationPreview: ReferenceCitationPreviewGenerator;
 
-/**
- * A "packaged Citation". A packaged Citation is a `Citation` that is
- * pre-packaged with props set by the `useReferenceCitation` hook.
- */
-export declare type PackagedCitation = React_2.FC<PackagedCitationProps>;
-
-/**
- * Props for a "packaged Citation". A packaged Citation is a `Citation` that is
- * pre-packaged with props set by the `useReferenceCitation` hook.
- */
-export declare type PackagedCitationProps = Omit<CitationProps, 'referenceHref'> & Partial<Pick<CitationProps, 'referenceHref'>>;
+export declare type PackagedCitation = React_2.FC<CitationProps>;
 
-export declare type PackagedCitationV2 = React_2.FC<CitationProps>;
+/** @deprecated use PackagedCitation */
+export declare type PackagedCitationV2 = PackagedCitation;
 
-export declare type PackagedPreviewContentV2Props = Pick<PreviewMetadataProps, 'icon' | 'primaryText' | 'secondaryText' | 'tertiaryText'> & {
+export declare type PackagedPreviewContentProps = Pick<PreviewMetadataProps, 'icon' | 'primaryText' | 'secondaryText' | 'tertiaryText'> & {
     content?: React_2.ReactNode;
 };
 
-/**
- * A "packaged Reference". A packaged Reference is a `Reference` that is
- * pre-packaged with props set by the `useReferenceCitation` hook.
- */
-export declare type PackagedReference = React_2.FC<PackagedReferenceProps>;
+/** @deprecated use PackagedPreviewContentProps */
+export declare type PackagedPreviewContentV2Props = PackagedPreviewContentProps;
 
-/**
- * Props for a "packaged Reference". A packaged Reference is a `Reference` that is
- * pre-packaged with props set by the `useReferenceCitation` hook.
- */
-export declare type PackagedReferenceProps = Omit<ReferenceProps, PartialReferenceProps> & Partial<Pick<ReferenceProps, PartialReferenceProps>>;
+export declare type PackagedReference = React_2.FC<ReferenceProps>;
 
-export declare type PackagedReferenceV2 = React_2.FC<ReferenceV2Props>;
+/** @deprecated use PackagedReference */
+export declare type PackagedReferenceV2 = PackagedReference;
 
-declare type PartialReferenceProps = 'citationHref' | 'index' | 'referenceId';
-
-/** deprecated Use ReferenceV2 component, hooks and types instead. */
 export declare const Reference: ForwardRefComponent<ReferenceProps>;
 
-/**
- * Data used to package a `Citation` and `Reference` together with
- * the `useReferenceCitation` hook.
- */
-export declare type ReferenceCitationData = {
-    index: number;
-    referenceId?: string;
-    citationId?: string;
-    citationProps?: PackagedCitationProps;
-    referenceProps?: PackagedReferenceProps;
-    previewHeaderProps?: PreviewHeaderProps;
-    previewProps?: PreviewProps;
-    previewSurfaceProps?: PreviewSurfaceProps;
-    sensitivityLabelProps?: SensitivityLabelProps;
-};
-
 export declare type ReferenceCitationPreviewGenerator = (props: ReferenceCitationPreviewGeneratorProps) => {
-    Citation: PackagedCitationV2;
-    Reference: PackagedReferenceV2;
+    Citation: PackagedCitation;
+    Reference: PackagedReference;
 };
 
 export declare type ReferenceCitationPreviewGeneratorProps = {
@@ -130,43 +97,22 @@ export declare type ReferenceCitationPreviewGeneratorProps = {
     citationPreviewSurfaceProps?: PreviewSurfaceProps;
     citationProps?: CitationProps;
     index: number;
-    previewContentProps?: PackagedPreviewContentV2Props;
+    previewContentProps?: PackagedPreviewContentProps;
     previewHeaderProps?: PreviewHeaderProps;
     referencePreviewProps?: Omit<PreviewProps, 'children'> & Partial<Pick<PreviewProps, 'children'>>;
     referencePreviewSurfaceProps?: PreviewSurfaceProps;
-    referenceProps?: ReferenceV2Props;
+    referenceProps?: ReferenceProps;
     sensitivityLabelProps?: SensitivityLabelProps;
 };
 
-/** deprecated Use ReferenceV2 component, hooks and types instead. */
 export declare const referenceClassNames: SlotClassNames<ReferenceSlots>;
 
-/** deprecated The ReferenceGroup pattern is deprecated and will be removed in a future release. */
-export declare const ReferenceGroupToggle: ForwardRefComponent<ReferenceGroupToggleProps>;
-
-export declare const referenceGroupToggleClassNames: SlotClassNames<ReferenceGroupToggleSlots>;
-
-/**
- * ReferenceGroupToggle Props
- */
-export declare type ReferenceGroupToggleProps = ComponentProps<ReferenceGroupToggleSlots> & CopilotMode & {
-    isOpen?: boolean;
-};
-
-export declare type ReferenceGroupToggleSlots = {
-    root: NonNullable<Slot<'button'>>;
-    icon?: Slot<'span'>;
+export declare const referenceExtraClassNames: {
+    graphicChild: string;
 };
 
-/**
- * State used in rendering ReferenceGroupToggle
- */
-export declare type ReferenceGroupToggleState = ComponentState<ReferenceGroupToggleSlots> & Required<Pick<ReferenceGroupToggleProps, 'isOpen' | 'mode'>>;
-
-/** deprecated Use ReferenceListV2 component, hooks and types instead. */
 export declare const ReferenceList: ForwardRefComponent<ReferenceListProps>;
 
-/** deprecated Use ReferenceListV2 component, hooks and types instead. */
 export declare const referenceListClassNames: SlotClassNames<ReferenceListSlots>;
 
 export declare const ReferenceListContext: Context<ReferenceListContextValue>;
@@ -176,31 +122,13 @@ export declare const ReferenceListContextProvider: Provider<ReferenceListContext
 /**
  * Context shared between ReferenceList and its children components
  */
-export declare type ReferenceListContextValue = Pick<ReferenceListV2State, 'areReferencesExpanded' | 'maxVisibleReferences' | 'overflowButtonTriggeredViaKeyboard' | 'referenceListRef' | 'shouldUseOverflow' | 'totalReferencesCount'>;
-
-/** deprecated Use ReferenceListV2 component, hooks and types instead. */
-export declare type ReferenceListProps = ComponentProps<ReferenceListSlots>;
-
-/** deprecated Use ReferenceListV2 component, hooks and types instead. */
-export declare type ReferenceListSlots = {
-    /**
-     * The root slot.
-     */
-    root: Slot<'ol'>;
-};
+export declare type ReferenceListContextValue = Pick<ReferenceListState, 'areReferencesExpanded' | 'maxVisibleReferences' | 'overflowButtonTriggeredViaKeyboard' | 'referenceListRef' | 'shouldUseOverflow' | 'totalReferencesCount'>;
 
-/** deprecated Use ReferenceListV2 component, hooks and types instead. */
-export declare type ReferenceListState = ComponentState<ReferenceListSlots>;
-
-export declare const ReferenceListV2: ForwardRefComponent<ReferenceListV2Props>;
-
-export declare const referenceListV2ClassNames: SlotClassNames<ReferenceListV2Slots>;
-
-export declare type ReferenceListV2ContextValues = {
+export declare type ReferenceListContextValues = {
     referenceList: ReferenceListContextValue;
 };
 
-export declare type ReferenceListV2Props = ComponentProps<Partial<ReferenceListV2Slots>> & {
+export declare type ReferenceListProps = ComponentProps<Partial<ReferenceListSlots>> & {
     /**
      * The maximum number of references to display before the overflow button is shown even if there is
      * enough space available to show more.
@@ -218,7 +146,7 @@ export declare type ReferenceListV2Props = ComponentProps<Partial<ReferenceListV
     minVisibleReferences?: number;
 };
 
-export declare type ReferenceListV2Slots = {
+export declare type ReferenceListSlots = {
     /** The root of the component that contains the list of references. */
     root: NonNullable<Slot<'div'>>;
     /** The region that contains the references and is used for arrow navigation. */
@@ -229,7 +157,7 @@ export declare type ReferenceListV2Slots = {
     showLessButton?: Slot<'span'>;
 };
 
-export declare type ReferenceListV2State = ComponentState<ReferenceListV2Slots> & Pick<ReferenceListV2Props, 'maxVisibleReferences' | 'minVisibleReferences'> & {
+export declare type ReferenceListState = ComponentState<ReferenceListSlots> & Pick<ReferenceListProps, 'maxVisibleReferences' | 'minVisibleReferences'> & {
     areReferencesExpanded: boolean;
     overflowButtonTriggeredViaKeyboard: React.MutableRefObject<boolean>;
     referenceListRef: React.RefObject<HTMLDivElement>;
@@ -237,6 +165,24 @@ export declare type ReferenceListV2State = ComponentState<ReferenceListV2Slots>
     totalReferencesCount: number;
 };
 
+/** @deprecated use ReferenceList */
+export declare const ReferenceListV2: ForwardRefComponent_2<ReferenceListProps>;
+
+/** @deprecated use referenceListClassNames */
+export declare const referenceListV2ClassNames: SlotClassNames_2<ReferenceListSlots>;
+
+/** @deprecated use ReferenceListContextValues */
+export declare type ReferenceListV2ContextValues = ReferenceListContextValues;
+
+/** @deprecated use ReferenceListProps */
+export declare type ReferenceListV2Props = ReferenceListProps;
+
+/** @deprecated use ReferenceListSlots */
+export declare type ReferenceListV2Slots = ReferenceListSlots;
+
+/** @deprecated use ReferenceListState */
+export declare type ReferenceListV2State = ReferenceListState;
+
 export declare const ReferenceOverflowButton: ForwardRefComponent<ReferenceOverflowButtonProps>;
 
 export declare const referenceOverflowButtonClassNames: SlotClassNames<ReferenceOverflowButtonSlots>;
@@ -266,105 +212,9 @@ export declare type ReferenceOverflowButtonState = ComponentState<ReferenceOverf
     shouldRenderOverflowButton: boolean;
 };
 
-/** deprecated Use ReferenceV2 component, hooks and types instead. */
-export declare type ReferenceProps = ComponentProps<Partial<ReferenceSlots>> & CopilotMode & {
-    /**
-     * Numeric index associated with `Citation`.
-     */
-    index: number;
-    /**
-     * HREF back to the `Citation` this `Reference` is associated with.
-     */
-    citationHref?: string;
-    /**
-     * Unique ID associated with this `Reference`.
-     */
-    referenceId?: string;
-    /**
-     * Text snippet from the reference source.
-     */
-    excerpt?: string;
-    /**
-     * @deprecated Inline layout is the only one that is available, use `Preview` component instead for an equivalent to a `Reference` with a popover layout inside of a `Popover`.
-     */
-    layout?: 'inline' | 'popover';
-};
+export declare type ReferenceProps = ComponentProps<Partial<ReferenceSlots>> & DesignVersion & {};
 
-/** deprecated Use ReferenceV2 component, hooks and types instead. */
 export declare type ReferenceSlots = {
-    /**
-     * The root slot.
-     */
-    root: NonNullable<Slot<'div'>>;
-    /**
-     * Citation slot. Displays a `Citation`. Set the `null` to hide the citation.
-     */
-    citation: Slot<'div'>;
-    /**
-     * Media slot. Used to display Avatars, Icons, etc.
-     */
-    media: Slot<'div'>;
-    /**
-     * Actions slot.
-     */
-    actions: Slot<'div'>;
-    /**
-     * Label slot. Primary description of the reference.
-     */
-    label: NonNullable<Slot<'div'>>;
-    /**
-     * Sensitivity slot. Used to display a `SensitivityLabel`.
-     */
-    sensitivity: Slot<'span'>;
-    /**
-     * Metadata slot. Container for `primaryText`, `secondaryText`, `tertiaryText` and `icon`.
-     */
-    metadata: NonNullable<Slot<'div'>>;
-    /**
-     * Primary text slot. First displayed metadata text.
-     */
-    primaryText: Slot<'span'>;
-    /**
-     * Secondary text slot. Second displayed metadata text.
-     */
-    secondaryText: Slot<'span'>;
-    /**
-     * Tertiary text slot. Third displayed metadata text.
-     */
-    tertiaryText: Slot<'span'>;
-    /**
-     * Icon slot. Icon displayed in metadata area.
-     */
-    icon: Slot<'span'>;
-    /**
-     * Content slot.
-     */
-    content: NonNullable<Slot<'div'>>;
-    /**
-     * Details button slot. Used to expand/collapse the reference.
-     */
-    detailsButton: Slot<typeof Button>;
-};
-
-/** deprecated Use ReferenceV2 component, hooks and types instead. */
-export declare type ReferenceState = ComponentState<ReferenceSlots> & Required<Pick<ReferenceProps, 'mode' | 'layout' | 'index'>> & {
-    /**
-     * State used to renderer the `Reference` in an expanded state.
-     */
-    isExpanded: boolean;
-};
-
-export declare const ReferenceV2: ForwardRefComponent<ReferenceV2Props>;
-
-export declare const referenceV2ClassNames: SlotClassNames<ReferenceV2Slots>;
-
-export declare const referenceV2ExtraClassNames: {
-    graphicChild: string;
-};
-
-export declare type ReferenceV2Props = ComponentProps<Partial<ReferenceV2Slots>> & DesignVersion & {};
-
-export declare type ReferenceV2Slots = {
     /** The root of the component that renders the reference as either a button or an anchor element. */
     root: NonNullable<Slot<'button', 'a'>>;
     /** The number of the citation this reference corresponds to. */
@@ -377,35 +227,50 @@ export declare type ReferenceV2Slots = {
     graphic?: Slot<'span'>;
 };
 
-export declare type ReferenceV2State = ComponentState<ReferenceV2Slots> & Required<Pick<ReferenceV2Props, 'id' | 'designVersion'>> & Pick<ReferenceListV2State, 'shouldUseOverflow'>;
+export declare type ReferenceState = ComponentState<ReferenceSlots> & Required<Pick<ReferenceProps, 'id' | 'designVersion'>> & Pick<ReferenceListState, 'shouldUseOverflow'>;
+
+/** @deprecated use Reference */
+export declare const ReferenceV2: ForwardRefComponent_2<ReferenceProps>;
+
+/** @deprecated use referenceClassNames */
+export declare const referenceV2ClassNames: SlotClassNames_2<ReferenceSlots>;
+
+/** @deprecated use referenceExtraClassNames */
+export declare const referenceV2ExtraClassNames: {
+    graphicChild: string;
+};
+
+/** @deprecated use ReferenceProps */
+export declare type ReferenceV2Props = ReferenceProps;
+
+/** @deprecated use ReferenceSlots */
+export declare type ReferenceV2Slots = ReferenceSlots;
+
+/** @deprecated use ReferenceState */
+export declare type ReferenceV2State = ReferenceState;
 
 /**
  * Render the final JSX of Citation
  */
 export declare const renderCitation_unstable: (state: CitationState) => JSX.Element;
 
-/** deprecated Use ReferenceV2 component, hooks and types instead. */
 export declare const renderReference_unstable: (state: ReferenceState) => JSX.Element;
 
-/**
- * Render the final JSX of ReferenceGroupToggle
- */
-export declare const renderReferenceGroupToggle_unstable: (state: ReferenceGroupToggleState) => JSX.Element;
-
-/** deprecated Use ReferenceListV2 component, hooks and types instead. */
-export declare const renderReferenceList_unstable: (state: ReferenceListState) => JSX.Element;
-
 /**
  * Render the final JSX of ReferenceList
  */
-export declare const renderReferenceListV2_unstable: (state: ReferenceListV2State, contextValues: ReferenceListV2ContextValues) => JSX.Element;
+export declare const renderReferenceList_unstable: (state: ReferenceListState, contextValues: ReferenceListContextValues) => JSX.Element;
+
+/** @deprecated use renderReferenceList_unstable */
+export declare const renderReferenceListV2_unstable: (state: ReferenceListState, contextValues: ReferenceListContextValues) => JSX.Element;
 
 /**
  * Render the final JSX of ReferenceOverflowButton
  */
 export declare const renderReferenceOverflowButton_unstable: (state: ReferenceOverflowButtonState) => JSX.Element | null;
 
-export declare const renderReferenceV2_unstable: (state: ReferenceV2State) => JSX.Element;
+/** @deprecated use renderReference_unstable */
+export declare const renderReferenceV2_unstable: (state: ReferenceState) => JSX.Element;
 
 /**
  * Create the state required to render Citation.
@@ -431,26 +296,10 @@ export declare const useCitationStyles_unstable: (state: CitationState) => Citat
  *
  * @param props - props from this instance of Reference
  * @param ref - reference to root HTMLElement of Reference
- *
- * deprecated Use ReferenceV2 component, hooks and types instead.
- */
-export declare const useReference_unstable: (props: ReferenceProps, ref: React_2.Ref<HTMLDivElement>) => ReferenceState;
-
-export declare type UseReferenceCitationPreview = (data: ReferenceCitationData) => {
-    Citation: PackagedCitation;
-    Reference: PackagedReference;
-};
-
-/**
- * Hook to package a `Citation` and `Reference` together in an
- * accessibly by default manner.
- *
- * When using citations and references, prefer using them via this
- * hook to ensure props are wired up correctly.
  */
-export declare const useReferenceCitationPreview: UseReferenceCitationPreview;
+export declare const useReference_unstable: (props: ReferenceProps, ref: React_2.Ref<HTMLButtonElement | HTMLAnchorElement>) => ReferenceState;
 
-export declare type UseReferenceCitationPreviewV2 = ReferenceCitationPreviewGenerator;
+export declare type UseReferenceCitationPreview = ReferenceCitationPreviewGenerator;
 
 /**
  * Hook to generate a Citation - Reference pair with correctly wired props.
@@ -464,43 +313,18 @@ export declare type UseReferenceCitationPreviewV2 = ReferenceCitationPreviewGene
  *
  * @returns A Citation - Reference pair with correctly wired props.
  */
-export declare const useReferenceCitationPreviewV2: UseReferenceCitationPreviewV2;
+export declare const useReferenceCitationPreview: UseReferenceCitationPreview;
 
-export declare type UseReferenceCitationPreviewV2Props = ReferenceCitationPreviewGeneratorProps;
+export declare type UseReferenceCitationPreviewProps = ReferenceCitationPreviewGeneratorProps;
 
-export declare type UseReferenceGroup = (props: UseReferenceGroupProps) => {
-    referenceGroupToggleProps: ReferenceGroupToggleProps;
-    referenceListProps: ReferenceListProps;
-};
+/** @deprecated use UseReferenceCitationPreview */
+export declare type UseReferenceCitationPreviewV2 = UseReferenceCitationPreview;
 
-/**
- * Hook to package a `ReferenceGroupToggle` and `ReferenceList` together and
- * maintain their `isOpen` state.
- *
- * When rendering a group of references, prefer to use this hook
- * hook to ensure state is maintained correctly
- */
-export declare const useReferenceGroup: UseReferenceGroup;
+/** @deprecated use useReferenceCitationPreview */
+export declare const useReferenceCitationPreviewV2: ReferenceCitationPreviewGenerator;
 
-export declare type UseReferenceGroupProps = {
-    referenceListId?: string;
-};
-
-/**
- * Create the state required to render ReferenceGroupToggle.
- *
- * The returned state can be modified with hooks such as useReferenceGroupToggleStyles_unstable,
- * before being passed to renderReferenceGroupToggle_unstable.
- *
- * @param props - props from this instance of ReferenceGroupToggle
- * @param ref - reference to root HTMLElement of ReferenceGroupToggle
- */
-export declare const useReferenceGroupToggle_unstable: (props: ReferenceGroupToggleProps, ref: React_2.Ref<HTMLButtonElement>) => ReferenceGroupToggleState;
-
-/**
- * Apply styling to the ReferenceGroupToggle slots based on the state
- */
-export declare const useReferenceGroupToggleStyles_unstable: (state: ReferenceGroupToggleState) => ReferenceGroupToggleState;
+/** @deprecated use UseReferenceCitationPreviewProps */
+export declare type UseReferenceCitationPreviewV2Props = UseReferenceCitationPreviewProps;
 
 /**
  * Create the state required to render ReferenceList.
@@ -510,35 +334,21 @@ export declare const useReferenceGroupToggleStyles_unstable: (state: ReferenceGr
  *
  * @param props - props from this instance of ReferenceList
  * @param ref - reference to root HTMLElement of ReferenceList
- *
- * deprecated Use ReferenceListV2 component, hooks and types instead.
  */
-export declare const useReferenceList_unstable: (props: ReferenceListProps, ref: React_2.Ref<HTMLOListElement>) => ReferenceListState;
+export declare const useReferenceList_unstable: (props: ReferenceListProps, ref: React_2.Ref<HTMLDivElement>) => ReferenceListState;
 
 export declare const useReferenceListContext_unstable: <T>(selector: ContextSelector<ReferenceListContextValue, T>) => T;
 
 /**
  * Apply styling to the ReferenceList slots based on the state
- *
- * deprecated Use ReferenceListV2 component, hooks and types instead.
  */
 export declare const useReferenceListStyles_unstable: (state: ReferenceListState) => ReferenceListState;
 
-/**
- * Create the state required to render ReferenceList.
- *
- * The returned state can be modified with hooks such as useReferenceListStyles_unstable,
- * before being passed to renderReferenceList_unstable.
- *
- * @param props - props from this instance of ReferenceList
- * @param ref - reference to root HTMLElement of ReferenceList
- */
-export declare const useReferenceListV2_unstable: (props: ReferenceListV2Props, ref: React_2.Ref<HTMLDivElement>) => ReferenceListV2State;
+/** @deprecated use useReferenceList_unstable */
+export declare const useReferenceListV2_unstable: (props: ReferenceListProps, ref: Ref<HTMLDivElement>) => ReferenceListState;
 
-/**
- * Apply styling to the ReferenceList slots based on the state
- */
-export declare const useReferenceListV2Styles_unstable: (state: ReferenceListV2State) => ReferenceListV2State;
+/** @deprecated use useReferenceListStyles_unstable */
+export declare const useReferenceListV2Styles_unstable: (state: ReferenceListState) => ReferenceListState;
 
 /**
  * Create the state required to render ReferenceOverflowButton.
@@ -558,25 +368,13 @@ export declare const useReferenceOverflowButtonStyles_unstable: (state: Referenc
 
 /**
  * Apply styling to the Reference slots based on the state
- *
- * deprecated Use ReferenceV2 component, hooks and types instead.
  */
 export declare const useReferenceStyles_unstable: (state: ReferenceState) => ReferenceState;
 
-/**
- * Create the state required to render Reference.
- *
- * The returned state can be modified with hooks such as useReferenceStyles_unstable,
- * before being passed to renderReference_unstable.
- *
- * @param props - props from this instance of Reference
- * @param ref - reference to root HTMLElement of Reference
- */
-export declare const useReferenceV2_unstable: (props: ReferenceV2Props, ref: React_2.Ref<HTMLButtonElement | HTMLAnchorElement>) => ReferenceV2State;
+/** @deprecated use useReference_unstable */
+export declare const useReferenceV2_unstable: (props: ReferenceProps, ref: Ref<HTMLAnchorElement | HTMLButtonElement>) => ReferenceState;
 
-/**
- * Apply styling to the Reference slots based on the state
- */
-export declare const useReferenceV2Styles_unstable: (state: ReferenceV2State) => ReferenceV2State;
+/** @deprecated use useReferenceStyles_unstable */
+export declare const useReferenceV2Styles_unstable: (state: ReferenceState) => ReferenceState;
 
 export { }

package/lib/Reference.js.map

@@ -1 +1 @@
-{"version":3,"sources":["Reference.ts"],"sourcesContent":["export type { ReferenceProps, ReferenceSlots, ReferenceState } from './components/Reference/index';\nexport { Reference, referenceClassNames, referenceExtraClassNames, renderReference_unstable, useReferenceStyles_unstable, useReference_unstable } from './components/Reference/index';\n"],"names":["Reference","referenceClassNames","referenceExtraClassNames","renderReference_unstable","useReferenceStyles_unstable","useReference_unstable"],"rangeMappings":"","mappings":"AACA,SAASA,SAAS,EAAEC,mBAAmB,EAAEC,wBAAwB,EAAEC,wBAAwB,EAAEC,2BAA2B,EAAEC,qBAAqB,QAAQ,+BAA+B"}
+{"version":3,"sources":["Reference.ts"],"sourcesContent":["export type { ReferenceProps, ReferenceSlots, ReferenceState } from './components/Reference/index';\nexport {\n  Reference,\n  referenceClassNames,\n  referenceExtraClassNames,\n  renderReference_unstable,\n  useReferenceStyles_unstable,\n  useReference_unstable,\n} from './components/Reference/index';\n"],"names":["Reference","referenceClassNames","referenceExtraClassNames","renderReference_unstable","useReferenceStyles_unstable","useReference_unstable"],"rangeMappings":"","mappings":"AACA,SACEA,SAAS,EACTC,mBAAmB,EACnBC,wBAAwB,EACxBC,wBAAwB,EACxBC,2BAA2B,EAC3BC,qBAAqB,QAChB,+BAA+B"}

package/lib/ReferenceList.js

@@ -1,2 +1,2 @@
-export { ReferenceList, referenceListClassNames, referenceListItemClassName, renderReferenceList_unstable, useReferenceListStyles_unstable, useReferenceList_unstable } from './components/ReferenceList/index';
+export { ReferenceList, referenceListClassNames, renderReferenceList_unstable, useReferenceListStyles_unstable, useReferenceList_unstable } from './components/ReferenceList/index';
 //# sourceMappingURL=ReferenceList.js.map

package/lib/ReferenceList.js.map

@@ -1 +1 @@
-{"version":3,"sources":["ReferenceList.ts"],"sourcesContent":["export type { ReferenceListProps, ReferenceListSlots, ReferenceListState } from './components/ReferenceList/index';\nexport { ReferenceList, referenceListClassNames, referenceListItemClassName, renderReferenceList_unstable, useReferenceListStyles_unstable, useReferenceList_unstable } from './components/ReferenceList/index';\n"],"names":["ReferenceList","referenceListClassNames","referenceListItemClassName","renderReferenceList_unstable","useReferenceListStyles_unstable","useReferenceList_unstable"],"rangeMappings":"","mappings":"AACA,SAASA,aAAa,EAAEC,uBAAuB,EAAEC,0BAA0B,EAAEC,4BAA4B,EAAEC,+BAA+B,EAAEC,yBAAyB,QAAQ,mCAAmC"}
+{"version":3,"sources":["ReferenceList.ts"],"sourcesContent":["export type {\n  ReferenceListContextValues,\n  ReferenceListProps,\n  ReferenceListSlots,\n  ReferenceListState,\n} from './components/ReferenceList/index';\nexport {\n  ReferenceList,\n  referenceListClassNames,\n  renderReferenceList_unstable,\n  useReferenceListStyles_unstable,\n  useReferenceList_unstable,\n} from './components/ReferenceList/index';\n"],"names":["ReferenceList","referenceListClassNames","renderReferenceList_unstable","useReferenceListStyles_unstable","useReferenceList_unstable"],"rangeMappings":"","mappings":"AAMA,SACEA,aAAa,EACbC,uBAAuB,EACvBC,4BAA4B,EAC5BC,+BAA+B,EAC/BC,yBAAyB,QACpB,mCAAmC"}

package/lib/ReferenceOverflowButton.js

@@ -1,2 +1,2 @@
-export { ReferenceOverflowButton, referenceOverflowButtonClassNames, renderReferenceOverflowButton_unstable, useReferenceOverflowButtonStyles_unstable, useReferenceOverflowButton_unstable } from './components/reference-v2/ReferenceOverflowButton/index';
+export { ReferenceOverflowButton, referenceOverflowButtonClassNames, renderReferenceOverflowButton_unstable, useReferenceOverflowButtonStyles_unstable, useReferenceOverflowButton_unstable } from './components/ReferenceOverflowButton/index';
 //# sourceMappingURL=ReferenceOverflowButton.js.map