@lettuceai/crisp 1.0.0 → 1.1.0

package/dist/lib/format.d.ts

@@ -1,6 +1,6 @@
-/** "Just now", "4 min ago", "Yesterday", "3 wk ago" — how a list says when. */
-export declare function relativeTime(when: Date | number, now?: Date | number): string;
-/** 950 → "950", 1 240 → "1.2k", 18 300 → "18k", 2 140 000 → "2.1M". */
-export declare function compactNumber(n: number): string;
-/** 1 536 000 → "1.5 MB". */
-export declare function fileSize(bytes: number): string;
+/** "Just now", "4 min ago", "Yesterday", "3 wk ago" — how a list says when. Other locales follow `Intl.RelativeTimeFormat`. */
+export declare function relativeTime(when: Date | number, now?: Date | number, locale?: string): string;
+/** 950 → "950", 1 240 → "1.2k", 18 300 → "18k", 2 140 000 → "2.1M". Other locales follow compact `Intl.NumberFormat`. */
+export declare function compactNumber(n: number, locale?: string): string;
+/** 1 536 000 → "1.5 MB". Other locales use `Intl.NumberFormat` with byte units. */
+export declare function fileSize(bytes: number, locale?: string): string;

package/dist/lib/ref.d.ts

@@ -0,0 +1,10 @@
+import type { Ref, RefCallback } from "react";
+/**
+ * Combines multiple React refs (callback or RefObject) into a single callback ref.
+ * Safely handles null and undefined refs.
+ */
+export declare function mergeRefs<T>(...refs: (Ref<T> | undefined | null)[]): RefCallback<T>;
+/**
+ * Extracts the ref from a React element across React 18 (element.ref) and React 19 (element.props.ref).
+ */
+export declare function getElementRef<T>(element: unknown): Ref<T> | undefined;

package/dist/lib/strings.d.ts

@@ -0,0 +1,221 @@
+import { type ReactNode } from "react";
+/** Every string crisp renders on its own: aria-labels, default prop text and status lines. */
+export interface CrispStrings {
+    actionBarBack: string;
+    alertDismiss: string;
+    alertShowDetails: string;
+    alertHideDetails: string;
+    appBarBack: string;
+    appBarSearch: string;
+    appBarClearSearch: string;
+    appBarCloseSearch: string;
+    audioItemPlay: (title: string) => string;
+    audioItemPause: (title: string) => string;
+    audioItemSeek: (title: string) => string;
+    avatarGroupPeople: (count: number) => string;
+    avatarPickerRemove: string;
+    avatarPickerTitle: string;
+    avatarPickerDescription: string;
+    avatarPickerCancel: string;
+    avatarPickerUse: string;
+    avatarPickerZoom: string;
+    bannerDismiss: string;
+    breadcrumbLabel: string;
+    breadcrumbMore: (count: number) => string;
+    carouselPosition: (index: number, count: number) => string;
+    carouselGoTo: (index: number) => string;
+    carouselPrevious: string;
+    carouselNext: string;
+    chipRemove: string;
+    citationSource: (title: string) => string;
+    citationVisit: string;
+    colorPickerCurrent: (value: string) => string;
+    colorPickerPick: string;
+    colorPickerHex: string;
+    comboboxPlaceholder: string;
+    comboboxSearch: string;
+    comboboxEmpty: string;
+    comboboxClear: string;
+    commandPaletteLabel: string;
+    commandPalettePlaceholder: string;
+    commandPaletteEmpty: string;
+    commandPaletteEscape: string;
+    composerPlaceholder: string;
+    composerMessage: string;
+    composerAttachment: string;
+    composerFile: string;
+    composerAttachmentRemove: (name: string | undefined) => string;
+    composerAddAttachment: string;
+    composerCancelRecording: string;
+    composerRecordVoice: string;
+    composerStopAndTranscribe: string;
+    composerTranscribing: string;
+    composerRecording: (elapsed: string) => string;
+    composerStop: string;
+    composerSend: string;
+    composerSending: string;
+    composerContinue: string;
+    composerSendAsSystem: string;
+    confirmTitle: string;
+    confirmCancel: string;
+    confirmConfirm: string;
+    confirmUndone: string;
+    copyButtonCopy: string;
+    copyButtonCopied: string;
+    datePickerPlaceholder: string;
+    datePickerPreviousMonth: string;
+    datePickerNextMonth: string;
+    datePickerTime: string;
+    dialogClose: string;
+    diffBefore: string;
+    diffAfter: string;
+    diffChanges: string;
+    downloadFailed: string;
+    downloadWaiting: string;
+    downloadVerifying: string;
+    downloadPaused: string;
+    downloadProgress: (done: string, total: string) => string;
+    downloadSpeed: (rate: string) => string;
+    downloadLeftSeconds: (seconds: number) => string;
+    downloadLeftMinutes: (minutes: number) => string;
+    downloadLeftHours: (hours: string) => string;
+    downloadPause: (name: string) => string;
+    downloadResume: (name: string) => string;
+    downloadRetry: (name: string) => string;
+    downloadCancel: (name: string) => string;
+    downloadFileCount: (count: number) => string;
+    downloadShowFiles: (count: number) => string;
+    downloadHideFiles: string;
+    downloadFailedCount: (failed: number, total: number) => string;
+    downloadFilesDone: (done: number, total: number) => string;
+    downloadFailedBadge: (count: number) => string;
+    dropzoneOver: string;
+    dropzoneIdle: string;
+    errorStateTitle: string;
+    errorStateRetry: string;
+    feedbackGood: string;
+    feedbackBad: string;
+    feedbackCopy: string;
+    feedbackCopied: string;
+    feedbackRetry: string;
+    formSave: string;
+    formCancel: string;
+    formUnsaved: string;
+    formDiscardTitle: string;
+    formDiscardMessage: string;
+    formDiscardConfirm: string;
+    formDiscardCancel: string;
+    imageViewerZoomIn: string;
+    imageViewerZoomOut: string;
+    imageViewerClose: string;
+    imageViewerPrevious: string;
+    imageViewerNext: string;
+    infiniteScrollLoading: string;
+    loadingState: string;
+    messageScene: string;
+    messageSystem: string;
+    messagePinned: string;
+    messageMenuTitle: string;
+    messageReasoning: string;
+    messageTyping: string;
+    modelSelectPlaceholder: string;
+    modelSelectTitle: string;
+    modelSelectDefault: string;
+    modelSelectVision: string;
+    modelSelectAudio: string;
+    navPrimary: string;
+    navCreate: string;
+    navCollapse: string;
+    navCollapseSidebar: string;
+    navExpandSidebar: string;
+    numberInputDecrease: string;
+    numberInputIncrease: string;
+    otpDigit: (index: number, total: number) => string;
+    paginationLabel: string;
+    paginationPrevious: string;
+    paginationNext: string;
+    paginationPage: (page: number) => string;
+    partitionBarFree: string;
+    promptSuggestionsTitle: string;
+    reorderableHandle: (index: number, count: number) => string;
+    resizableResize: string;
+    searchFieldPlaceholder: string;
+    searchFieldClear: string;
+    secretInputPaste: string;
+    secretInputClear: string;
+    secretInputShow: string;
+    secretInputHide: string;
+    secretInputChecking: string;
+    secretInputConnected: string;
+    selectMenuPlaceholder: string;
+    selectMenuClear: string;
+    selectMenuEmpty: string;
+    selectMenuSelected: (count: number) => string;
+    shelfBack: string;
+    shelfForward: string;
+    sheetClose: string;
+    splitButtonMore: string;
+    stepperProgress: (step: number, total: number) => string;
+    stepperBackTo: (label: string) => string;
+    tableEmpty: string;
+    tagInputPlaceholder: string;
+    tagInputRemove: (tag: string) => string;
+    tagInputLimit: (max: number) => string;
+    themeEditorPreset: string;
+    themeEditorCustom: string;
+    themeEditorDensity: string;
+    themeEditorDensityDefault: string;
+    themeEditorDensityCompact: string;
+    themeEditorRadius: string;
+    themeEditorRadiusSharp: string;
+    themeEditorRadiusDefault: string;
+    themeEditorRadiusRound: string;
+    themeEditorReset: string;
+    themeEditorDerived: string;
+    themeEditorDerivedHint: string;
+    themeEditorBody: string;
+    themeEditorMuted: string;
+    themeEditorAccent: string;
+    themeEditorContrast: (label: string, ratio: string, need: number) => string;
+    themeEditorSurface: string;
+    themeEditorSurfaceHint: string;
+    themeEditorForeground: string;
+    themeEditorForegroundHint: string;
+    themeEditorAccentHint: string;
+    themeEditorDanger: string;
+    themeEditorDangerHint: string;
+    themeEditorWarning: string;
+    themeEditorWarningHint: string;
+    themeEditorInfo: string;
+    themeEditorInfoHint: string;
+    themeEditorSecondary: string;
+    themeEditorSecondaryHint: string;
+    titleBarMinimize: string;
+    titleBarMaximize: string;
+    titleBarClose: string;
+    toastDismiss: string;
+    tourLabel: string;
+    tourSkip: string;
+    tourFinish: string;
+    tourBack: string;
+    tourNext: string;
+    treeCollapse: string;
+    treeExpand: string;
+}
+export declare const englishStrings: CrispStrings;
+interface CrispStringsValue {
+    strings: CrispStrings;
+    locale: string;
+}
+export interface CrispStringsProviderProps {
+    /** Only the strings you translate; the rest stay English. */
+    strings?: Partial<CrispStrings>;
+    /** A BCP 47 tag used by every `Intl` call and the format helpers. Default "en". */
+    locale?: string;
+    children: ReactNode;
+}
+/** Translates crisp's built-in text. Without it every component renders English and formats for "en". */
+export declare function CrispStringsProvider({ strings, locale, children }: CrispStringsProviderProps): import("react").JSX.Element;
+/** The active strings and locale, for components that render their own text with crisp's. */
+export declare function useCrispStrings(): CrispStringsValue;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lettuceai/crisp",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "React components, design tokens and motion for LettuceAI.",
   "keywords": [
     "react",
@@ -47,6 +47,7 @@
     "build": "vite build && tsc -p tsconfig.build.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "lint": "oxlint src",
+    "test": "bun test",
     "prepublishOnly": "bun run build"
   },
   "peerDependencies": {
@@ -66,6 +67,7 @@
     "tailwind-merge": "^3.6.0"
   },
   "devDependencies": {
+    "@types/bun": "^1.4.3",
     "@types/react": "^19.2.18",
     "@types/react-dom": "^19.2.4",
     "@vitejs/plugin-react": "^6.1.0",