@particle-academy/react-fancy 5.12.0 → 5.14.0

package/dist/heading.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+var chunkRA3P63XW_cjs = require('./chunk-RA3P63XW.cjs');
+require('./chunk-3Z6ALUWP.cjs');
+
+
+
+Object.defineProperty(exports, "Heading", {
+  enumerable: true,
+  get: function () { return chunkRA3P63XW_cjs.Heading; }
+});
+//# sourceMappingURL=heading.cjs.map
+//# sourceMappingURL=heading.cjs.map

package/dist/heading.cjs.map

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

package/dist/heading.d.cts

@@ -0,0 +1,25 @@
+import * as react from 'react';
+import { HTMLAttributes } from 'react';
+
+interface HeadingProps extends HTMLAttributes<HTMLHeadingElement> {
+    /** Which heading element to render */
+    as?: "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
+    /**
+     * Text size, on a SEMANTIC ramp — the names are steps on this scale, not
+     * Tailwind class names. `xl` is `text-2xl` and `2xl` is `text-4xl`, and that
+     * offset has been true since the component shipped, so the display steps
+     * below continue the same ramp rather than re-basing it and silently
+     * resizing every existing heading.
+     *
+     * `3xl`–`7xl` are DISPLAY sizes: hero type, "typography at maximum volume".
+     * They carry tighter tracking, because letter-spacing tuned for body-adjacent
+     * headings reads loose and unset once type gets big.
+     */
+    size?: "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl" | "4xl" | "5xl" | "6xl" | "7xl";
+    /** Font weight */
+    weight?: "normal" | "medium" | "semibold" | "bold";
+}
+
+declare const Heading: react.ForwardRefExoticComponent<HeadingProps & react.RefAttributes<HTMLHeadingElement>>;
+
+export { Heading, type HeadingProps };

package/dist/heading.d.ts

@@ -0,0 +1,25 @@
+import * as react from 'react';
+import { HTMLAttributes } from 'react';
+
+interface HeadingProps extends HTMLAttributes<HTMLHeadingElement> {
+    /** Which heading element to render */
+    as?: "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
+    /**
+     * Text size, on a SEMANTIC ramp — the names are steps on this scale, not
+     * Tailwind class names. `xl` is `text-2xl` and `2xl` is `text-4xl`, and that
+     * offset has been true since the component shipped, so the display steps
+     * below continue the same ramp rather than re-basing it and silently
+     * resizing every existing heading.
+     *
+     * `3xl`–`7xl` are DISPLAY sizes: hero type, "typography at maximum volume".
+     * They carry tighter tracking, because letter-spacing tuned for body-adjacent
+     * headings reads loose and unset once type gets big.
+     */
+    size?: "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl" | "4xl" | "5xl" | "6xl" | "7xl";
+    /** Font weight */
+    weight?: "normal" | "medium" | "semibold" | "bold";
+}
+
+declare const Heading: react.ForwardRefExoticComponent<HeadingProps & react.RefAttributes<HTMLHeadingElement>>;
+
+export { Heading, type HeadingProps };

package/dist/heading.js

@@ -0,0 +1,4 @@
+export { Heading } from './chunk-FCAV5IFW.js';
+import './chunk-DSUHZO6T.js';
+//# sourceMappingURL=heading.js.map
+//# sourceMappingURL=heading.js.map

package/dist/heading.js.map

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

package/dist/icon.cjs

@@ -0,0 +1,34 @@
+'use strict';
+
+require('./chunk-AIA5UNQ5.cjs');
+var chunkJXIBUIEY_cjs = require('./chunk-JXIBUIEY.cjs');
+require('./chunk-3Z6ALUWP.cjs');
+
+
+
+Object.defineProperty(exports, "Icon", {
+  enumerable: true,
+  get: function () { return chunkJXIBUIEY_cjs.Icon; }
+});
+Object.defineProperty(exports, "configureIcons", {
+  enumerable: true,
+  get: function () { return chunkJXIBUIEY_cjs.configureIcons; }
+});
+Object.defineProperty(exports, "registerIconAddendum", {
+  enumerable: true,
+  get: function () { return chunkJXIBUIEY_cjs.registerIconAddendum; }
+});
+Object.defineProperty(exports, "registerIconSet", {
+  enumerable: true,
+  get: function () { return chunkJXIBUIEY_cjs.registerIconSet; }
+});
+Object.defineProperty(exports, "registerIcons", {
+  enumerable: true,
+  get: function () { return chunkJXIBUIEY_cjs.registerIcons; }
+});
+Object.defineProperty(exports, "resolveIcon", {
+  enumerable: true,
+  get: function () { return chunkJXIBUIEY_cjs.resolveIcon; }
+});
+//# sourceMappingURL=icon.cjs.map
+//# sourceMappingURL=icon.cjs.map

package/dist/icon.cjs.map

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

package/dist/icon.d.cts

@@ -0,0 +1,51 @@
+import * as react from 'react';
+import { HTMLAttributes, ComponentType } from 'react';
+
+interface IconProps extends HTMLAttributes<HTMLSpanElement> {
+    /** Icon container size */
+    size?: "xs" | "sm" | "md" | "lg" | "xl";
+    /** Icon name to resolve from the registered icon set (e.g., "rocket", "arrow-right") */
+    name?: string;
+    /** Which registered icon set to use (defaults to the configured default) */
+    iconSet?: string;
+}
+
+declare const Icon: react.ForwardRefExoticComponent<IconProps & react.RefAttributes<HTMLSpanElement>>;
+
+interface IconSet {
+    resolve: (name: string) => ComponentType<{
+        className?: string;
+        size?: number;
+    }> | null;
+}
+
+type IconComponent = ComponentType<{
+    className?: string;
+    size?: number;
+}>;
+/** Register an icon set as an addendum (supplements every base set). */
+declare function registerIconAddendum(set: IconSet): void;
+/**
+ * Register individual icon components by their kebab-case name.
+ *
+ * ```tsx
+ * import { registerIcons } from "@particle-academy/react-fancy";
+ * import { Home, Settings, Mail } from "lucide-react";
+ *
+ * registerIcons({ Home, Settings, Mail });
+ * ```
+ *
+ * Icons are registered into the default "lucide" icon set and resolved
+ * by the `<Icon name="home" />` component using kebab-case names.
+ */
+declare function registerIcons(icons: Record<string, ComponentType<{
+    className?: string;
+    size?: number;
+}>>): void;
+declare function registerIconSet(name: string, set: IconSet): void;
+declare function configureIcons(options: {
+    defaultSet?: string;
+}): void;
+declare function resolveIcon(name: string, setName?: string): IconComponent | null;
+
+export { Icon, type IconProps, type IconSet, configureIcons, registerIconAddendum, registerIconSet, registerIcons, resolveIcon };

package/dist/icon.d.ts

@@ -0,0 +1,51 @@
+import * as react from 'react';
+import { HTMLAttributes, ComponentType } from 'react';
+
+interface IconProps extends HTMLAttributes<HTMLSpanElement> {
+    /** Icon container size */
+    size?: "xs" | "sm" | "md" | "lg" | "xl";
+    /** Icon name to resolve from the registered icon set (e.g., "rocket", "arrow-right") */
+    name?: string;
+    /** Which registered icon set to use (defaults to the configured default) */
+    iconSet?: string;
+}
+
+declare const Icon: react.ForwardRefExoticComponent<IconProps & react.RefAttributes<HTMLSpanElement>>;
+
+interface IconSet {
+    resolve: (name: string) => ComponentType<{
+        className?: string;
+        size?: number;
+    }> | null;
+}
+
+type IconComponent = ComponentType<{
+    className?: string;
+    size?: number;
+}>;
+/** Register an icon set as an addendum (supplements every base set). */
+declare function registerIconAddendum(set: IconSet): void;
+/**
+ * Register individual icon components by their kebab-case name.
+ *
+ * ```tsx
+ * import { registerIcons } from "@particle-academy/react-fancy";
+ * import { Home, Settings, Mail } from "lucide-react";
+ *
+ * registerIcons({ Home, Settings, Mail });
+ * ```
+ *
+ * Icons are registered into the default "lucide" icon set and resolved
+ * by the `<Icon name="home" />` component using kebab-case names.
+ */
+declare function registerIcons(icons: Record<string, ComponentType<{
+    className?: string;
+    size?: number;
+}>>): void;
+declare function registerIconSet(name: string, set: IconSet): void;
+declare function configureIcons(options: {
+    defaultSet?: string;
+}): void;
+declare function resolveIcon(name: string, setName?: string): IconComponent | null;
+
+export { Icon, type IconProps, type IconSet, configureIcons, registerIconAddendum, registerIconSet, registerIcons, resolveIcon };

package/dist/icon.js

@@ -0,0 +1,5 @@
+import './chunk-TJ66S5K6.js';
+export { Icon, configureIcons, registerIconAddendum, registerIconSet, registerIcons, resolveIcon } from './chunk-M7EEQPE7.js';
+import './chunk-DSUHZO6T.js';
+//# sourceMappingURL=icon.js.map
+//# sourceMappingURL=icon.js.map

package/dist/icon.js.map

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

package/dist/image-viewer.cjs

@@ -0,0 +1,14 @@
+'use strict';
+
+var chunkAC7M7JDO_cjs = require('./chunk-AC7M7JDO.cjs');
+require('./chunk-T6YELZPJ.cjs');
+require('./chunk-3Z6ALUWP.cjs');
+
+
+
+Object.defineProperty(exports, "ImageViewer", {
+  enumerable: true,
+  get: function () { return chunkAC7M7JDO_cjs.ImageViewer; }
+});
+//# sourceMappingURL=image-viewer.cjs.map
+//# sourceMappingURL=image-viewer.cjs.map

package/dist/image-viewer.cjs.map

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

package/dist/image-viewer.d.cts

@@ -0,0 +1,19 @@
+import * as react from 'react';
+import { I as ImageViewerProps } from './ImageViewer.types-BaqlDeuo.cjs';
+export { a as ImageViewerViewport } from './ImageViewer.types-BaqlDeuo.cjs';
+
+/**
+ * A standalone image viewer: fits the image to its container, with optional
+ * Ctrl/⌘+wheel zoom, click-drag panning, and a transparency checkerboard. Works
+ * anywhere on its own and is also what `<MediaViewer>` renders for images.
+ *
+ * The pan/zoom viewport is controllable (`viewport` + `onViewportChange`) so an
+ * agent bridge can drive it; it's uncontrolled by default.
+ *
+ * ```tsx
+ * <ImageViewer src="/logo.png" alt="logo.png" style={{ height: 320 }} />
+ * ```
+ */
+declare const ImageViewer: react.ForwardRefExoticComponent<ImageViewerProps & react.RefAttributes<HTMLDivElement>>;
+
+export { ImageViewer, ImageViewerProps };

package/dist/image-viewer.d.ts

@@ -0,0 +1,19 @@
+import * as react from 'react';
+import { I as ImageViewerProps } from './ImageViewer.types-BaqlDeuo.js';
+export { a as ImageViewerViewport } from './ImageViewer.types-BaqlDeuo.js';
+
+/**
+ * A standalone image viewer: fits the image to its container, with optional
+ * Ctrl/⌘+wheel zoom, click-drag panning, and a transparency checkerboard. Works
+ * anywhere on its own and is also what `<MediaViewer>` renders for images.
+ *
+ * The pan/zoom viewport is controllable (`viewport` + `onViewportChange`) so an
+ * agent bridge can drive it; it's uncontrolled by default.
+ *
+ * ```tsx
+ * <ImageViewer src="/logo.png" alt="logo.png" style={{ height: 320 }} />
+ * ```
+ */
+declare const ImageViewer: react.ForwardRefExoticComponent<ImageViewerProps & react.RefAttributes<HTMLDivElement>>;
+
+export { ImageViewer, ImageViewerProps };

package/dist/image-viewer.js

@@ -0,0 +1,5 @@
+export { ImageViewer } from './chunk-A3CNYKT3.js';
+import './chunk-CPY7NHXM.js';
+import './chunk-DSUHZO6T.js';
+//# sourceMappingURL=image-viewer.js.map
+//# sourceMappingURL=image-viewer.js.map

package/dist/image-viewer.js.map

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

package/dist/index-B71wa9AW.d.cts

@@ -0,0 +1,79 @@
+import * as react from 'react';
+import { ReactNode, CSSProperties } from 'react';
+import { I as ImageViewerProps } from './ImageViewer.types-BaqlDeuo.cjs';
+import { V as VideoViewerProps } from './VideoViewer.types-CTwS6PcM.cjs';
+import { A as AudioViewerProps } from './AudioViewer.types-VWhRx6XG.cjs';
+import { P as PdfViewerProps } from './PdfViewer.types-_u6vboSl.cjs';
+
+/**
+ * Resolve what kind of media a source is, from its MIME type (preferred) or its
+ * URL — a file extension, or the type embedded in a `data:` URI.
+ *
+ * Shared by `<MediaViewer>` to pick the right per-type viewer, and exported so
+ * downstream packages (e.g. fancy-code's file viewer) can make the same
+ * text-vs-media decision without re-deriving the table.
+ */
+type MediaKind = "image" | "video" | "audio" | "pdf" | "unknown";
+interface ResolveMediaTypeInput {
+    /** MIME type — preferred when known (e.g. `"image/png"`, `"video/mp4"`). */
+    mime?: string | null;
+    /**
+     * Source URL — used to sniff the kind from a file extension, or from the type
+     * embedded in a `data:` URI, when no `mime` is given. `http(s):` / `data:` /
+     * `blob:` are all accepted (a bare `blob:` URL carries no type, so pass
+     * `mime` alongside it).
+     */
+    src?: string | null;
+}
+/**
+ * Resolve a {@link MediaKind} from a MIME type and/or source URL. MIME wins
+ * when it's conclusive; otherwise the `src` is sniffed (a `data:` URI's
+ * embedded type first, then the file extension). Returns `"unknown"` when
+ * nothing matches — callers treat that as "not previewable media" (e.g. text).
+ */
+declare function resolveMediaType({ mime, src }: ResolveMediaTypeInput): MediaKind;
+
+interface MediaViewerProps {
+    /** Media source — an `http(s):`, `data:`, or `blob:` URL. */
+    src: string;
+    /**
+     * MIME type — preferred for picking the viewer. When omitted, the kind is
+     * sniffed from `src` (extension or `data:` URI). Always pass `mime` with a
+     * bare `blob:` URL, which carries no type of its own.
+     */
+    mime?: string;
+    /** Alt text / label, forwarded as image alt and audio/PDF title. */
+    alt?: string;
+    /** Force a specific viewer, bypassing detection. */
+    kind?: MediaKind;
+    /** Extra props for the underlying `<ImageViewer>`. */
+    imageProps?: Partial<Omit<ImageViewerProps, "src" | "alt">>;
+    /** Extra props for the underlying `<VideoViewer>`. */
+    videoProps?: Partial<Omit<VideoViewerProps, "src">>;
+    /** Extra props for the underlying `<AudioViewer>`. */
+    audioProps?: Partial<Omit<AudioViewerProps, "src">>;
+    /** Extra props for the underlying `<PdfViewer>`. */
+    pdfProps?: Partial<Omit<PdfViewerProps, "src">>;
+    /** Rendered for unknown / unpreviewable types (default: a download card). */
+    fallback?: ReactNode;
+    /** Fired when the chosen viewer reports a load error. */
+    onError?: () => void;
+    /** Additional CSS classes, forwarded to the chosen viewer. */
+    className?: string;
+    /** Inline styles, forwarded to the chosen viewer. */
+    style?: CSSProperties;
+}
+
+/**
+ * Renders the right viewer for a media file, picked from its `mime` (preferred)
+ * or `src` — image, video, audio, or PDF — and a download fallback for anything
+ * else. SVG renders through `<ImageViewer>`. The single entry point for showing
+ * a file from a tree/workspace when you don't know its type ahead of time.
+ *
+ * ```tsx
+ * <MediaViewer src={url} mime="image/png" alt="logo.png" style={{ height: 320 }} />
+ * ```
+ */
+declare const MediaViewer: react.ForwardRefExoticComponent<MediaViewerProps & react.RefAttributes<HTMLDivElement>>;
+
+export { type MediaKind as M, type ResolveMediaTypeInput as R, MediaViewer as a, type MediaViewerProps as b, resolveMediaType as r };

package/dist/index-BktWpyRH.d.cts

@@ -0,0 +1,53 @@
+import * as react from 'react';
+
+/**
+ * Full Unicode 15.1 emoji set, generated from emoji-test.txt.
+ * DO NOT EDIT BY HAND — run scripts/generate-emoji-data.mjs.
+ */
+type EmojiEntry = {
+    char: string;
+    name: string;
+    skinTones?: [string, string, string, string, string];
+};
+type EmojiCategory = {
+    icon: string;
+    label: string;
+    emojis: EmojiEntry[];
+};
+declare const EMOJI_CATEGORY_ORDER: readonly ["smileys", "people", "animals", "food", "travel", "activities", "objects", "symbols", "flags"];
+type EmojiCategoryKey = typeof EMOJI_CATEGORY_ORDER[number];
+declare const EMOJI_DATA: Record<EmojiCategoryKey, EmojiCategory>;
+type EmojiFlatEntry = EmojiEntry & {
+    category: EmojiCategoryKey;
+};
+declare const EMOJI_ENTRIES: EmojiFlatEntry[];
+
+declare const SKIN_TONES: readonly ["light", "medium-light", "medium", "medium-dark", "dark"];
+type SkinTone = typeof SKIN_TONES[number];
+type IndexedEntry = EmojiEntry & {
+    category: EmojiCategoryKey;
+};
+/** Resolve an emoji name to its character. */
+declare function resolve(name: string): string | undefined;
+/** Search emojis by name substring. Returns matching base emoji characters. */
+declare function search(query: string): string[];
+/** Find an emoji entry by its character (toned or base). */
+declare function find(char: string): IndexedEntry | undefined;
+/** Return the 5-tone variant array for an emoji (by char, toned or base). */
+declare function skinTones(char: string): readonly [string, string, string, string, string] | undefined;
+/** Whether an emoji supports skin tones. */
+declare function hasSkinTones(char: string): boolean;
+/** Return the toned variant for an emoji, or the base if no tones. */
+declare function applyTone(char: string, tone: SkinTone | null): string;
+
+interface EmojiProps {
+    name?: string;
+    emoji?: string;
+    tone?: SkinTone;
+    size?: "sm" | "md" | "lg" | "xl";
+    className?: string;
+}
+
+declare function Emoji({ name, emoji, tone, size, className }: EmojiProps): react.JSX.Element | null;
+
+export { EMOJI_CATEGORY_ORDER as E, SKIN_TONES as S, EMOJI_DATA as a, EMOJI_ENTRIES as b, Emoji as c, type EmojiCategory as d, type EmojiCategoryKey as e, type EmojiEntry as f, type EmojiFlatEntry as g, type EmojiProps as h, type SkinTone as i, applyTone as j, find as k, hasSkinTones as l, skinTones as m, resolve as r, search as s };

package/dist/index-BktWpyRH.d.ts

@@ -0,0 +1,53 @@
+import * as react from 'react';
+
+/**
+ * Full Unicode 15.1 emoji set, generated from emoji-test.txt.
+ * DO NOT EDIT BY HAND — run scripts/generate-emoji-data.mjs.
+ */
+type EmojiEntry = {
+    char: string;
+    name: string;
+    skinTones?: [string, string, string, string, string];
+};
+type EmojiCategory = {
+    icon: string;
+    label: string;
+    emojis: EmojiEntry[];
+};
+declare const EMOJI_CATEGORY_ORDER: readonly ["smileys", "people", "animals", "food", "travel", "activities", "objects", "symbols", "flags"];
+type EmojiCategoryKey = typeof EMOJI_CATEGORY_ORDER[number];
+declare const EMOJI_DATA: Record<EmojiCategoryKey, EmojiCategory>;
+type EmojiFlatEntry = EmojiEntry & {
+    category: EmojiCategoryKey;
+};
+declare const EMOJI_ENTRIES: EmojiFlatEntry[];
+
+declare const SKIN_TONES: readonly ["light", "medium-light", "medium", "medium-dark", "dark"];
+type SkinTone = typeof SKIN_TONES[number];
+type IndexedEntry = EmojiEntry & {
+    category: EmojiCategoryKey;
+};
+/** Resolve an emoji name to its character. */
+declare function resolve(name: string): string | undefined;
+/** Search emojis by name substring. Returns matching base emoji characters. */
+declare function search(query: string): string[];
+/** Find an emoji entry by its character (toned or base). */
+declare function find(char: string): IndexedEntry | undefined;
+/** Return the 5-tone variant array for an emoji (by char, toned or base). */
+declare function skinTones(char: string): readonly [string, string, string, string, string] | undefined;
+/** Whether an emoji supports skin tones. */
+declare function hasSkinTones(char: string): boolean;
+/** Return the toned variant for an emoji, or the base if no tones. */
+declare function applyTone(char: string, tone: SkinTone | null): string;
+
+interface EmojiProps {
+    name?: string;
+    emoji?: string;
+    tone?: SkinTone;
+    size?: "sm" | "md" | "lg" | "xl";
+    className?: string;
+}
+
+declare function Emoji({ name, emoji, tone, size, className }: EmojiProps): react.JSX.Element | null;
+
+export { EMOJI_CATEGORY_ORDER as E, SKIN_TONES as S, EMOJI_DATA as a, EMOJI_ENTRIES as b, Emoji as c, type EmojiCategory as d, type EmojiCategoryKey as e, type EmojiEntry as f, type EmojiFlatEntry as g, type EmojiProps as h, type SkinTone as i, applyTone as j, find as k, hasSkinTones as l, skinTones as m, resolve as r, search as s };

package/dist/index-bIntFOl5.d.ts

@@ -0,0 +1,79 @@
+import * as react from 'react';
+import { ReactNode, CSSProperties } from 'react';
+import { I as ImageViewerProps } from './ImageViewer.types-BaqlDeuo.js';
+import { V as VideoViewerProps } from './VideoViewer.types-CTwS6PcM.js';
+import { A as AudioViewerProps } from './AudioViewer.types-VWhRx6XG.js';
+import { P as PdfViewerProps } from './PdfViewer.types-_u6vboSl.js';
+
+/**
+ * Resolve what kind of media a source is, from its MIME type (preferred) or its
+ * URL — a file extension, or the type embedded in a `data:` URI.
+ *
+ * Shared by `<MediaViewer>` to pick the right per-type viewer, and exported so
+ * downstream packages (e.g. fancy-code's file viewer) can make the same
+ * text-vs-media decision without re-deriving the table.
+ */
+type MediaKind = "image" | "video" | "audio" | "pdf" | "unknown";
+interface ResolveMediaTypeInput {
+    /** MIME type — preferred when known (e.g. `"image/png"`, `"video/mp4"`). */
+    mime?: string | null;
+    /**
+     * Source URL — used to sniff the kind from a file extension, or from the type
+     * embedded in a `data:` URI, when no `mime` is given. `http(s):` / `data:` /
+     * `blob:` are all accepted (a bare `blob:` URL carries no type, so pass
+     * `mime` alongside it).
+     */
+    src?: string | null;
+}
+/**
+ * Resolve a {@link MediaKind} from a MIME type and/or source URL. MIME wins
+ * when it's conclusive; otherwise the `src` is sniffed (a `data:` URI's
+ * embedded type first, then the file extension). Returns `"unknown"` when
+ * nothing matches — callers treat that as "not previewable media" (e.g. text).
+ */
+declare function resolveMediaType({ mime, src }: ResolveMediaTypeInput): MediaKind;
+
+interface MediaViewerProps {
+    /** Media source — an `http(s):`, `data:`, or `blob:` URL. */
+    src: string;
+    /**
+     * MIME type — preferred for picking the viewer. When omitted, the kind is
+     * sniffed from `src` (extension or `data:` URI). Always pass `mime` with a
+     * bare `blob:` URL, which carries no type of its own.
+     */
+    mime?: string;
+    /** Alt text / label, forwarded as image alt and audio/PDF title. */
+    alt?: string;
+    /** Force a specific viewer, bypassing detection. */
+    kind?: MediaKind;
+    /** Extra props for the underlying `<ImageViewer>`. */
+    imageProps?: Partial<Omit<ImageViewerProps, "src" | "alt">>;
+    /** Extra props for the underlying `<VideoViewer>`. */
+    videoProps?: Partial<Omit<VideoViewerProps, "src">>;
+    /** Extra props for the underlying `<AudioViewer>`. */
+    audioProps?: Partial<Omit<AudioViewerProps, "src">>;
+    /** Extra props for the underlying `<PdfViewer>`. */
+    pdfProps?: Partial<Omit<PdfViewerProps, "src">>;
+    /** Rendered for unknown / unpreviewable types (default: a download card). */
+    fallback?: ReactNode;
+    /** Fired when the chosen viewer reports a load error. */
+    onError?: () => void;
+    /** Additional CSS classes, forwarded to the chosen viewer. */
+    className?: string;
+    /** Inline styles, forwarded to the chosen viewer. */
+    style?: CSSProperties;
+}
+
+/**
+ * Renders the right viewer for a media file, picked from its `mime` (preferred)
+ * or `src` — image, video, audio, or PDF — and a download fallback for anything
+ * else. SVG renders through `<ImageViewer>`. The single entry point for showing
+ * a file from a tree/workspace when you don't know its type ahead of time.
+ *
+ * ```tsx
+ * <MediaViewer src={url} mime="image/png" alt="logo.png" style={{ height: 320 }} />
+ * ```
+ */
+declare const MediaViewer: react.ForwardRefExoticComponent<MediaViewerProps & react.RefAttributes<HTMLDivElement>>;
+
+export { type MediaKind as M, type ResolveMediaTypeInput as R, MediaViewer as a, type MediaViewerProps as b, resolveMediaType as r };

package/dist/index-list.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+var chunk6L6LI2RL_cjs = require('./chunk-6L6LI2RL.cjs');
+require('./chunk-3Z6ALUWP.cjs');
+
+
+
+Object.defineProperty(exports, "IndexList", {
+  enumerable: true,
+  get: function () { return chunk6L6LI2RL_cjs.IndexList; }
+});
+//# sourceMappingURL=index-list.cjs.map
+//# sourceMappingURL=index-list.cjs.map

package/dist/index-list.cjs.map

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

package/dist/index-list.d.cts

@@ -0,0 +1,49 @@
+import * as react from 'react';
+import { HTMLAttributes, ReactNode } from 'react';
+
+interface IndexListItem {
+    /** Row marker — `"01"`, `"1."`. Rendered tabular so the column aligns. */
+    num?: ReactNode;
+    /** The row's subject, and the link text when `href` is set. */
+    title: ReactNode;
+    /** Secondary text after the title. */
+    meta?: ReactNode;
+    /** Trailing value, pushed to the far end — a year, a count. */
+    value?: ReactNode;
+    /** Makes the whole row clickable. See the note on nested anchors. */
+    href?: string;
+    /** Stable key. Defaults to the index. */
+    id?: string;
+}
+interface IndexListProps extends Omit<HTMLAttributes<HTMLOListElement>, "children"> {
+    items: IndexListItem[];
+    /**
+     * Render an `<a>` for `href`. Pass your router's link (Inertia `Link`,
+     * `next/link`) to keep client-side navigation. It receives `href`,
+     * `className` and `children`.
+     */
+    linkAs?: React.ElementType;
+}
+
+/**
+ * A flush-left numbered index — `num · title · meta · trailing value`, each row
+ * optionally a single clickable target.
+ *
+ * Thirteen gallery styles build this, and the sandbox uses a `stretched-link`
+ * treatment in twenty-four places.
+ *
+ * ## Exactly one anchor per row, by construction
+ *
+ * The row is `relative` and the title's `<a>` carries `after:absolute
+ * after:inset-0`, so the anchor's own pseudo-element covers the row. The
+ * alternative — wrapping the row in an `<a>` and putting more links inside —
+ * produces nested anchors, which is issue #418: the browser silently
+ * restructures that DOM, so the server HTML and the client tree disagree and
+ * hydration blows up. A test asserts one anchor per row for that reason.
+ *
+ * The link text stays the title rather than becoming an `aria-label` on an
+ * invisible overlay, so the accessible name is the thing you would say out loud.
+ */
+declare const IndexList: react.ForwardRefExoticComponent<IndexListProps & react.RefAttributes<HTMLOListElement>>;
+
+export { IndexList, type IndexListItem, type IndexListProps };