@mieweb/ui 0.7.3 → 0.8.0-dev.1

package/dist/components/ReadingProgressBar/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/components/RichTextEditor/index.cjs

@@ -1,13 +1,14 @@
 'use strict';
 
-var chunkURHXR5SC_cjs = require('../../chunk-URHXR5SC.cjs');
+var chunkTQZPYDUL_cjs = require('../../chunk-TQZPYDUL.cjs');
 require('../../chunk-YP5T6NZD.cjs');
-require('../../chunk-RBS3GHDZ.cjs');
-require('../../chunk-6ECKH4DJ.cjs');
+require('../../chunk-QOJ4V7YX.cjs');
+require('../../chunk-I44YNYI6.cjs');
+require('../../chunk-Z5S5JEJD.cjs');
 require('../../chunk-RDGRKYQ5.cjs');
 require('../../chunk-FHY3K6PL.cjs');
 require('../../chunk-FSGEDDF2.cjs');
-require('../../chunk-MYFZYUPR.cjs');
+require('../../chunk-AOHJILLU.cjs');
 var chunkC7RVKV25_cjs = require('../../chunk-C7RVKV25.cjs');
 require('../../chunk-S5RVSXDV.cjs');
 
@@ -15,15 +16,15 @@ require('../../chunk-S5RVSXDV.cjs');
 
 Object.defineProperty(exports, "RichTextEditor", {
   enumerable: true,
-  get: function () { return chunkURHXR5SC_cjs.RichTextEditor; }
+  get: function () { return chunkTQZPYDUL_cjs.RichTextEditor; }
 });
 Object.defineProperty(exports, "convertAngleBracketsToMustache", {
   enumerable: true,
-  get: function () { return chunkURHXR5SC_cjs.convertAngleBracketsToMustache; }
+  get: function () { return chunkTQZPYDUL_cjs.convertAngleBracketsToMustache; }
 });
 Object.defineProperty(exports, "processDictation", {
   enumerable: true,
-  get: function () { return chunkURHXR5SC_cjs.processDictation; }
+  get: function () { return chunkTQZPYDUL_cjs.processDictation; }
 });
 Object.defineProperty(exports, "isHtmlEmpty", {
   enumerable: true,

package/dist/components/RichTextEditor/index.js

@@ -1,11 +1,12 @@
-export { RichTextEditor, convertAngleBracketsToMustache, processDictation } from '../../chunk-FTRGZOVJ.js';
+export { RichTextEditor, convertAngleBracketsToMustache, processDictation } from '../../chunk-JQQABHDN.js';
 import '../../chunk-OQWZYKJM.js';
-import '../../chunk-HIDV32ZX.js';
-import '../../chunk-YXCE2HSK.js';
+import '../../chunk-AHUYW673.js';
+import '../../chunk-6NZXWKUE.js';
+import '../../chunk-3IMM2PM4.js';
 import '../../chunk-D2GID3YK.js';
 import '../../chunk-T4ME7QCT.js';
 import '../../chunk-62ZOA6PX.js';
-import '../../chunk-BOOJDRJO.js';
+import '../../chunk-WSNMQQ4P.js';
 export { isHtmlEmpty } from '../../chunk-ERLPVXOV.js';
 import '../../chunk-TQONQSJO.js';
 //# sourceMappingURL=index.js.map

package/dist/components/SectionSpyNav/index.cjs

@@ -0,0 +1,15 @@
+'use strict';
+
+var chunk5JZIDILK_cjs = require('../../chunk-5JZIDILK.cjs');
+require('../../chunk-RDGRKYQ5.cjs');
+require('../../chunk-7IKLGH3Z.cjs');
+require('../../chunk-S5RVSXDV.cjs');
+
+
+
+Object.defineProperty(exports, "SectionSpyNav", {
+  enumerable: true,
+  get: function () { return chunk5JZIDILK_cjs.SectionSpyNav; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/components/SectionSpyNav/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/components/SectionSpyNav/index.d.cts

@@ -0,0 +1,63 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+/** One section the nav links to. The id must match a `section[id]` on the page. */
+interface SectionSpyItem {
+    id: string;
+    label: string;
+}
+/**
+ * Funnel intent for the bar's single contextual CTA — drives its visual
+ * weight so the in-page strip never out-shouts a page's primary CTA:
+ * `explore` (quiet next step) → `evaluate` (sales-ready ask) → `commit`
+ * (high-intent action).
+ */
+type SectionSpyCtaTier = 'explore' | 'evaluate' | 'commit';
+interface SectionSpyCta {
+    label: string;
+    href: string;
+    tier?: SectionSpyCtaTier;
+}
+interface SectionSpyNavProps {
+    /** Sections to link to, in page order. */
+    items: SectionSpyItem[];
+    /** Optional single page-specific next-step CTA at the end of the bar. */
+    cta?: SectionSpyCta;
+    /** Eyebrow before the links (default "On this page"). */
+    label?: string;
+    /**
+     * Visual tone: `surface` sits on the page background; `brand` renders the
+     * inverted primary band.
+     */
+    tone?: 'surface' | 'brand';
+    /** IntersectionObserver root margin tuning for the scroll spy. */
+    rootMargin?: string;
+    /** Called with the section id when a nav link is clicked. */
+    onItemClick?: (id: string) => void;
+    /** Called when the CTA is clicked (e.g. for analytics). */
+    onCtaClick?: (cta: SectionSpyCta) => void;
+    className?: string;
+}
+/**
+ * Sticky horizontal in-page wayfinding: jumps between a page's major
+ * sections, highlights the one in view with a sliding underline, and can
+ * carry a single page-specific next-step CTA. Pure anchor links, so it
+ * still works if the scroll spy never runs.
+ *
+ * The horizontal complement to `TableOfContents` — use that for a sidebar
+ * outline, this for a band under the page header. Section elements need
+ * matching `id`s.
+ *
+ * @example
+ * ```tsx
+ * <SectionSpyNav
+ *   items={[
+ *     { id: 'overview', label: 'Overview' },
+ *     { id: 'pricing', label: 'Pricing' },
+ *   ]}
+ *   cta={{ label: 'Book a demo', href: '/demo', tier: 'evaluate' }}
+ * />
+ * ```
+ */
+declare function SectionSpyNav({ items, cta, label, tone, rootMargin, onItemClick, onCtaClick, className, }: SectionSpyNavProps): react_jsx_runtime.JSX.Element;
+
+export { type SectionSpyCta, type SectionSpyCtaTier, type SectionSpyItem, SectionSpyNav, type SectionSpyNavProps };

package/dist/components/SectionSpyNav/index.d.ts

@@ -0,0 +1,63 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+/** One section the nav links to. The id must match a `section[id]` on the page. */
+interface SectionSpyItem {
+    id: string;
+    label: string;
+}
+/**
+ * Funnel intent for the bar's single contextual CTA — drives its visual
+ * weight so the in-page strip never out-shouts a page's primary CTA:
+ * `explore` (quiet next step) → `evaluate` (sales-ready ask) → `commit`
+ * (high-intent action).
+ */
+type SectionSpyCtaTier = 'explore' | 'evaluate' | 'commit';
+interface SectionSpyCta {
+    label: string;
+    href: string;
+    tier?: SectionSpyCtaTier;
+}
+interface SectionSpyNavProps {
+    /** Sections to link to, in page order. */
+    items: SectionSpyItem[];
+    /** Optional single page-specific next-step CTA at the end of the bar. */
+    cta?: SectionSpyCta;
+    /** Eyebrow before the links (default "On this page"). */
+    label?: string;
+    /**
+     * Visual tone: `surface` sits on the page background; `brand` renders the
+     * inverted primary band.
+     */
+    tone?: 'surface' | 'brand';
+    /** IntersectionObserver root margin tuning for the scroll spy. */
+    rootMargin?: string;
+    /** Called with the section id when a nav link is clicked. */
+    onItemClick?: (id: string) => void;
+    /** Called when the CTA is clicked (e.g. for analytics). */
+    onCtaClick?: (cta: SectionSpyCta) => void;
+    className?: string;
+}
+/**
+ * Sticky horizontal in-page wayfinding: jumps between a page's major
+ * sections, highlights the one in view with a sliding underline, and can
+ * carry a single page-specific next-step CTA. Pure anchor links, so it
+ * still works if the scroll spy never runs.
+ *
+ * The horizontal complement to `TableOfContents` — use that for a sidebar
+ * outline, this for a band under the page header. Section elements need
+ * matching `id`s.
+ *
+ * @example
+ * ```tsx
+ * <SectionSpyNav
+ *   items={[
+ *     { id: 'overview', label: 'Overview' },
+ *     { id: 'pricing', label: 'Pricing' },
+ *   ]}
+ *   cta={{ label: 'Book a demo', href: '/demo', tier: 'evaluate' }}
+ * />
+ * ```
+ */
+declare function SectionSpyNav({ items, cta, label, tone, rootMargin, onItemClick, onCtaClick, className, }: SectionSpyNavProps): react_jsx_runtime.JSX.Element;
+
+export { type SectionSpyCta, type SectionSpyCtaTier, type SectionSpyItem, SectionSpyNav, type SectionSpyNavProps };

package/dist/components/SectionSpyNav/index.js

@@ -0,0 +1,6 @@
+export { SectionSpyNav } from '../../chunk-JHZW3Y62.js';
+import '../../chunk-D2GID3YK.js';
+import '../../chunk-WBGUYSWY.js';
+import '../../chunk-TQONQSJO.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/components/SectionSpyNav/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/components/Select/index.cjs

@@ -1,20 +1,22 @@
 'use strict';
 
-var chunkZBI52NP2_cjs = require('../../chunk-ZBI52NP2.cjs');
+var chunkK5GQPTTA_cjs = require('../../chunk-K5GQPTTA.cjs');
+require('../../chunk-I44YNYI6.cjs');
+require('../../chunk-Z5S5JEJD.cjs');
 require('../../chunk-FHY3K6PL.cjs');
 require('../../chunk-FSGEDDF2.cjs');
-require('../../chunk-MYFZYUPR.cjs');
+require('../../chunk-AOHJILLU.cjs');
 require('../../chunk-S5RVSXDV.cjs');
 
 
 
 Object.defineProperty(exports, "Select", {
   enumerable: true,
-  get: function () { return chunkZBI52NP2_cjs.Select; }
+  get: function () { return chunkK5GQPTTA_cjs.Select; }
 });
 Object.defineProperty(exports, "selectTriggerVariants", {
   enumerable: true,
-  get: function () { return chunkZBI52NP2_cjs.selectTriggerVariants; }
+  get: function () { return chunkK5GQPTTA_cjs.selectTriggerVariants; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/components/Select/index.d.cts

@@ -1,6 +1,8 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
+import { RequiredMarkVariant } from '../Input/index.cjs';
+import 'react';
 
 interface SelectOption {
     /** Unique value for the option */
@@ -21,16 +23,16 @@ interface SelectGroup {
 declare const selectTriggerVariants: (props?: ({
     size?: "sm" | "md" | "lg" | null | undefined;
     hasError?: boolean | null | undefined;
+    labelVariant?: "stacked" | "floating" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
-interface SelectProps extends VariantProps<typeof selectTriggerVariants> {
+/**
+ * Props shared by both single- and multiple-selection modes. Exported so
+ * wrapper components can extend the common shape (`SelectProps` itself is a
+ * discriminated union, which interfaces cannot extend).
+ */
+interface SelectBaseProps extends Omit<VariantProps<typeof selectTriggerVariants>, 'labelVariant'> {
     /** Array of options or groups */
     options: (SelectOption | SelectGroup)[];
-    /** Controlled value */
-    value?: string;
-    /** Default value (uncontrolled) */
-    defaultValue?: string;
-    /** Callback when value changes */
-    onValueChange?: (value: string) => void;
     /** Placeholder text */
     placeholder?: string;
     /** Whether the select is disabled */
@@ -39,10 +41,26 @@ interface SelectProps extends VariantProps<typeof selectTriggerVariants> {
     label?: string;
     /** Hide the label visually */
     hideLabel?: boolean;
+    /**
+     * Visual style of the label.
+     * - `stacked` (default): label sits above the trigger.
+     * - `floating`: label rests inside the trigger like a placeholder and
+     *   floats up (staying inside the trigger) when open or a value is
+     *   selected. The `placeholder` prop is ignored in this mode.
+     */
+    labelVariant?: 'stacked' | 'floating';
     /** Error message */
     error?: string;
     /** Helper text */
     helperText?: string;
+    /** Whether a selection is required (shows an asterisk next to the label) */
+    required?: boolean;
+    /**
+     * Color of the required asterisk.
+     * - `default`: destructive (hard requirement).
+     * - `warning`: warning color (soft requirement / recommended).
+     */
+    requiredVariant?: RequiredMarkVariant;
     /** Enable search/filter */
     searchable?: boolean;
     /** Search placeholder */
@@ -56,6 +74,27 @@ interface SelectProps extends VariantProps<typeof selectTriggerVariants> {
     /** ID for the select */
     id?: string;
 }
+interface SelectSingleProps extends SelectBaseProps {
+    /** Single-selection mode (default). */
+    multiple?: false;
+    /** Controlled value */
+    value?: string;
+    /** Default value (uncontrolled) */
+    defaultValue?: string;
+    /** Callback when value changes */
+    onValueChange?: (value: string) => void;
+}
+interface SelectMultipleProps extends SelectBaseProps {
+    /** Multiple-selection mode: selecting an option toggles it and keeps the dropdown open. */
+    multiple: true;
+    /** Controlled values */
+    value?: string[];
+    /** Default values (uncontrolled) */
+    defaultValue?: string[];
+    /** Callback when values change */
+    onValueChange?: (value: string[]) => void;
+}
+type SelectProps = SelectSingleProps | SelectMultipleProps;
 /**
  * An accessible select/dropdown component with search support.
  *
@@ -71,11 +110,19 @@ interface SelectProps extends VariantProps<typeof selectTriggerVariants> {
  *   ]}
  *   onValueChange={(value) => console.log(value)}
  * />
+ *
+ * // Multiple selection — value/onValueChange use string[]
+ * <Select
+ *   multiple
+ *   label="Symptoms"
+ *   options={options}
+ *   onValueChange={(values) => console.log(values)}
+ * />
  * ```
  */
-declare function Select({ options, value: controlledValue, defaultValue, onValueChange, placeholder, disabled, label, hideLabel, error, helperText, size, hasError, 'aria-label': ariaLabel, searchable, searchPlaceholder, noResultsText, className, id, }: SelectProps): react_jsx_runtime.JSX.Element;
+declare function Select(props: SelectProps): react_jsx_runtime.JSX.Element;
 declare namespace Select {
     var displayName: string;
 }
 
-export { Select, type SelectGroup, type SelectOption, type SelectProps, selectTriggerVariants };
+export { Select, type SelectBaseProps, type SelectGroup, type SelectMultipleProps, type SelectOption, type SelectProps, type SelectSingleProps, selectTriggerVariants };

package/dist/components/Select/index.d.ts

@@ -1,6 +1,8 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
+import { RequiredMarkVariant } from '../Input/index.js';
+import 'react';
 
 interface SelectOption {
     /** Unique value for the option */
@@ -21,16 +23,16 @@ interface SelectGroup {
 declare const selectTriggerVariants: (props?: ({
     size?: "sm" | "md" | "lg" | null | undefined;
     hasError?: boolean | null | undefined;
+    labelVariant?: "stacked" | "floating" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
-interface SelectProps extends VariantProps<typeof selectTriggerVariants> {
+/**
+ * Props shared by both single- and multiple-selection modes. Exported so
+ * wrapper components can extend the common shape (`SelectProps` itself is a
+ * discriminated union, which interfaces cannot extend).
+ */
+interface SelectBaseProps extends Omit<VariantProps<typeof selectTriggerVariants>, 'labelVariant'> {
     /** Array of options or groups */
     options: (SelectOption | SelectGroup)[];
-    /** Controlled value */
-    value?: string;
-    /** Default value (uncontrolled) */
-    defaultValue?: string;
-    /** Callback when value changes */
-    onValueChange?: (value: string) => void;
     /** Placeholder text */
     placeholder?: string;
     /** Whether the select is disabled */
@@ -39,10 +41,26 @@ interface SelectProps extends VariantProps<typeof selectTriggerVariants> {
     label?: string;
     /** Hide the label visually */
     hideLabel?: boolean;
+    /**
+     * Visual style of the label.
+     * - `stacked` (default): label sits above the trigger.
+     * - `floating`: label rests inside the trigger like a placeholder and
+     *   floats up (staying inside the trigger) when open or a value is
+     *   selected. The `placeholder` prop is ignored in this mode.
+     */
+    labelVariant?: 'stacked' | 'floating';
     /** Error message */
     error?: string;
     /** Helper text */
     helperText?: string;
+    /** Whether a selection is required (shows an asterisk next to the label) */
+    required?: boolean;
+    /**
+     * Color of the required asterisk.
+     * - `default`: destructive (hard requirement).
+     * - `warning`: warning color (soft requirement / recommended).
+     */
+    requiredVariant?: RequiredMarkVariant;
     /** Enable search/filter */
     searchable?: boolean;
     /** Search placeholder */
@@ -56,6 +74,27 @@ interface SelectProps extends VariantProps<typeof selectTriggerVariants> {
     /** ID for the select */
     id?: string;
 }
+interface SelectSingleProps extends SelectBaseProps {
+    /** Single-selection mode (default). */
+    multiple?: false;
+    /** Controlled value */
+    value?: string;
+    /** Default value (uncontrolled) */
+    defaultValue?: string;
+    /** Callback when value changes */
+    onValueChange?: (value: string) => void;
+}
+interface SelectMultipleProps extends SelectBaseProps {
+    /** Multiple-selection mode: selecting an option toggles it and keeps the dropdown open. */
+    multiple: true;
+    /** Controlled values */
+    value?: string[];
+    /** Default values (uncontrolled) */
+    defaultValue?: string[];
+    /** Callback when values change */
+    onValueChange?: (value: string[]) => void;
+}
+type SelectProps = SelectSingleProps | SelectMultipleProps;
 /**
  * An accessible select/dropdown component with search support.
  *
@@ -71,11 +110,19 @@ interface SelectProps extends VariantProps<typeof selectTriggerVariants> {
  *   ]}
  *   onValueChange={(value) => console.log(value)}
  * />
+ *
+ * // Multiple selection — value/onValueChange use string[]
+ * <Select
+ *   multiple
+ *   label="Symptoms"
+ *   options={options}
+ *   onValueChange={(values) => console.log(values)}
+ * />
  * ```
  */
-declare function Select({ options, value: controlledValue, defaultValue, onValueChange, placeholder, disabled, label, hideLabel, error, helperText, size, hasError, 'aria-label': ariaLabel, searchable, searchPlaceholder, noResultsText, className, id, }: SelectProps): react_jsx_runtime.JSX.Element;
+declare function Select(props: SelectProps): react_jsx_runtime.JSX.Element;
 declare namespace Select {
     var displayName: string;
 }
 
-export { Select, type SelectGroup, type SelectOption, type SelectProps, selectTriggerVariants };
+export { Select, type SelectBaseProps, type SelectGroup, type SelectMultipleProps, type SelectOption, type SelectProps, type SelectSingleProps, selectTriggerVariants };

package/dist/components/Select/index.js

@@ -1,7 +1,9 @@
-export { Select, selectTriggerVariants } from '../../chunk-DLBV42JD.js';
+export { Select, selectTriggerVariants } from '../../chunk-ATOWMVZH.js';
+import '../../chunk-6NZXWKUE.js';
+import '../../chunk-3IMM2PM4.js';
 import '../../chunk-T4ME7QCT.js';
 import '../../chunk-62ZOA6PX.js';
-import '../../chunk-BOOJDRJO.js';
+import '../../chunk-WSNMQQ4P.js';
 import '../../chunk-TQONQSJO.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/components/Slider/index.d.cts

@@ -6,11 +6,11 @@ declare const sliderTrackVariants: (props?: ({
     size?: "sm" | "md" | "lg" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const sliderRangeVariants: (props?: ({
-    variant?: "danger" | "default" | "success" | "warning" | "neutral" | null | undefined;
+    variant?: "danger" | "default" | "warning" | "success" | "neutral" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const sliderThumbVariants: (props?: ({
     size?: "sm" | "md" | "lg" | null | undefined;
-    variant?: "danger" | "default" | "success" | "warning" | "neutral" | null | undefined;
+    variant?: "danger" | "default" | "warning" | "success" | "neutral" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface SliderProps extends VariantProps<typeof sliderTrackVariants>, VariantProps<typeof sliderRangeVariants> {
     /** Current value (controlled) */

package/dist/components/Slider/index.d.ts

@@ -6,11 +6,11 @@ declare const sliderTrackVariants: (props?: ({
     size?: "sm" | "md" | "lg" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const sliderRangeVariants: (props?: ({
-    variant?: "danger" | "default" | "success" | "warning" | "neutral" | null | undefined;
+    variant?: "danger" | "default" | "warning" | "success" | "neutral" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const sliderThumbVariants: (props?: ({
     size?: "sm" | "md" | "lg" | null | undefined;
-    variant?: "danger" | "default" | "success" | "warning" | "neutral" | null | undefined;
+    variant?: "danger" | "default" | "warning" | "success" | "neutral" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface SliderProps extends VariantProps<typeof sliderTrackVariants>, VariantProps<typeof sliderRangeVariants> {
     /** Current value (controlled) */

package/dist/components/SourceTip/index.cjs

@@ -0,0 +1,15 @@
+'use strict';
+
+var chunkAHHFFXJR_cjs = require('../../chunk-AHHFFXJR.cjs');
+require('../../chunk-FHY3K6PL.cjs');
+require('../../chunk-AOHJILLU.cjs');
+require('../../chunk-S5RVSXDV.cjs');
+
+
+
+Object.defineProperty(exports, "SourceTip", {
+  enumerable: true,
+  get: function () { return chunkAHHFFXJR_cjs.SourceTip; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/components/SourceTip/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/components/SourceTip/index.d.cts

@@ -0,0 +1,58 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+
+/** One line of provenance shown in the card. */
+interface TipSource {
+    /** One-line label — statute name or source title. Truncated on render. */
+    label: string;
+    /** Source URL. Omit for a provenance line that isn't linkable. */
+    url?: string;
+    /** Secondary label shown at the end (publisher / host / year). */
+    sub?: string;
+}
+interface SourceTipProps {
+    /** The claim this card explains — the card's heading. */
+    heading: string;
+    /** Free-text provenance, for facts no public URL can verify. */
+    note?: string;
+    /** Linked (or unlinked) one-line sources. */
+    sources?: TipSource[];
+    /** Eyebrow above the heading. Defaults to "Source". */
+    eyebrow?: string;
+    /** The visible trigger. */
+    children: React.ReactNode;
+    className?: string;
+    /**
+     * Underline the trigger with a dashed rule marking a hoverable claim.
+     * Leave off in table cells, which signal hoverability by their own
+     * treatment rather than by underlining every cell.
+     */
+    underline?: boolean;
+}
+/**
+ * A hover card answering "what backs this claim?" — an eyebrow + heading,
+ * optional free-text provenance, and a list of one-line source links.
+ * Suits stat tiles, table cells, and inline facts where a numbered footnote
+ * would be overkill.
+ *
+ * The trigger and card are phrasing content (`span`/`a` only), so it is
+ * valid inside `<p>` prose and table cells. The card portals to `body` with
+ * fixed positioning, flipping and clamping to stay in the viewport. On
+ * touch, a tap pins the card; Escape or an outside tap closes it. A pinned
+ * card behaves as a non-modal dialog — focus moves into it so its source
+ * links are keyboard-reachable, and returns to the trigger on close.
+ *
+ * @example
+ * ```tsx
+ * <SourceTip
+ *   heading="OSHA recordable rate"
+ *   sources={[{ label: 'BLS SOII 2023', url: 'https://www.bls.gov/iif/', sub: 'BLS' }]}
+ *   underline
+ * >
+ *   2.4 per 100 FTE
+ * </SourceTip>
+ * ```
+ */
+declare function SourceTip({ heading, note, sources, eyebrow, children, className, underline, }: SourceTipProps): react_jsx_runtime.JSX.Element;
+
+export { SourceTip, type SourceTipProps, type TipSource };

package/dist/components/SourceTip/index.d.ts

@@ -0,0 +1,58 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+
+/** One line of provenance shown in the card. */
+interface TipSource {
+    /** One-line label — statute name or source title. Truncated on render. */
+    label: string;
+    /** Source URL. Omit for a provenance line that isn't linkable. */
+    url?: string;
+    /** Secondary label shown at the end (publisher / host / year). */
+    sub?: string;
+}
+interface SourceTipProps {
+    /** The claim this card explains — the card's heading. */
+    heading: string;
+    /** Free-text provenance, for facts no public URL can verify. */
+    note?: string;
+    /** Linked (or unlinked) one-line sources. */
+    sources?: TipSource[];
+    /** Eyebrow above the heading. Defaults to "Source". */
+    eyebrow?: string;
+    /** The visible trigger. */
+    children: React.ReactNode;
+    className?: string;
+    /**
+     * Underline the trigger with a dashed rule marking a hoverable claim.
+     * Leave off in table cells, which signal hoverability by their own
+     * treatment rather than by underlining every cell.
+     */
+    underline?: boolean;
+}
+/**
+ * A hover card answering "what backs this claim?" — an eyebrow + heading,
+ * optional free-text provenance, and a list of one-line source links.
+ * Suits stat tiles, table cells, and inline facts where a numbered footnote
+ * would be overkill.
+ *
+ * The trigger and card are phrasing content (`span`/`a` only), so it is
+ * valid inside `<p>` prose and table cells. The card portals to `body` with
+ * fixed positioning, flipping and clamping to stay in the viewport. On
+ * touch, a tap pins the card; Escape or an outside tap closes it. A pinned
+ * card behaves as a non-modal dialog — focus moves into it so its source
+ * links are keyboard-reachable, and returns to the trigger on close.
+ *
+ * @example
+ * ```tsx
+ * <SourceTip
+ *   heading="OSHA recordable rate"
+ *   sources={[{ label: 'BLS SOII 2023', url: 'https://www.bls.gov/iif/', sub: 'BLS' }]}
+ *   underline
+ * >
+ *   2.4 per 100 FTE
+ * </SourceTip>
+ * ```
+ */
+declare function SourceTip({ heading, note, sources, eyebrow, children, className, underline, }: SourceTipProps): react_jsx_runtime.JSX.Element;
+
+export { SourceTip, type SourceTipProps, type TipSource };

package/dist/components/SourceTip/index.js

@@ -0,0 +1,6 @@
+export { SourceTip } from '../../chunk-KFEN2SRZ.js';
+import '../../chunk-T4ME7QCT.js';
+import '../../chunk-WSNMQQ4P.js';
+import '../../chunk-TQONQSJO.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/components/SourceTip/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}