@willa-ui/shared 0.0.1-alpha.8d8fe96 → 0.0.3-alpha.2739b3e

package/dist/index.d.cts

@@ -1,15 +1,145 @@
 /*!
- * @willa-ui/shared.js v0.0.1-alpha.8d8fe96
+ * @willa-ui/shared.js v0.0.3-alpha.2739b3e
  * (c) 2026 chentao.arthur
  */
-import { ReactNode } from "react";
+import { ReactNode, Ref, RefObject, SetStateAction } from "react";
 
+//#region src/css.d.ts
+declare function formatCssSize(value?: number | string): string | undefined;
+//#endregion
 //#region src/clipboard.d.ts
 declare function copyToClipboard(text: string): Promise<boolean>;
 //#endregion
+//#region src/controllableState.d.ts
+type ControllableStateOptions<Value> = {
+  value?: Value;
+  defaultValue: Value | (() => Value);
+  onChange?: (value: Value) => void;
+};
+declare function useControllableState<Value>(options: ControllableStateOptions<Value>): readonly [Value, (nextValue: SetStateAction<Value>) => void, boolean];
+//#endregion
+//#region src/viewport.d.ts
+declare const MOBILE_BREAKPOINT = 640;
+declare function isMobileViewport(viewportWidth: number): boolean;
+declare function isMobile(): boolean;
+//#endregion
+//#region src/copy.d.ts
+type CopyStatus = "idle" | "copied" | "failed";
+type CopyToClipboardOptions = {
+  resetDuration?: number;
+  onCopy?: (text: string) => void;
+};
+type CopyToClipboardActionOptions = {
+  resetDuration?: number;
+  onCopy?: (text: string) => void;
+};
+declare function useCopyToClipboard(options?: CopyToClipboardOptions): {
+  readonly status: CopyStatus;
+  readonly copied: boolean;
+  readonly failed: boolean;
+  readonly copy: (text: string, actionOptions?: CopyToClipboardActionOptions) => Promise<boolean>;
+  readonly reset: () => void;
+};
+//#endregion
+//#region src/codeHighlight.d.ts
+type CodeHighlightMeta = {
+  rawLanguage: string;
+  highlightLines: Set<number>;
+  showLineNumbers: boolean;
+};
+type HighlightedCode = {
+  html: string;
+  display: string;
+};
+declare const parseCodeMeta: (className?: string) => CodeHighlightMeta;
+declare const normalizeHljsLanguage: (language: string) => string;
+declare const highlightCodeToHtml: (code: string, rawLanguage: string) => HighlightedCode;
+declare const createCodeHighlightLines: (ranges?: Array<number | readonly [start: number, end: number]>) => Set<number>;
+//#endregion
+//#region src/dom.d.ts
+declare function getFocusableElements(container: HTMLElement): HTMLElement[];
+//#endregion
+//#region src/floating.d.ts
+type FloatingPanelSide = "top" | "right" | "bottom" | "left";
+type FloatingPanelAlign = "start" | "center" | "end";
+type FloatingPanelRect = {
+  top: number;
+  right: number;
+  bottom: number;
+  left: number;
+  width: number;
+  height: number;
+};
+type FloatingPanelPoint = {
+  x: number;
+  y: number;
+};
+type FloatingPanelPosition = {
+  top: number;
+  left: number;
+  minWidth?: number;
+};
+type FloatingPanelPositionOptions = {
+  anchorRect?: FloatingPanelRect;
+  anchorPoint?: FloatingPanelPoint;
+  floatingRect: Pick<FloatingPanelRect, "width" | "height">;
+  side?: FloatingPanelSide;
+  align?: FloatingPanelAlign;
+  offset?: number;
+  viewportWidth?: number;
+  viewportHeight?: number;
+  viewportPadding?: number;
+  matchAnchorMinWidth?: boolean;
+};
+declare function getFloatingPanelPosition(options: FloatingPanelPositionOptions): FloatingPanelPosition;
+//#endregion
+//#region src/floatingLayer.d.ts
+type FloatingLayerPosition = FloatingPanelPosition & {
+  anchorRect?: FloatingPanelRect;
+  width?: number;
+};
+type UseFloatingLayerOptions = {
+  open: boolean;
+  triggerRef?: RefObject<HTMLElement | null>;
+  floatingRef: RefObject<HTMLElement | null>;
+  anchorRect?: FloatingPanelRect | null;
+  anchorPoint?: FloatingPanelPoint | null;
+  side?: FloatingPanelSide;
+  align?: FloatingPanelAlign;
+  offset?: number;
+  viewportPadding?: number;
+  minWidth?: number;
+  fallbackWidth?: number;
+  fallbackHeight?: number;
+  matchAnchorWidth?: boolean;
+  matchAnchorMinWidth?: boolean;
+  fullWidthBelow?: number;
+  applyResolvedWidth?: boolean;
+  flipToFit?: boolean;
+  outsideRefs?: Array<RefObject<HTMLElement | null>>;
+  closeOnOutsidePointerDown?: boolean;
+  restoreFocus?: boolean;
+  onClose?: () => void;
+  onOpenAutoFocus?: () => void;
+  getAnchorRect?: () => FloatingPanelRect | null;
+  getAnchorPoint?: () => FloatingPanelPoint | null;
+};
+declare function useFloatingLayer(options: UseFloatingLayerOptions): {
+  position: FloatingLayerPosition | undefined;
+  updatePosition: () => void;
+};
+//#endregion
 //#region src/nodes.d.ts
 declare function isMediaOnlyParagraph(children: ReactNode): boolean;
 //#endregion
+//#region src/refs.d.ts
+declare function assignRef<T>(ref: Ref<T> | undefined, value: T | null): void;
+declare function composeRefs<T>(...refs: Array<Ref<T> | undefined>): (value: T | null) => void;
+//#endregion
+//#region src/number.d.ts
+declare function clampNumber(value: number, min: number, max: number): number;
+declare function createNumberRange(start: number, end: number): number[];
+//#endregion
 //#region src/types.d.ts
 type Heading = {
   level: 2 | 3;
@@ -32,9 +162,94 @@ type LightboxState = {
 type OpenLightbox = (state: LightboxState | null) => void;
 type ResolveAssetUrl = (articleSourcePath: string, assetPath: string) => string | undefined;
 //#endregion
+//#region src/media.d.ts
+type MediaContextProps = {
+  articleSourcePath?: string;
+  resolveAssetUrl?: ResolveAssetUrl;
+};
+declare function resolveMediaAsset(props: MediaContextProps, assetPath?: string): string | undefined;
+declare function resolveMediaVolume(volume?: number): number | undefined;
+//#endregion
+//#region src/file.d.ts
+type FileItemKind = "image" | "audio" | "video" | "file";
+type FilePreviewMode = "dialog" | "link" | "download" | "none";
+type FilePreviewType = "auto" | "image" | "video" | "audio" | "pdf" | "csv" | "code" | "text" | "download";
+type FileItemStatus = "ready" | "uploading" | "error";
+type ObjectFileItem = {
+  id: string;
+  file: File;
+  url: string;
+  kind: FileItemKind;
+};
+type FilePreviewDialogOptions = {
+  disabled?: boolean;
+  href?: string;
+  previewMode: FilePreviewMode;
+  status?: FileItemStatus;
+};
+type ResolveFilePreviewTypeOptions = {
+  name: string;
+  type: FilePreviewType;
+  mimeType?: string;
+};
+declare const createObjectFileItem: (file: File) => ObjectFileItem;
+declare const resolveFileKind: (file: Pick<File, "type">) => FileItemKind;
+declare const resolveFilePreviewType: (options: ResolveFilePreviewTypeOptions) => Exclude<FilePreviewType, "auto">;
+declare const getFileExtension: (name: string) => string;
+declare const getFileCodeLanguage: (name: string) => string;
+declare const resolveFileKindLabel: (kind: FileItemKind) => "图片" | "音频" | "视频" | "文件";
+declare const formatFileSize: (size: number) => string;
+declare const normalizeFileProgress: (progress?: number) => number | undefined;
+declare const resolveFilePreviewMode: (itemMode: FilePreviewMode | undefined, fallbackMode: FilePreviewMode) => FilePreviewMode;
+declare const canOpenFilePreviewDialog: (options: FilePreviewDialogOptions) => boolean;
+//#endregion
+//#region src/request.d.ts
+type RequestJsonOptions = RequestInit & {
+  dedupeKey?: string;
+  createError?: (response: Response) => Error | Promise<Error>;
+};
+declare function isAbortError(error: unknown): boolean;
+declare function requestJson<T = unknown>(input: RequestInfo | URL, options?: RequestJsonOptions): Promise<T>;
+//#endregion
 //#region src/heading.d.ts
 declare function flattenText(node: unknown): string;
 declare function createHeadingIdFactory(): (text: string) => string;
 declare function extractHeadings(source: string): Heading[];
 //#endregion
-export { type Heading, type LightboxImage, type LightboxState, type OpenLightbox, type ResolveAssetUrl, copyToClipboard, createHeadingIdFactory, extractHeadings, flattenText, isMediaOnlyParagraph };
+//#region src/virtualScroll.d.ts
+type VirtualScrollWindow = {
+  startIndex: number;
+  endIndex: number;
+  paddingTop: number;
+  paddingBottom: number;
+  totalHeight: number;
+};
+type VirtualScrollOptions = {
+  enabled?: boolean;
+  itemCount: number;
+  itemHeight: number;
+  overscan?: number;
+  container: HTMLElement | null;
+};
+declare const getVirtualScrollWindow: (options: {
+  itemCount: number;
+  itemHeight: number;
+  overscan: number;
+  scrollTop: number;
+  viewportHeight: number;
+}) => {
+  startIndex: number;
+  endIndex: number;
+  paddingTop: number;
+  paddingBottom: number;
+  totalHeight: number;
+};
+declare const useVirtualScrollWindow: (options: VirtualScrollOptions) => {
+  startIndex: number;
+  endIndex: number;
+  paddingTop: number;
+  paddingBottom: number;
+  totalHeight: number;
+};
+//#endregion
+export { type CodeHighlightMeta, type ControllableStateOptions, type CopyStatus, type CopyToClipboardActionOptions, type CopyToClipboardOptions, type FileItemKind, type FileItemStatus, type FilePreviewMode, type FilePreviewType, type FloatingLayerPosition, type FloatingPanelAlign, type FloatingPanelPoint, type FloatingPanelPosition, type FloatingPanelPositionOptions, type FloatingPanelRect, type FloatingPanelSide, type Heading, type HighlightedCode, type LightboxImage, type LightboxState, MOBILE_BREAKPOINT, type MediaContextProps, type ObjectFileItem, type OpenLightbox, type RequestJsonOptions, type ResolveAssetUrl, type ResolveFilePreviewTypeOptions, type UseFloatingLayerOptions, type VirtualScrollOptions, type VirtualScrollWindow, assignRef, canOpenFilePreviewDialog, clampNumber, composeRefs, copyToClipboard, createCodeHighlightLines, createHeadingIdFactory, createNumberRange, createObjectFileItem, extractHeadings, flattenText, formatCssSize, formatFileSize, getFileCodeLanguage, getFileExtension, getFloatingPanelPosition, getFocusableElements, getVirtualScrollWindow, highlightCodeToHtml, isAbortError, isMediaOnlyParagraph, isMobile, isMobileViewport, normalizeFileProgress, normalizeHljsLanguage, parseCodeMeta, requestJson, resolveFileKind, resolveFileKindLabel, resolveFilePreviewMode, resolveFilePreviewType, resolveMediaAsset, resolveMediaVolume, useControllableState, useCopyToClipboard, useFloatingLayer, useVirtualScrollWindow };