@petrarca/sonnet-core 0.1.0

package/dist/hooks/index.js

@@ -0,0 +1,207 @@
+import {
+  isEqual
+} from "../chunk-XCCOEUVC.js";
+
+// src/hooks/useClipboard.ts
+import { useState, useCallback } from "react";
+function useClipboard({
+  timeout = 2e3
+} = {}) {
+  const [copied, setCopied] = useState(false);
+  const [error, setError] = useState(null);
+  const copy = useCallback(
+    async (text) => {
+      try {
+        await navigator.clipboard.writeText(text);
+        setCopied(true);
+        setError(null);
+        setTimeout(() => setCopied(false), timeout);
+      } catch (err) {
+        setError(err instanceof Error ? err : new Error(String(err)));
+        setCopied(false);
+      }
+    },
+    [timeout]
+  );
+  const reset = useCallback(() => {
+    setCopied(false);
+    setError(null);
+  }, []);
+  return { copy, copied, error, reset };
+}
+
+// src/hooks/useDisclosure.ts
+import { useState as useState2, useCallback as useCallback2 } from "react";
+function useDisclosure(initialState = false) {
+  const [opened, setOpened] = useState2(initialState);
+  const open = useCallback2(() => setOpened(true), []);
+  const close = useCallback2(() => setOpened(false), []);
+  const toggle = useCallback2(() => setOpened((prev) => !prev), []);
+  return [opened, { open, close, toggle }];
+}
+
+// src/hooks/useResizablePanel.ts
+import { useState as useState3, useRef, useCallback as useCallback3, useEffect } from "react";
+function useResizablePanel(options = {}) {
+  const {
+    defaultWidth = 320,
+    minWidth = 260,
+    maxWidth = 640,
+    direction = "left-edge"
+  } = options;
+  const [panelWidth, setPanelWidth] = useState3(defaultWidth);
+  const resizingRef = useRef(false);
+  const startXRef = useRef(0);
+  const startWidthRef = useRef(0);
+  const clamp = useCallback3(
+    (v) => Math.min(Math.max(v, minWidth), maxWidth),
+    [minWidth, maxWidth]
+  );
+  const finishResize = useCallback3(() => {
+    if (!resizingRef.current) return;
+    resizingRef.current = false;
+    document.body.classList.remove("select-none");
+  }, []);
+  const handlePointerMove = useCallback3(
+    (e) => {
+      if (!resizingRef.current) return;
+      const delta = e.clientX - startXRef.current;
+      const newWidth = direction === "right-edge" ? startWidthRef.current + delta : startWidthRef.current - delta;
+      setPanelWidth(clamp(newWidth));
+    },
+    [clamp, direction]
+  );
+  const handlePointerDown = useCallback3(
+    (e) => {
+      resizingRef.current = true;
+      startXRef.current = e.clientX;
+      startWidthRef.current = panelWidth;
+      document.body.classList.add("select-none");
+    },
+    [panelWidth]
+  );
+  const handleDoubleClick = useCallback3(
+    () => setPanelWidth(defaultWidth),
+    [defaultWidth]
+  );
+  useEffect(() => {
+    window.addEventListener("pointermove", handlePointerMove);
+    window.addEventListener("pointerup", finishResize);
+    window.addEventListener("pointercancel", finishResize);
+    const handleKey = (e) => {
+      if (e.key === "Escape" && resizingRef.current) {
+        setPanelWidth(startWidthRef.current);
+        finishResize();
+      }
+    };
+    window.addEventListener("keydown", handleKey);
+    return () => {
+      window.removeEventListener("pointermove", handlePointerMove);
+      window.removeEventListener("pointerup", finishResize);
+      window.removeEventListener("pointercancel", finishResize);
+      window.removeEventListener("keydown", handleKey);
+    };
+  }, [handlePointerMove, finishResize]);
+  return {
+    panelWidth,
+    handlePointerDown,
+    handleDoubleClick,
+    separatorProps: {
+      role: "separator",
+      "aria-orientation": "vertical",
+      "aria-valuenow": panelWidth,
+      "aria-valuemin": minWidth,
+      "aria-valuemax": maxWidth
+    }
+  };
+}
+
+// src/hooks/useFormState.ts
+import { useState as useState4, useCallback as useCallback4, useMemo } from "react";
+function useFormState(initialData) {
+  const [data, setDataState] = useState4(initialData);
+  const [original, setOriginal] = useState4(initialData);
+  const isDirty = useMemo(() => {
+    return !isEqual(data, original);
+  }, [data, original]);
+  const setData = useCallback4((newData) => {
+    setDataState(newData);
+  }, []);
+  const setField = useCallback4((field, value) => {
+    setDataState((prev) => ({
+      ...prev,
+      [field]: value
+    }));
+  }, []);
+  const reset = useCallback4((newData) => {
+    setDataState(newData);
+    setOriginal(newData);
+  }, []);
+  const discard = useCallback4(() => {
+    setDataState(original);
+  }, [original]);
+  return {
+    data,
+    setData,
+    setField,
+    isDirty,
+    reset,
+    discard,
+    original
+  };
+}
+
+// src/hooks/useEntityOptions.ts
+import { useState as useState5, useEffect as useEffect2, useCallback as useCallback5 } from "react";
+import { useQuery } from "@tanstack/react-query";
+function resolveEnabled(enabled, mode, activeSearch, minChars, committedSearch) {
+  if (!enabled) return false;
+  if (mode === "typeahead") return activeSearch.length >= minChars;
+  if (mode === "explicit") return committedSearch !== null;
+  return true;
+}
+function useEntityOptions({
+  fetcher,
+  queryKey,
+  mode = "eager",
+  debounceMs = 300,
+  minChars = 1,
+  limit = 50,
+  enabled = true
+}) {
+  const [search, setSearch] = useState5("");
+  const [debouncedSearch, setDebouncedSearch] = useState5("");
+  const [committedSearch, setCommittedSearch] = useState5(null);
+  useEffect2(() => {
+    if (mode === "explicit") return;
+    const timer = setTimeout(() => setDebouncedSearch(search), debounceMs);
+    return () => clearTimeout(timer);
+  }, [search, debounceMs, mode]);
+  const submit = useCallback5(() => {
+    setCommittedSearch(search);
+  }, [search]);
+  const activeSearch = mode === "explicit" ? committedSearch ?? "" : debouncedSearch;
+  const queryEnabled = resolveEnabled(
+    enabled,
+    mode,
+    activeSearch,
+    minChars,
+    committedSearch
+  );
+  const { data, isLoading, isError } = useQuery({
+    queryKey: [queryKey, "options", { search: activeSearch, limit }],
+    queryFn: () => fetcher({ search: activeSearch || void 0, limit }),
+    enabled: queryEnabled,
+    staleTime: 5 * 60 * 1e3
+  });
+  const options = data ?? [];
+  return { options, isLoading, isError, search, setSearch, submit };
+}
+export {
+  useClipboard,
+  useDisclosure,
+  useEntityOptions,
+  useFormState,
+  useResizablePanel
+};
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useClipboard.ts","../../src/hooks/useDisclosure.ts","../../src/hooks/useResizablePanel.ts","../../src/hooks/useFormState.ts","../../src/hooks/useEntityOptions.ts"],"sourcesContent":["import { useState, useCallback } from \"react\";\n\nexport interface UseClipboardOptions {\n  timeout?: number;\n}\n\nexport interface UseClipboardReturn {\n  copy: (text: string) => Promise<void>;\n  copied: boolean;\n  error: Error | null;\n  reset: () => void;\n}\n\n/**\n * Custom hook for clipboard operations\n *\n * Replaces Mantine's useClipboard hook with native Clipboard API\n *\n * @param options - Configuration options\n * @param options.timeout - Time in ms before copied state resets (default: 2000)\n * @returns Object with copy function, copied state, error, and reset function\n *\n * @example\n * ```tsx\n * const { copy, copied } = useClipboard({ timeout: 3000 });\n *\n * <button onClick={() => copy('Hello World')}>\n *   {copied ? 'Copied!' : 'Copy'}\n * </button>\n * ```\n */\nexport function useClipboard({\n  timeout = 2000,\n}: UseClipboardOptions = {}): UseClipboardReturn {\n  const [copied, setCopied] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  const copy = useCallback(\n    async (text: string) => {\n      try {\n        await navigator.clipboard.writeText(text);\n        setCopied(true);\n        setError(null);\n\n        // Reset copied state after timeout\n        setTimeout(() => setCopied(false), timeout);\n      } catch (err) {\n        setError(err instanceof Error ? err : new Error(String(err)));\n        setCopied(false);\n      }\n    },\n    [timeout],\n  );\n\n  const reset = useCallback(() => {\n    setCopied(false);\n    setError(null);\n  }, []);\n\n  return { copy, copied, error, reset };\n}\n","import { useState, useCallback } from \"react\";\n\nexport interface UseDisclosureReturn {\n  open: () => void;\n  close: () => void;\n  toggle: () => void;\n}\n\n/**\n * Custom hook for managing open/close state\n *\n * Replaces Mantine's useDisclosure hook with simple useState wrapper\n *\n * @param initialState - Initial open state (default: false)\n * @returns Tuple of [opened, handlers] where handlers contains open, close, toggle functions\n *\n * @example\n * ```tsx\n * const [opened, { open, close, toggle }] = useDisclosure();\n *\n * <button onClick={open}>Open Modal</button>\n * <Modal opened={opened} onClose={close}>\n *   <button onClick={toggle}>Toggle</button>\n * </Modal>\n * ```\n */\nexport function useDisclosure(\n  initialState = false,\n): readonly [boolean, UseDisclosureReturn] {\n  const [opened, setOpened] = useState(initialState);\n\n  const open = useCallback(() => setOpened(true), []);\n  const close = useCallback(() => setOpened(false), []);\n  const toggle = useCallback(() => setOpened((prev) => !prev), []);\n\n  return [opened, { open, close, toggle }] as const;\n}\n","/**\n * Custom hook for resizable panel functionality.\n * Extracted from GraphViewer to be reusable across components.\n *\n * @module hooks/useResizablePanel\n */\n\nimport { useState, useRef, useCallback, useEffect } from \"react\";\n\ninterface UseResizablePanelOptions {\n  defaultWidth?: number;\n  minWidth?: number;\n  maxWidth?: number;\n  /**\n   * Which edge the drag handle sits on relative to the panel content.\n   *\n   * - \"left-edge\"  — handle is on the panel's left; dragging right shrinks the\n   *                  panel (default, matches the right-side action panel in\n   *                  GraphViewer where the separator is left of the panel).\n   * - \"right-edge\" — handle is on the panel's right; dragging right grows the\n   *                  panel (matches a left-side SidePane where the separator is\n   *                  right of the panel).\n   */\n  direction?: \"left-edge\" | \"right-edge\";\n}\n\ninterface UseResizablePanelReturn {\n  panelWidth: number;\n  handlePointerDown: (e: React.PointerEvent) => void;\n  handleDoubleClick: () => void;\n  separatorProps: {\n    role: string;\n    \"aria-orientation\": \"vertical\";\n    \"aria-valuenow\": number;\n    \"aria-valuemin\": number;\n    \"aria-valuemax\": number;\n  };\n}\n\n/**\n * Hook for managing resizable panel state and interactions.\n * Handles pointer events, constraints, and keyboard shortcuts (Escape to cancel).\n */\nexport function useResizablePanel(\n  options: UseResizablePanelOptions = {},\n): UseResizablePanelReturn {\n  const {\n    defaultWidth = 320,\n    minWidth = 260,\n    maxWidth = 640,\n    direction = \"left-edge\",\n  } = options;\n\n  const [panelWidth, setPanelWidth] = useState<number>(defaultWidth);\n  const resizingRef = useRef(false);\n  const startXRef = useRef(0);\n  const startWidthRef = useRef(0);\n\n  const clamp = useCallback(\n    (v: number) => Math.min(Math.max(v, minWidth), maxWidth),\n    [minWidth, maxWidth],\n  );\n\n  const finishResize = useCallback(() => {\n    if (!resizingRef.current) return;\n    resizingRef.current = false;\n    document.body.classList.remove(\"select-none\");\n  }, []);\n\n  const handlePointerMove = useCallback(\n    (e: PointerEvent) => {\n      if (!resizingRef.current) return;\n      const delta = e.clientX - startXRef.current;\n      // left-edge: separator left of panel, drag right shrinks (subtract delta)\n      // right-edge: separator right of panel, drag right grows (add delta)\n      const newWidth =\n        direction === \"right-edge\"\n          ? startWidthRef.current + delta\n          : startWidthRef.current - delta;\n      setPanelWidth(clamp(newWidth));\n    },\n    [clamp, direction],\n  );\n\n  const handlePointerDown = useCallback(\n    (e: React.PointerEvent) => {\n      resizingRef.current = true;\n      startXRef.current = e.clientX;\n      startWidthRef.current = panelWidth;\n      document.body.classList.add(\"select-none\");\n    },\n    [panelWidth],\n  );\n\n  const handleDoubleClick = useCallback(\n    () => setPanelWidth(defaultWidth),\n    [defaultWidth],\n  );\n\n  useEffect(() => {\n    window.addEventListener(\"pointermove\", handlePointerMove);\n    window.addEventListener(\"pointerup\", finishResize);\n    window.addEventListener(\"pointercancel\", finishResize);\n\n    const handleKey = (e: KeyboardEvent) => {\n      if (e.key === \"Escape\" && resizingRef.current) {\n        setPanelWidth(startWidthRef.current);\n        finishResize();\n      }\n    };\n    window.addEventListener(\"keydown\", handleKey);\n\n    return () => {\n      window.removeEventListener(\"pointermove\", handlePointerMove);\n      window.removeEventListener(\"pointerup\", finishResize);\n      window.removeEventListener(\"pointercancel\", finishResize);\n      window.removeEventListener(\"keydown\", handleKey);\n    };\n  }, [handlePointerMove, finishResize]);\n\n  return {\n    panelWidth,\n    handlePointerDown,\n    handleDoubleClick,\n    separatorProps: {\n      role: \"separator\",\n      \"aria-orientation\": \"vertical\",\n      \"aria-valuenow\": panelWidth,\n      \"aria-valuemin\": minWidth,\n      \"aria-valuemax\": maxWidth,\n    },\n  };\n}\n","/**\n * useFormState Hook\n *\n * Manages form state with automatic dirty tracking and common operations.\n * Tracks changes against original data to determine if form has been modified.\n *\n * @module hooks/useFormState\n */\n\nimport { useState, useCallback, useMemo } from \"react\";\nimport { isEqual } from \"../utils\";\n\n/**\n * Return type for useFormState hook\n */\nexport interface UseFormStateReturn<T> {\n  /** Current form data */\n  data: T;\n  /** Update form data (partial or full) */\n  setData: (data: T | ((prev: T) => T)) => void;\n  /** Update a single field */\n  setField: <K extends keyof T>(field: K, value: T[K]) => void;\n  /** Whether form has been modified */\n  isDirty: boolean;\n  /** Load new data and mark as clean (for switching items) */\n  reset: (newData: T) => void;\n  /** Revert to original data */\n  discard: () => void;\n  /** Original data for comparison */\n  original: T;\n}\n\n/**\n * Hook for managing form state with dirty tracking\n *\n * Provides state management for forms with automatic change detection.\n * Compares current data against original to determine if form has been modified.\n *\n * @template T - Type of the form data\n * @param initialData - Initial form data\n * @returns Form state and control functions\n *\n * @example\n * ```tsx\n * interface FormData {\n *   name: string;\n *   email: string;\n * }\n *\n * function MyForm() {\n *   const form = useFormState<FormData>({\n *     name: '',\n *     email: '',\n *   });\n *\n *   // Update field\n *   form.setField('name', 'John');\n *\n *   // Check if dirty\n *   if (form.isDirty) {\n *     console.log('Form has unsaved changes');\n *   }\n *\n *   // Load new data (e.g., from API)\n *   form.reset({ name: 'Jane', email: 'jane@example.com' });\n *\n *   // Revert changes\n *   form.discard();\n * }\n * ```\n */\nexport function useFormState<T>(initialData: T): UseFormStateReturn<T> {\n  const [data, setDataState] = useState<T>(initialData);\n  const [original, setOriginal] = useState<T>(initialData);\n\n  /**\n   * Compute dirty state by comparing current data with original\n   */\n  const isDirty = useMemo(() => {\n    return !isEqual(data, original);\n  }, [data, original]);\n\n  /**\n   * Update form data\n   */\n  const setData = useCallback((newData: T | ((prev: T) => T)) => {\n    setDataState(newData);\n  }, []);\n\n  /**\n   * Update a single field\n   */\n  const setField = useCallback(<K extends keyof T>(field: K, value: T[K]) => {\n    setDataState((prev) => ({\n      ...prev,\n      [field]: value,\n    }));\n  }, []);\n\n  /**\n   * Load new data and mark as clean\n   * Use when loading data from API or switching between items\n   */\n  const reset = useCallback((newData: T) => {\n    setDataState(newData);\n    setOriginal(newData);\n  }, []);\n\n  /**\n   * Revert to original data\n   * Use when user clicks \"Cancel\" or \"Discard Changes\"\n   */\n  const discard = useCallback(() => {\n    setDataState(original);\n  }, [original]);\n\n  return {\n    data,\n    setData,\n    setField,\n    isDirty,\n    reset,\n    discard,\n    original,\n  };\n}\n","/**\n * useEntityOptions -- fetch selectable options from any data source.\n *\n * Transport-agnostic: receives an EntityOptionFetcher and returns\n * TanStack Query state. Supports three search modes:\n *\n *   eager     -- fetches on mount, refetches on debounced search (default)\n *   typeahead -- fetches only after the user types >= minChars (debounced)\n *   explicit  -- fetches only when submit() is called\n *\n * Extractable to @petrarca/sonnet-core/hooks -- no app-specific imports.\n */\n\nimport { useState, useEffect, useCallback } from \"react\";\nimport { useQuery } from \"@tanstack/react-query\";\nimport type { EntityOption, EntityOptionFetcher } from \"../entityOptions\";\n\n/** Search mode for the entity options hook and EntitySelect component. */\nexport type EntitySelectMode = \"eager\" | \"typeahead\" | \"explicit\";\n\nexport interface UseEntityOptionsConfig {\n  /** The fetcher function (created by a fetcher factory or provided directly). */\n  fetcher: EntityOptionFetcher;\n  /** TanStack Query cache key prefix. Must be stable. */\n  queryKey: string;\n  /**\n   * Search mode. Default: \"eager\".\n   *   eager     -- fetch on mount, refetch on debounced typing\n   *   typeahead -- fetch only after minChars are typed (debounced)\n   *   explicit  -- fetch only when submit() is called\n   */\n  mode?: EntitySelectMode;\n  /** Debounce delay in ms for the search input (default 300). */\n  debounceMs?: number;\n  /** Minimum characters before typeahead fires (default 1). Ignored in other modes. */\n  minChars?: number;\n  /** Maximum options to fetch (default 50). */\n  limit?: number;\n  /** Disable fetching (e.g. when a dependency is not yet satisfied). */\n  enabled?: boolean;\n}\n\nexport interface UseEntityOptionsReturn {\n  /** Current options from the server. */\n  options: EntityOption[];\n  /** Whether a fetch is in progress. */\n  isLoading: boolean;\n  /** Whether the fetch errored. */\n  isError: boolean;\n  /** The current search string (set by the combobox input). */\n  search: string;\n  /** Update the search string (drives debounced refetch). */\n  setSearch: (value: string) => void;\n  /** Trigger a fetch with the current search string. Only meaningful in explicit mode. */\n  submit: () => void;\n}\n\n// Determine whether the query should be enabled based on mode and state.\nfunction resolveEnabled(\n  enabled: boolean,\n  mode: EntitySelectMode,\n  activeSearch: string,\n  minChars: number,\n  committedSearch: string | null,\n): boolean {\n  if (!enabled) return false;\n  if (mode === \"typeahead\") return activeSearch.length >= minChars;\n  if (mode === \"explicit\") return committedSearch !== null;\n  return true;\n}\n\nexport function useEntityOptions({\n  fetcher,\n  queryKey,\n  mode = \"eager\",\n  debounceMs = 300,\n  minChars = 1,\n  limit = 50,\n  enabled = true,\n}: UseEntityOptionsConfig): UseEntityOptionsReturn {\n  const [search, setSearch] = useState(\"\");\n\n  // Debounced search drives eager and typeahead modes.\n  const [debouncedSearch, setDebouncedSearch] = useState(\"\");\n  // Committed search drives explicit mode -- only updated on submit().\n  const [committedSearch, setCommittedSearch] = useState<string | null>(null);\n\n  useEffect(() => {\n    if (mode === \"explicit\") return;\n    const timer = setTimeout(() => setDebouncedSearch(search), debounceMs);\n    return () => clearTimeout(timer);\n  }, [search, debounceMs, mode]);\n\n  const submit = useCallback(() => {\n    setCommittedSearch(search);\n  }, [search]);\n\n  const activeSearch =\n    mode === \"explicit\" ? (committedSearch ?? \"\") : debouncedSearch;\n\n  const queryEnabled = resolveEnabled(\n    enabled,\n    mode,\n    activeSearch,\n    minChars,\n    committedSearch,\n  );\n\n  const { data, isLoading, isError } = useQuery({\n    queryKey: [queryKey, \"options\", { search: activeSearch, limit }],\n    queryFn: () => fetcher({ search: activeSearch || undefined, limit }),\n    enabled: queryEnabled,\n    staleTime: 5 * 60 * 1000,\n  });\n\n  const options: EntityOption[] = data ?? [];\n\n  return { options, isLoading, isError, search, setSearch, submit };\n}\n"],"mappings":"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","names":["useState","useCallback","useState","useCallback","useState","useCallback","useState","useCallback","useState","useEffect","useCallback"]}

package/dist/index.d.ts

@@ -0,0 +1,140 @@
+import { ClassValue } from 'clsx';
+import * as React from 'react';
+
+/** Field name used to embed stable form-internal item IDs on array items. Never sent to the server. */
+declare const FORM_ITEM_ID_FIELD: "_fid";
+/** Generate a stable 21-character form-internal item ID. */
+declare const generateId: () => string;
+declare function cn(...inputs: ClassValue[]): string;
+declare function isEqual(a: unknown, b: unknown): boolean;
+
+declare const devLog: (...a: unknown[]) => void;
+declare const infoLog: (...a: unknown[]) => void;
+declare const warnLog: (...a: unknown[]) => void;
+declare const errorLog: (...a: unknown[]) => void;
+
+declare function formatNumber(value: number | string | undefined | null): string;
+declare function formatNumberCompact(value: number | string | undefined | null): string;
+/** Format an ISO 8601 string as a short date (e.g. "Jan 15, 2026"). */
+declare function formatDate(iso: string | null | undefined): string;
+/** Format an ISO 8601 string as date + time (e.g. "Jan 15, 2026, 09:32 AM"). */
+declare function formatDateTime(iso: string | null | undefined): string;
+/**
+ * Format a timezone-aware ISO 8601 string preserving the original offset.
+ *
+ * Parses the date/time components and offset directly from the string so
+ * the emitter's local time and offset are shown exactly as recorded --
+ * independent of the viewer's timezone.
+ *
+ * Examples:
+ *   "2026-02-22T10:00:00+01:00" -> "22 Feb 2026 at 10:00 +01:00"
+ *   "2026-02-22T09:00:00Z"      -> "22 Feb 2026 at 09:00 UTC"
+ */
+declare function formatDateTimeTz(iso: string | null | undefined): string;
+/** Return "{count} {word}" with the word pluralized when count != 1. */
+declare function pluralize(count: number, word: string): string;
+
+/**
+ * Escapes HTML characters to prevent XSS and rendering issues
+ */
+declare function escapeHtml(value: string): string;
+declare function formatJsonValue(value: unknown, indent?: number): string;
+/**
+ * CSS custom properties for JSON syntax highlighting colors
+ */
+declare const JSON_CSS_VARIABLES: {
+    readonly "--json-key": "#2563eb";
+    readonly "--json-string": "#16a34a";
+    readonly "--json-number": "#ea580c";
+    readonly "--json-boolean": "#2563eb";
+    readonly "--json-null": "#64748b";
+    readonly "--json-punctuation": "#475569";
+    readonly "--json-fallback": "#6b7280";
+};
+
+/**
+ * Copy text to the system clipboard.
+ *
+ * Optionally calls `onSuccess` after a successful write. The caller
+ * provides its own notification mechanism (e.g. `notification.success`
+ * from the shell API) to keep this utility free of sonner or any other
+ * toast dependency.
+ */
+declare function copyTextToClipboard(text: string, options?: {
+    onSuccess?: (message: string) => void;
+}): Promise<void>;
+
+declare function snakeCaseToTitleCase(snakeCase: string): string;
+
+/**
+ * Error normalizer -- extract typed error info from any thrown value.
+ *
+ * Generic utility with no framework dependencies. Handles standard
+ * Error objects and Axios-shaped error responses via duck-typing
+ * (no axios import required).
+ */
+interface NormalizedError {
+    message: string;
+    status?: number;
+    details?: string[];
+}
+declare function normalizeError(err: unknown): NormalizedError;
+
+type PossibleRef<T> = React.Ref<T> | undefined;
+/**
+ * A custom hook that composes multiple refs.
+ * Accepts callback refs and RefObject(s).
+ */
+declare function useComposedRefs<T>(...refs: PossibleRef<T>[]): React.RefCallback<T>;
+
+/**
+ * Resolve JSON Pointer (RFC 6901) paths to character offset ranges
+ * within a formatted JSON string.
+ *
+ * Given a JSON string and a list of JSON Pointers, returns the
+ * [from, to] byte ranges covering the *value* of each pointer.
+ * The range includes the full value (object braces, array brackets,
+ * string quotes, nested content) so the user can freely edit
+ * everything inside.
+ *
+ * Zero external dependencies — pure TypeScript.
+ * Maps to @petrarca/sonnet-core on extraction.
+ */
+interface OffsetRange {
+    /** JSON Pointer that was resolved */
+    pointer: string;
+    /** Start character offset (inclusive) */
+    from: number;
+    /** End character offset (exclusive) */
+    to: number;
+}
+/**
+ * Resolve a list of JSON Pointers to character offset ranges.
+ *
+ * @param json - The formatted JSON string
+ * @param pointers - Array of JSON Pointer strings (e.g. "/metadata", "/definitions/Patient")
+ * @returns Array of resolved ranges sorted by position (unresolvable pointers are silently skipped)
+ */
+declare function resolvePointerRanges(json: string, pointers: string[]): OffsetRange[];
+
+/**
+ * Pagination types for paginated list responses.
+ *
+ * Generic shapes with no application-specific content.
+ * Extractable to @petrarca/sonnet-core: no app-specific imports.
+ */
+/** Pagination metadata included in paginated list responses. */
+interface PageMeta {
+    total: number;
+    limit: number;
+    offset: number;
+    has_next: boolean;
+    has_prev: boolean;
+}
+/** Paginated list response envelope. */
+interface PageResult<T> {
+    data: T[];
+    meta: PageMeta;
+}
+
+export { FORM_ITEM_ID_FIELD, JSON_CSS_VARIABLES, type NormalizedError, type OffsetRange, type PageMeta, type PageResult, cn, copyTextToClipboard, devLog, errorLog, escapeHtml, formatDate, formatDateTime, formatDateTimeTz, formatJsonValue, formatNumber, formatNumberCompact, generateId, infoLog, isEqual, normalizeError, pluralize, resolvePointerRanges, snakeCaseToTitleCase, useComposedRefs, warnLog };