@fluentui-copilot/react-reference 0.0.0-nightly-20240313-0404-8abc883d.1

package/dist/index.d.ts

@@ -0,0 +1,539 @@
+import type { Button } from '@fluentui/react-components';
+import type { ComponentProps } from '@fluentui/react-components';
+import type { ComponentState } from '@fluentui/react-components';
+import type { ForwardRefComponent } from '@fluentui/react-components';
+import type { OnOpenChangeData } from '@fluentui/react-components';
+import type { OpenPopoverEvents } from '@fluentui/react-components';
+import type { PopoverProps } from '@fluentui/react-components';
+import type { PopoverSurface } from '@fluentui/react-components';
+import type { PopoverSurfaceProps } from '@fluentui/react-components';
+import type { PopoverSurfaceSlots } from '@fluentui/react-components';
+import * as React_2 from 'react';
+import type { Slot } from '@fluentui/react-components';
+import type { SlotClassNames } from '@fluentui/react-components';
+
+export declare const Citation: ForwardRefComponent<CitationProps>;
+
+export declare const citationClassNames: SlotClassNames<CitationSlots>;
+
+/**
+ * Citation Props
+ */
+export declare type CitationProps = ComponentProps<Partial<CitationSlots>> & {
+    /**
+     * HREF to the associated `Reference`.
+     */
+    referenceHref?: string;
+    /**
+     * Whether the citation is a block citation and has no built in margins.
+     * Citations are inline by default with margins to separate them from inline text.
+     */
+    block?: boolean;
+    /**
+     * Unique ID of the associated `Reference`.
+     * @deprecated No longer used.
+     */
+    referenceId?: string;
+};
+
+export declare type CitationSlots = {
+    /**
+     * The root slot.
+     */
+    root: NonNullable<Slot<'a'>>;
+    /**
+     * Popover slot. This will be displayed on hover/focus.
+     *
+     * @deprecated Use `Preview` component and `useReferenceCitationPreview` hook instead.
+     */
+    popover?: Slot<'div'>;
+    /**
+     * PopoverSurface slot. This exposes the underlying PopoverSurface that is displayed on hover/focus.
+     *
+     * @deprecated Use `Preview` component and `useReferenceCitationPreview` hook instead.
+     */
+    popoverSurface: Slot<typeof PopoverSurface>;
+};
+
+/**
+ * State used in rendering Citation
+ */
+export declare type CitationState = ComponentState<CitationSlots> & Required<Pick<CitationProps, 'block'>> & {
+    disableAutoFocus: boolean;
+    isPopoverOpen: boolean;
+    isPopoverLocked: boolean;
+    onPopoverOpenChange: (e: OpenPopoverEvents, data: OnOpenChangeData) => void;
+};
+
+declare type CopilotMode = {
+    mode?: 'canvas' | 'sidecar';
+};
+
+/**
+ * A "packaged Citation". A packaged Citation is a `Citation` that is
+ * pre-packaged with props set by the `useReferenceCitation` hook.
+ *
+ * @deprecated Use `useReferenceCitationPreview` hook instead.
+ */
+export declare type PackagedCitation = React_2.FC<PackagedCitationProps>;
+
+/**
+ * A "packaged Citation". A packaged Citation is a `Citation` that is
+ * pre-packaged with props set by the `useReferenceCitation` hook.
+ */
+declare type PackagedCitation_2 = React_2.FC<PackagedCitationProps_2>;
+
+/**
+ * @deprecated Use `useReferenceCitationPreview` hook instead.
+ */
+declare type PackagedCitationPopover = React_2.FC<PackagedCitationPopoverProps>;
+
+/**
+ * @deprecated Use `useReferenceCitationPreview` hook instead.
+ */
+declare type PackagedCitationPopoverProps = Omit<PackagedReferenceProps, 'layout'>;
+
+/**
+ * Props for a "packaged Citation". A packaged Citation is a `Citation` that is
+ * pre-packaged with props set by the `useReferenceCitation` hook.
+ *
+ * @deprecated Use `useReferenceCitationPreview` hook instead.
+ */
+export declare type PackagedCitationProps = Omit<CitationProps, PartialCitationProps> & Partial<Pick<CitationProps, PartialCitationProps>>;
+
+/**
+ * Props for a "packaged Citation". A packaged Citation is a `Citation` that is
+ * pre-packaged with props set by the `useReferenceCitation` hook.
+ */
+declare type PackagedCitationProps_2 = Omit<CitationProps, PartialCitationProps_2 | 'popover' | 'popoverSurface'> & Partial<Pick<CitationProps, PartialCitationProps_2>>;
+
+/**
+ * A "packaged Reference". A packaged Reference is a `Reference` that is
+ * pre-packaged with props set by the `useReferenceCitation` hook.
+ *
+ * @deprecated Use `useReferenceCitationPreview` hook instead.
+ */
+export declare type PackagedReference = React_2.FC<PackagedReferenceProps>;
+
+/**
+ * A "packaged Reference". A packaged Reference is a `Reference` that is
+ * pre-packaged with props set by the `useReferenceCitation` hook.
+ */
+declare type PackagedReference_2 = React_2.FC<PackagedReferenceProps_2>;
+
+/**
+ * Props for a "packaged Reference". A packaged Reference is a `Reference` that is
+ * pre-packaged with props set by the `useReferenceCitation` hook.
+ *
+ * @deprecated Use `useReferenceCitationPreview` hook instead.
+ */
+export declare type PackagedReferenceProps = Omit<ReferenceProps, PartialReferenceProps> & Partial<Pick<ReferenceProps, PartialReferenceProps>>;
+
+/**
+ * Props for a "packaged Reference". A packaged Reference is a `Reference` that is
+ * pre-packaged with props set by the `useReferenceCitation` hook.
+ */
+declare type PackagedReferenceProps_2 = Omit<ReferenceProps, PartialReferenceProps_2> & Partial<Pick<ReferenceProps, PartialReferenceProps_2>>;
+
+declare type PartialCitationProps = 'referenceHref' | 'referenceId';
+
+declare type PartialCitationProps_2 = 'referenceHref' | 'referenceId';
+
+declare type PartialReferenceProps = 'citationHref' | 'index' | 'referenceId';
+
+declare type PartialReferenceProps_2 = 'citationHref' | 'index' | 'referenceId';
+
+/**
+ * Preview Props
+ */
+declare type PreviewProps = PopoverProps;
+
+/**
+ * PreviewSurface Props
+ */
+declare type PreviewSurfaceProps = ComponentProps<PreviewSurfaceSlots> & PopoverSurfaceProps & {};
+
+declare type PreviewSurfaceSlots = PopoverSurfaceSlots & {};
+
+export declare const Reference: ForwardRefComponent<ReferenceProps>;
+
+/**
+ * Data used to package a `Citation` and `Reference` together with
+ * the `useReferenceCitation` hook.
+ *
+ * @deprecated Use `useReferenceCitationPreview` hook instead.
+ */
+export declare type ReferenceCitationData = {
+    index: number;
+    referenceId?: string;
+    citationId?: string;
+    citationProps?: PackagedCitationProps;
+    referenceProps?: PackagedReferenceProps;
+    popoverProps?: PackagedCitationPopoverProps;
+};
+
+/**
+ * Data used to package a `Citation` and `Reference` together with
+ * the `useReferenceCitation` hook.
+ */
+declare type ReferenceCitationData_2 = {
+    index: number;
+    referenceId?: string;
+    citationId?: string;
+    citationProps?: PackagedCitationProps_2;
+    referenceProps?: PackagedReferenceProps_2;
+    previewProps?: PreviewProps;
+    previewSurfaceProps?: PreviewSurfaceProps;
+};
+
+export declare const referenceClassNames: SlotClassNames<ReferenceSlots>;
+
+/**
+ * ReferenceGroup component
+ * @deprecated use `useReferenceGroup` instead.
+ */
+export declare const ReferenceGroup: ForwardRefComponent<ReferenceGroupProps>;
+
+export declare const referenceGroupClassNames: SlotClassNames<ReferenceGroupSlots>;
+
+declare type ReferenceGroupContext = {
+    open?: boolean;
+    setOpen: () => void;
+};
+
+/**
+ * ReferenceGroup Props
+ */
+export declare type ReferenceGroupProps = ComponentProps<Partial<ReferenceGroupSlots>, 'content'> & CopilotMode;
+
+export declare type ReferenceGroupSlots = {
+    /**
+     * The root slot.
+     */
+    root: NonNullable<Slot<'div'>>;
+    /**
+     * Label slot. Primary description of the group.
+     */
+    label: NonNullable<Slot<'span'>>;
+    /**
+     * Icon slot.
+     */
+    icon: Slot<'span'>;
+    /**
+     * Details button slot. Used to expand/collapse the group.
+     */
+    detailsButton: NonNullable<Slot<'button'>>;
+    /**
+     * Content slot. Used to display the group's references. Visibility should be controlled by `detailsButton`.
+     */
+    content: NonNullable<Slot<'div'>>;
+};
+
+/**
+ * State used in rendering ReferenceGroup
+ */
+export declare type ReferenceGroupState = ComponentState<ReferenceGroupSlots> & Required<Pick<ReferenceGroupProps, 'mode'>> & {
+    /**
+     * State to track if the group is open or not.
+     */
+    isOpen: boolean;
+    /**
+     * Callback used to open the group from a child.
+     * @returns void
+     */
+    setOpen: () => void;
+};
+
+export declare const ReferenceGroupToggle: ForwardRefComponent<ReferenceGroupToggleProps>;
+
+export declare const referenceGroupToggleClassNames: SlotClassNames<ReferenceGroupToggleSlots>;
+
+/**
+ * ReferenceGroupToggle Props
+ */
+export declare type ReferenceGroupToggleProps = ComponentProps<ReferenceGroupToggleSlots> & {
+    isOpen?: boolean;
+};
+
+export declare type ReferenceGroupToggleSlots = {
+    root: NonNullable<Slot<'button'>>;
+    icon?: Slot<'span'>;
+};
+
+/**
+ * State used in rendering ReferenceGroupToggle
+ */
+export declare type ReferenceGroupToggleState = ComponentState<ReferenceGroupToggleSlots> & Required<Pick<ReferenceGroupToggleProps, 'isOpen'>>;
+
+export declare const ReferenceList: ForwardRefComponent<ReferenceListProps>;
+
+export declare const referenceListClassNames: SlotClassNames<ReferenceListSlots>;
+
+/**
+ * ReferenceList Props
+ */
+export declare type ReferenceListProps = ComponentProps<ReferenceListSlots>;
+
+export declare type ReferenceListSlots = {
+    /**
+     * The root slot.
+     */
+    root: Slot<'ol'>;
+};
+
+/**
+ * State used in rendering ReferenceList
+ */
+export declare type ReferenceListState = ComponentState<ReferenceListSlots>;
+
+/**
+ * Reference Props
+ */
+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;
+    layout?: 'inline' | 'popover';
+};
+
+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'>;
+    /**
+     * @deprecated Use `sensitivity` instead.
+     * Sensitivity label slot. Displays a label indicating how sensitive the information displayed in the reference is.
+     */
+    sensitivityLabel: 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>;
+};
+
+/**
+ * State used in rendering Reference
+ */
+export declare type ReferenceState = ComponentState<ReferenceSlots> & Required<Pick<ReferenceProps, 'mode' | 'layout' | 'index'>> & {
+    /**
+     * State used to renderer the `Reference` in an expanded state.
+     */
+    isExpanded: boolean;
+};
+
+/**
+ * Render the final JSX of Citation
+ */
+export declare const renderCitation_unstable: (state: CitationState) => JSX.Element;
+
+/**
+ * Render the final JSX of Reference
+ */
+export declare const renderReference_unstable: (state: ReferenceState) => JSX.Element;
+
+/**
+ * Render the final JSX of ReferenceGroup
+ */
+export declare const renderReferenceGroup_unstable: (state: ReferenceGroupState, contextValues: ReferenceGroupContext) => JSX.Element;
+
+/**
+ * Render the final JSX of ReferenceGroupToggle
+ */
+export declare const renderReferenceGroupToggle_unstable: (state: ReferenceGroupToggleState) => JSX.Element;
+
+/**
+ * Render the final JSX of ReferenceList
+ */
+export declare const renderReferenceList_unstable: (state: ReferenceListState) => JSX.Element;
+
+/**
+ * Create the state required to render Citation.
+ *
+ * The returned state can be modified with hooks such as useCitationStyles_unstable,
+ * before being passed to renderCitation_unstable.
+ *
+ * @param props - props from this instance of Citation
+ * @param ref - reference to root HTMLElement of Citation
+ */
+export declare const useCitation_unstable: (props: CitationProps, ref: React_2.Ref<HTMLElement>) => CitationState;
+
+/**
+ * Apply styling to the Citation slots based on the state
+ */
+export declare const useCitationStyles_unstable: (state: CitationState) => CitationState;
+
+/**
+ * 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 useReference_unstable: (props: ReferenceProps, ref: React_2.Ref<HTMLElement>) => ReferenceState;
+
+/**
+ * @deprecated Use `useReferenceCitationPreview` hook instead.
+ */
+export declare type UseReferenceCitation = (data: ReferenceCitationData) => {
+    Citation: PackagedCitation;
+    Reference: PackagedReference;
+    Popover: PackagedCitationPopover;
+};
+
+/**
+ * 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.
+ *
+ * @deprecated Use `useReferenceCitationPreview` hook instead.
+ */
+export declare const useReferenceCitation: UseReferenceCitation;
+
+export declare type UseReferenceCitationPreview = (data: ReferenceCitationData_2) => {
+    Citation: PackagedCitation_2;
+    Reference: PackagedReference_2;
+};
+
+/**
+ * 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 type UseReferenceGroup = (props: UseReferenceGroupProps) => {
+    referenceGroupToggleProps: ReferenceGroupToggleProps;
+    referenceListProps: ReferenceListProps;
+};
+
+/**
+ * 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;
+
+/**
+ * Create the state required to render ReferenceGroup.
+ *
+ * The returned state can be modified with hooks such as useReferenceGroupStyles_unstable,
+ * before being passed to renderReferenceGroup_unstable.
+ *
+ * @param props - props from this instance of ReferenceGroup
+ * @param ref - reference to root HTMLElement of ReferenceGroup
+ */
+export declare const useReferenceGroup_unstable: (props: ReferenceGroupProps, ref: React_2.Ref<HTMLElement>) => ReferenceGroupState;
+
+export declare type UseReferenceGroupProps = {
+    referenceListId?: string;
+};
+
+/**
+ * Apply styling to the ReferenceGroup slots based on the state
+ */
+export declare const useReferenceGroupStyles_unstable: (state: ReferenceGroupState) => ReferenceGroupState;
+
+/**
+ * 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;
+
+/**
+ * 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 useReferenceList_unstable: (props: ReferenceListProps, ref: React_2.Ref<HTMLElement>) => ReferenceListState;
+
+/**
+ * Apply styling to the ReferenceList slots based on the state
+ */
+export declare const useReferenceListStyles_unstable: (state: ReferenceListState) => ReferenceListState;
+
+/**
+ * Apply styling to the Reference slots based on the state
+ */
+export declare const useReferenceStyles_unstable: (state: ReferenceState) => ReferenceState;
+
+export { }

package/lib/Citation.js

@@ -0,0 +1,2 @@
+export * from './components/Citation/index';
+//# sourceMappingURL=Citation.js.map

package/lib/Citation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["Citation.ts"],"sourcesContent":["export * from './components/Citation/index';\n"],"names":[],"mappings":"AAAA,cAAc,8BAA8B"}

package/lib/Reference.js

@@ -0,0 +1,2 @@
+export * from './components/Reference/index';
+//# sourceMappingURL=Reference.js.map

package/lib/Reference.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["Reference.ts"],"sourcesContent":["export * from './components/Reference/index';\n"],"names":[],"mappings":"AAAA,cAAc,+BAA+B"}

package/lib/ReferenceGroup.js

@@ -0,0 +1,2 @@
+export * from './components/ReferenceGroup/index';
+//# sourceMappingURL=ReferenceGroup.js.map

package/lib/ReferenceGroup.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["ReferenceGroup.ts"],"sourcesContent":["export * from './components/ReferenceGroup/index';\n"],"names":[],"mappings":"AAAA,cAAc,oCAAoC"}

package/lib/ReferenceGroupToggle.js

@@ -0,0 +1,2 @@
+export * from './components/ReferenceGroupToggle/index';
+//# sourceMappingURL=ReferenceGroupToggle.js.map

package/lib/ReferenceGroupToggle.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["ReferenceGroupToggle.ts"],"sourcesContent":["export * from './components/ReferenceGroupToggle/index';\n"],"names":[],"mappings":"AAAA,cAAc,0CAA0C"}

package/lib/ReferenceList.js

@@ -0,0 +1,2 @@
+export * from './components/ReferenceList/index';
+//# sourceMappingURL=ReferenceList.js.map

package/lib/ReferenceList.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["ReferenceList.ts"],"sourcesContent":["export * from './components/ReferenceList/index';\n"],"names":[],"mappings":"AAAA,cAAc,mCAAmC"}

package/lib/components/Citation/Citation.js

@@ -0,0 +1,14 @@
+import * as React from 'react';
+import { useCitation_unstable } from './useCitation';
+import { renderCitation_unstable } from './renderCitation';
+import { useCitationStyles_unstable } from './useCitationStyles';
+import { useCustomStyleHook } from '@fluentui-copilot/react-provider';
+// Citation component - TODO: add more docs
+export const Citation = /*#__PURE__*/React.forwardRef((props, ref) => {
+  const state = useCitation_unstable(props, ref);
+  useCitationStyles_unstable(state);
+  useCustomStyleHook('useCitationStyles')(state);
+  return renderCitation_unstable(state);
+});
+Citation.displayName = 'Citation';
+//# sourceMappingURL=Citation.js.map

package/lib/components/Citation/Citation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["Citation.tsx"],"sourcesContent":["import * as React from 'react';\nimport { useCitation_unstable } from './useCitation';\nimport { renderCitation_unstable } from './renderCitation';\nimport { useCitationStyles_unstable } from './useCitationStyles';\nimport type { CitationProps } from './Citation.types';\nimport type { ForwardRefComponent } from '@fluentui/react-components';\nimport { useCustomStyleHook } from '@fluentui-copilot/react-provider';\n\n// Citation component - TODO: add more docs\nexport const Citation: ForwardRefComponent<CitationProps> = React.forwardRef((props, ref) => {\n  const state = useCitation_unstable(props, ref);\n\n  useCitationStyles_unstable(state);\n  useCustomStyleHook('useCitationStyles')(state);\n\n  return renderCitation_unstable(state);\n});\n\nCitation.displayName = 'Citation';\n"],"names":["React","useCitation_unstable","renderCitation_unstable","useCitationStyles_unstable","useCustomStyleHook","Citation","forwardRef","props","ref","state","displayName"],"mappings":"AAAA,YAAYA,WAAW,QAAQ;AAC/B,SAASC,oBAAoB,QAAQ,gBAAgB;AACrD,SAASC,uBAAuB,QAAQ,mBAAmB;AAC3D,SAASC,0BAA0B,QAAQ,sBAAsB;AAGjE,SAASC,kBAAkB,QAAQ,mCAAmC;AAEtE,2CAA2C;AAC3C,OAAO,MAAMC,yBAA+CL,MAAMM,UAAU,CAAC,CAACC,OAAOC;IACnF,MAAMC,QAAQR,qBAAqBM,OAAOC;IAE1CL,2BAA2BM;IAC3BL,mBAAmB,qBAAqBK;IAExC,OAAOP,wBAAwBO;AACjC,GAAG;AAEHJ,SAASK,WAAW,GAAG"}

package/lib/components/Citation/Citation.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Citation.types.js.map

package/lib/components/Citation/Citation.types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["Citation.types.ts"],"sourcesContent":["import type {\n  ComponentProps,\n  ComponentState,\n  OnOpenChangeData,\n  OpenPopoverEvents,\n  PopoverSurface,\n  Slot,\n} from '@fluentui/react-components';\n\nexport type CitationSlots = {\n  /**\n   * The root slot.\n   */\n  root: NonNullable<Slot<'a'>>;\n\n  /**\n   * Popover slot. This will be displayed on hover/focus.\n   *\n   * @deprecated Use `Preview` component and `useReferenceCitationPreview` hook instead.\n   */\n  popover?: Slot<'div'>;\n\n  /**\n   * PopoverSurface slot. This exposes the underlying PopoverSurface that is displayed on hover/focus.\n   *\n   * @deprecated Use `Preview` component and `useReferenceCitationPreview` hook instead.\n   */\n  popoverSurface: Slot<typeof PopoverSurface>;\n};\n\n/**\n * Citation Props\n */\nexport type CitationProps = ComponentProps<Partial<CitationSlots>> & {\n  /**\n   * HREF to the associated `Reference`.\n   */\n  referenceHref?: string;\n\n  /**\n   * Whether the citation is a block citation and has no built in margins.\n   * Citations are inline by default with margins to separate them from inline text.\n   */\n  block?: boolean;\n\n  /**\n   * Unique ID of the associated `Reference`.\n   * @deprecated No longer used.\n   */\n  referenceId?: string;\n};\n\n/**\n * State used in rendering Citation\n */\nexport type CitationState = ComponentState<CitationSlots> &\n  Required<Pick<CitationProps, 'block'>> & {\n    disableAutoFocus: boolean;\n    isPopoverOpen: boolean;\n    isPopoverLocked: boolean;\n    onPopoverOpenChange: (e: OpenPopoverEvents, data: OnOpenChangeData) => void;\n  };\n"],"names":[],"mappings":"AAAA,WA6DI"}

package/lib/components/Citation/index.js

@@ -0,0 +1,6 @@
+export * from './Citation';
+export * from './Citation.types';
+export * from './renderCitation';
+export * from './useCitation';
+export * from './useCitationStyles';
+//# sourceMappingURL=index.js.map

package/lib/components/Citation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["index.ts"],"sourcesContent":["export * from './Citation';\nexport * from './Citation.types';\nexport * from './renderCitation';\nexport * from './useCitation';\nexport * from './useCitationStyles';\n"],"names":[],"mappings":"AAAA,cAAc,aAAa;AAC3B,cAAc,mBAAmB;AACjC,cAAc,mBAAmB;AACjC,cAAc,gBAAgB;AAC9B,cAAc,sBAAsB"}

package/lib/components/Citation/renderCitation.js

@@ -0,0 +1,29 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@fluentui/react-jsx-runtime/jsx-runtime";
+import { Popover, PopoverTrigger, assertSlots } from '@fluentui/react-components';
+const popoverPositioning = {
+  overflowBoundaryPadding: 4,
+  position: 'below'
+};
+/**
+ * Render the final JSX of Citation
+ */
+export const renderCitation_unstable = state => {
+  assertSlots(state);
+  return state.popover && state.popoverSurface ? /*#__PURE__*/_jsxs(Popover, {
+    closeOnScroll: true,
+    onOpenChange: state.onPopoverOpenChange,
+    open: state.isPopoverOpen,
+    positioning: popoverPositioning,
+    size: "small",
+    trapFocus: true,
+    unstable_disableAutoFocus: state.disableAutoFocus,
+    withArrow: true,
+    children: [/*#__PURE__*/_jsx(PopoverTrigger, {
+      disableButtonEnhancement: true,
+      children: /*#__PURE__*/_jsx(state.root, {})
+    }), /*#__PURE__*/_jsx(state.popoverSurface, {
+      children: /*#__PURE__*/_jsx(state.popover, {})
+    })]
+  }) : /*#__PURE__*/_jsx(state.root, {});
+};
+//# sourceMappingURL=renderCitation.js.map

package/lib/components/Citation/renderCitation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["renderCitation.tsx"],"sourcesContent":["/** @jsxRuntime automatic */\n/** @jsxImportSource @fluentui/react-jsx-runtime */\n\nimport { Popover, PopoverTrigger, assertSlots } from '@fluentui/react-components';\nimport type { PositioningProps } from '@fluentui/react-components';\nimport type { CitationState, CitationSlots } from './Citation.types';\n\nconst popoverPositioning: PositioningProps = {\n  overflowBoundaryPadding: 4,\n  position: 'below',\n};\n\n/**\n * Render the final JSX of Citation\n */\nexport const renderCitation_unstable = (state: CitationState) => {\n  assertSlots<CitationSlots>(state);\n\n  return state.popover && state.popoverSurface ? (\n    <Popover\n      closeOnScroll\n      onOpenChange={state.onPopoverOpenChange}\n      open={state.isPopoverOpen}\n      positioning={popoverPositioning}\n      size=\"small\"\n      trapFocus\n      unstable_disableAutoFocus={state.disableAutoFocus}\n      withArrow\n    >\n      <PopoverTrigger disableButtonEnhancement>\n        <state.root />\n      </PopoverTrigger>\n      <state.popoverSurface>\n        <state.popover />\n      </state.popoverSurface>\n    </Popover>\n  ) : (\n    <state.root />\n  );\n};\n"],"names":["Popover","PopoverTrigger","assertSlots","popoverPositioning","overflowBoundaryPadding","position","renderCitation_unstable","state","popover","popoverSurface","closeOnScroll","onOpenChange","onPopoverOpenChange","open","isPopoverOpen","positioning","size","trapFocus","unstable_disableAutoFocus","disableAutoFocus","withArrow","disableButtonEnhancement","root"],"mappings":"AAAA,0BAA0B,GAC1B,iDAAiD;AAEjD,SAASA,OAAO,EAAEC,cAAc,EAAEC,WAAW,QAAQ,6BAA6B;AAIlF,MAAMC,qBAAuC;IAC3CC,yBAAyB;IACzBC,UAAU;AACZ;AAEA;;CAEC,GACD,OAAO,MAAMC,0BAA0B,CAACC;IACtCL,YAA2BK;IAE3B,OAAOA,MAAMC,OAAO,IAAID,MAAME,cAAc,iBAC1C,MAACT;QACCU,aAAa;QACbC,cAAcJ,MAAMK,mBAAmB;QACvCC,MAAMN,MAAMO,aAAa;QACzBC,aAAaZ;QACba,MAAK;QACLC,SAAS;QACTC,2BAA2BX,MAAMY,gBAAgB;QACjDC,SAAS;;0BAET,KAACnB;gBAAeoB,wBAAwB;0BACtC,cAAA,KAACd,MAAMe,IAAI;;0BAEb,KAACf,MAAME,cAAc;0BACnB,cAAA,KAACF,MAAMC,OAAO;;;uBAIlB,KAACD,MAAMe,IAAI;AAEf,EAAE"}