img-upload-kit 1.1.1 → 2.0.1

package/dist/styles/tokens.css

@@ -0,0 +1,123 @@
+/* image-upload-kit — Layer 1: Design Tokens & Base Reset */
+
+:root,
+.iuk-root {
+  --iuk-bg: #ffffff;
+  --iuk-surface: #f8fafc;
+  --iuk-surface-hover: #f1f5f9;
+  --iuk-border: #e2e8f0;
+  --iuk-border-strong: #cbd5e1;
+  --iuk-text: #0f172a;
+  --iuk-text-muted: #64748b;
+  --iuk-primary: #2563eb;
+  --iuk-primary-hover: #1d4ed8;
+  --iuk-primary-soft: rgba(37, 99, 235, 0.1);
+  --iuk-danger: #dc2626;
+  --iuk-danger-soft: rgba(220, 38, 38, 0.1);
+  --iuk-success: #16a34a;
+  --iuk-success-soft: rgba(22, 163, 74, 0.1);
+  --iuk-warning: #d97706;
+  --iuk-warning-soft: rgba(217, 119, 6, 0.12);
+  --iuk-info: #0284c7;
+  --iuk-info-soft: rgba(2, 132, 199, 0.1);
+  --iuk-placeholder-bg: #f1f5f9;
+  --iuk-radius-sm: 6px;
+  --iuk-radius-md: 10px;
+  --iuk-radius-lg: 14px;
+  --iuk-shadow-sm: 0 1px 3px rgba(15, 23, 42, 0.08), 0 1px 2px rgba(15, 23, 42, 0.04);
+  --iuk-shadow-lg: 0 20px 40px -12px rgba(15, 23, 42, 0.22), 0 8px 16px -8px rgba(15, 23, 42, 0.12);
+  --iuk-font: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root:not([data-theme="light"]):not(.light),
+  :root:not([data-theme="light"]):not(.light) .iuk-root {
+    --iuk-bg: #0f172a;
+    --iuk-surface: #1e293b;
+    --iuk-surface-hover: #283548;
+    --iuk-border: #334155;
+    --iuk-border-strong: #475569;
+    --iuk-text: #f8fafc;
+    --iuk-text-muted: #94a3b8;
+    --iuk-primary: #3b82f6;
+    --iuk-primary-hover: #60a5fa;
+    --iuk-primary-soft: rgba(59, 130, 246, 0.18);
+    --iuk-danger: #ef4444;
+    --iuk-danger-soft: rgba(239, 68, 68, 0.18);
+    --iuk-success: #22c55e;
+    --iuk-success-soft: rgba(34, 197, 94, 0.18);
+    --iuk-warning: #f59e0b;
+    --iuk-warning-soft: rgba(245, 158, 11, 0.18);
+    --iuk-info: #38bdf8;
+    --iuk-info-soft: rgba(56, 189, 248, 0.18);
+    --iuk-placeholder-bg: #1e293b;
+    --iuk-shadow-sm: 0 1px 3px rgba(0, 0, 0, 0.35);
+    --iuk-shadow-lg: 0 24px 48px -12px rgba(0, 0, 0, 0.6);
+  }
+}
+
+[data-theme="dark"],
+[data-theme="dark"] .iuk-root,
+.dark,
+.dark .iuk-root {
+  --iuk-bg: #0f172a;
+  --iuk-surface: #1e293b;
+  --iuk-surface-hover: #283548;
+  --iuk-border: #334155;
+  --iuk-border-strong: #475569;
+  --iuk-text: #f8fafc;
+  --iuk-text-muted: #94a3b8;
+  --iuk-primary: #3b82f6;
+  --iuk-primary-hover: #60a5fa;
+  --iuk-primary-soft: rgba(59, 130, 246, 0.18);
+  --iuk-danger: #ef4444;
+  --iuk-danger-soft: rgba(239, 68, 68, 0.18);
+  --iuk-success: #22c55e;
+  --iuk-success-soft: rgba(34, 197, 94, 0.18);
+  --iuk-warning: #f59e0b;
+  --iuk-warning-soft: rgba(245, 158, 11, 0.18);
+  --iuk-info: #38bdf8;
+  --iuk-info-soft: rgba(56, 189, 248, 0.18);
+  --iuk-placeholder-bg: #1e293b;
+  --iuk-shadow-sm: 0 1px 3px rgba(0, 0, 0, 0.35);
+  --iuk-shadow-lg: 0 24px 48px -12px rgba(0, 0, 0, 0.6);
+}
+
+.iuk-root, .iuk-single, .iuk-multi, .iuk-modal-backdrop, .iuk-progress-dock, .iuk-minimized-dock {
+  box-sizing: border-box;
+  font-family: var(--iuk-font);
+  color: var(--iuk-text);
+}
+
+.iuk-root *, .iuk-root *::before, .iuk-root *::after, .iuk-modal-backdrop *, .iuk-progress-dock * {
+  box-sizing: border-box;
+}
+
+.iuk-hidden-input { display: none !important; }
+
+@keyframes iuk-spin { to { transform: rotate(360deg); } }
+
+.iuk-spin { animation: iuk-spin 0.85s linear infinite; flex-shrink: 0; }
+
+.iuk-spinner {
+  width: 30px;
+  height: 30px;
+  border-radius: 9999px;
+  border: 2.5px solid var(--iuk-border);
+  border-top-color: var(--iuk-primary);
+  animation: iuk-spin 0.8s linear infinite;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .iuk-spin,
+  .iuk-spinner,
+  .iuk-root *,
+  .iuk-single *,
+  .iuk-multi *,
+  .iuk-modal-backdrop *,
+  .iuk-progress-dock * {
+    animation-duration: 0.01ms !important;
+    animation-iteration-count: 1 !important;
+    transition-duration: 0.01ms !important;
+  }
+}

package/dist/styles.css

@@ -1,113 +1,127 @@
 /* image-upload-kit — bundled modular styles */
-/* image-upload-kit — Layer 1: Design Tokens & Base Reset */
-
-:root,
-.iuk-root {
-  --iuk-bg: #ffffff;
-  --iuk-surface: #f8fafc;
-  --iuk-surface-hover: #f1f5f9;
-  --iuk-border: #e2e8f0;
-  --iuk-border-strong: #cbd5e1;
-  --iuk-text: #0f172a;
-  --iuk-text-muted: #64748b;
-  --iuk-primary: #2563eb;
-  --iuk-primary-hover: #1d4ed8;
-  --iuk-primary-soft: rgba(37, 99, 235, 0.1);
-  --iuk-danger: #dc2626;
-  --iuk-danger-soft: rgba(220, 38, 38, 0.1);
-  --iuk-success: #16a34a;
-  --iuk-success-soft: rgba(22, 163, 74, 0.1);
-  --iuk-warning: #d97706;
-  --iuk-warning-soft: rgba(217, 119, 6, 0.12);
-  --iuk-info: #0284c7;
-  --iuk-info-soft: rgba(2, 132, 199, 0.1);
-  --iuk-placeholder-bg: #f1f5f9;
-  --iuk-radius-sm: 6px;
-  --iuk-radius-md: 10px;
-  --iuk-radius-lg: 14px;
-  --iuk-shadow-sm: 0 1px 3px rgba(15, 23, 42, 0.08), 0 1px 2px rgba(15, 23, 42, 0.04);
-  --iuk-shadow-lg: 0 20px 40px -12px rgba(15, 23, 42, 0.22), 0 8px 16px -8px rgba(15, 23, 42, 0.12);
-  --iuk-font: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
-}
-
-@media (prefers-color-scheme: dark) {
-  :root:not([data-theme="light"]):not(.light),
-  :root:not([data-theme="light"]):not(.light) .iuk-root {
-    --iuk-bg: #0f172a;
-    --iuk-surface: #1e293b;
-    --iuk-surface-hover: #283548;
-    --iuk-border: #334155;
-    --iuk-border-strong: #475569;
-    --iuk-text: #f8fafc;
-    --iuk-text-muted: #94a3b8;
-    --iuk-primary: #3b82f6;
-    --iuk-primary-hover: #60a5fa;
-    --iuk-primary-soft: rgba(59, 130, 246, 0.18);
-    --iuk-danger: #ef4444;
-    --iuk-danger-soft: rgba(239, 68, 68, 0.18);
-    --iuk-success: #22c55e;
-    --iuk-success-soft: rgba(34, 197, 94, 0.18);
-    --iuk-warning: #f59e0b;
-    --iuk-warning-soft: rgba(245, 158, 11, 0.18);
-    --iuk-info: #38bdf8;
-    --iuk-info-soft: rgba(56, 189, 248, 0.18);
-    --iuk-placeholder-bg: #1e293b;
-    --iuk-shadow-sm: 0 1px 3px rgba(0, 0, 0, 0.35);
-    --iuk-shadow-lg: 0 24px 48px -12px rgba(0, 0, 0, 0.6);
-  }
-}
-
-[data-theme="dark"],
-[data-theme="dark"] .iuk-root,
-.dark,
-.dark .iuk-root {
-  --iuk-bg: #0f172a;
-  --iuk-surface: #1e293b;
-  --iuk-surface-hover: #283548;
-  --iuk-border: #334155;
-  --iuk-border-strong: #475569;
-  --iuk-text: #f8fafc;
-  --iuk-text-muted: #94a3b8;
-  --iuk-primary: #3b82f6;
-  --iuk-primary-hover: #60a5fa;
-  --iuk-primary-soft: rgba(59, 130, 246, 0.18);
-  --iuk-danger: #ef4444;
-  --iuk-danger-soft: rgba(239, 68, 68, 0.18);
-  --iuk-success: #22c55e;
-  --iuk-success-soft: rgba(34, 197, 94, 0.18);
-  --iuk-warning: #f59e0b;
-  --iuk-warning-soft: rgba(245, 158, 11, 0.18);
-  --iuk-info: #38bdf8;
-  --iuk-info-soft: rgba(56, 189, 248, 0.18);
-  --iuk-placeholder-bg: #1e293b;
-  --iuk-shadow-sm: 0 1px 3px rgba(0, 0, 0, 0.35);
-  --iuk-shadow-lg: 0 24px 48px -12px rgba(0, 0, 0, 0.6);
-}
-
-.iuk-root, .iuk-single, .iuk-multi, .iuk-modal-backdrop, .iuk-progress-dock, .iuk-minimized-dock {
-  box-sizing: border-box;
-  font-family: var(--iuk-font);
-  color: var(--iuk-text);
-}
-
-.iuk-root *, .iuk-root *::before, .iuk-root *::after, .iuk-modal-backdrop *, .iuk-progress-dock * {
-  box-sizing: border-box;
-}
-
-.iuk-hidden-input { display: none !important; }
-
-@keyframes iuk-spin { to { transform: rotate(360deg); } }
-
-.iuk-spin { animation: iuk-spin 0.85s linear infinite; flex-shrink: 0; }
-
-.iuk-spinner {
-  width: 30px;
-  height: 30px;
-  border-radius: 9999px;
-  border: 2.5px solid var(--iuk-border);
-  border-top-color: var(--iuk-primary);
-  animation: iuk-spin 0.8s linear infinite;
-}
+/* image-upload-kit — Layer 1: Design Tokens & Base Reset */
+
+:root,
+.iuk-root {
+  --iuk-bg: #ffffff;
+  --iuk-surface: #f8fafc;
+  --iuk-surface-hover: #f1f5f9;
+  --iuk-border: #e2e8f0;
+  --iuk-border-strong: #cbd5e1;
+  --iuk-text: #0f172a;
+  --iuk-text-muted: #64748b;
+  --iuk-primary: #2563eb;
+  --iuk-primary-hover: #1d4ed8;
+  --iuk-primary-soft: rgba(37, 99, 235, 0.1);
+  --iuk-danger: #dc2626;
+  --iuk-danger-soft: rgba(220, 38, 38, 0.1);
+  --iuk-success: #16a34a;
+  --iuk-success-soft: rgba(22, 163, 74, 0.1);
+  --iuk-warning: #d97706;
+  --iuk-warning-soft: rgba(217, 119, 6, 0.12);
+  --iuk-info: #0284c7;
+  --iuk-info-soft: rgba(2, 132, 199, 0.1);
+  --iuk-placeholder-bg: #f1f5f9;
+  --iuk-radius-sm: 6px;
+  --iuk-radius-md: 10px;
+  --iuk-radius-lg: 14px;
+  --iuk-shadow-sm: 0 1px 3px rgba(15, 23, 42, 0.08), 0 1px 2px rgba(15, 23, 42, 0.04);
+  --iuk-shadow-lg: 0 20px 40px -12px rgba(15, 23, 42, 0.22), 0 8px 16px -8px rgba(15, 23, 42, 0.12);
+  --iuk-font: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root:not([data-theme="light"]):not(.light),
+  :root:not([data-theme="light"]):not(.light) .iuk-root {
+    --iuk-bg: #0f172a;
+    --iuk-surface: #1e293b;
+    --iuk-surface-hover: #283548;
+    --iuk-border: #334155;
+    --iuk-border-strong: #475569;
+    --iuk-text: #f8fafc;
+    --iuk-text-muted: #94a3b8;
+    --iuk-primary: #3b82f6;
+    --iuk-primary-hover: #60a5fa;
+    --iuk-primary-soft: rgba(59, 130, 246, 0.18);
+    --iuk-danger: #ef4444;
+    --iuk-danger-soft: rgba(239, 68, 68, 0.18);
+    --iuk-success: #22c55e;
+    --iuk-success-soft: rgba(34, 197, 94, 0.18);
+    --iuk-warning: #f59e0b;
+    --iuk-warning-soft: rgba(245, 158, 11, 0.18);
+    --iuk-info: #38bdf8;
+    --iuk-info-soft: rgba(56, 189, 248, 0.18);
+    --iuk-placeholder-bg: #1e293b;
+    --iuk-shadow-sm: 0 1px 3px rgba(0, 0, 0, 0.35);
+    --iuk-shadow-lg: 0 24px 48px -12px rgba(0, 0, 0, 0.6);
+  }
+}
+
+[data-theme="dark"],
+[data-theme="dark"] .iuk-root,
+.dark,
+.dark .iuk-root {
+  --iuk-bg: #0f172a;
+  --iuk-surface: #1e293b;
+  --iuk-surface-hover: #283548;
+  --iuk-border: #334155;
+  --iuk-border-strong: #475569;
+  --iuk-text: #f8fafc;
+  --iuk-text-muted: #94a3b8;
+  --iuk-primary: #3b82f6;
+  --iuk-primary-hover: #60a5fa;
+  --iuk-primary-soft: rgba(59, 130, 246, 0.18);
+  --iuk-danger: #ef4444;
+  --iuk-danger-soft: rgba(239, 68, 68, 0.18);
+  --iuk-success: #22c55e;
+  --iuk-success-soft: rgba(34, 197, 94, 0.18);
+  --iuk-warning: #f59e0b;
+  --iuk-warning-soft: rgba(245, 158, 11, 0.18);
+  --iuk-info: #38bdf8;
+  --iuk-info-soft: rgba(56, 189, 248, 0.18);
+  --iuk-placeholder-bg: #1e293b;
+  --iuk-shadow-sm: 0 1px 3px rgba(0, 0, 0, 0.35);
+  --iuk-shadow-lg: 0 24px 48px -12px rgba(0, 0, 0, 0.6);
+}
+
+.iuk-root, .iuk-single, .iuk-multi, .iuk-modal-backdrop, .iuk-progress-dock, .iuk-minimized-dock {
+  box-sizing: border-box;
+  font-family: var(--iuk-font);
+  color: var(--iuk-text);
+}
+
+.iuk-root *, .iuk-root *::before, .iuk-root *::after, .iuk-modal-backdrop *, .iuk-progress-dock * {
+  box-sizing: border-box;
+}
+
+.iuk-hidden-input { display: none !important; }
+
+@keyframes iuk-spin { to { transform: rotate(360deg); } }
+
+.iuk-spin { animation: iuk-spin 0.85s linear infinite; flex-shrink: 0; }
+
+.iuk-spinner {
+  width: 30px;
+  height: 30px;
+  border-radius: 9999px;
+  border: 2.5px solid var(--iuk-border);
+  border-top-color: var(--iuk-primary);
+  animation: iuk-spin 0.8s linear infinite;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .iuk-spin,
+  .iuk-spinner,
+  .iuk-root *,
+  .iuk-single *,
+  .iuk-multi *,
+  .iuk-modal-backdrop *,
+  .iuk-progress-dock * {
+    animation-duration: 0.01ms !important;
+    animation-iteration-count: 1 !important;
+    transition-duration: 0.01ms !important;
+  }
+}
 
 
 /* image-upload-kit — Layer 2: UI Primitives */
@@ -994,114 +1008,115 @@
 }
 
 
-/* ── AnimatedImage: blur-up crossfade image ─────────────────────────────── */
-.iuk-animated-image {
-  position: relative;
-  width: 100%;
-  height: 100%;
-  overflow: hidden;
-  overflow: clip;
-  border-radius: inherit;
-  clip-path: inset(0 round inherit);
-  contain: paint;
-}
-
-.iuk-animated-image--fill {
-  position: absolute;
-  inset: 0;
-}
-
-.iuk-animated-image__placeholder {
-  position: absolute;
-  inset: -16px;
-  width: calc(100% + 32px);
-  height: calc(100% + 32px);
-  object-position: center;
-  /* Tiny placeholder stretched to full size must be blurred to avoid pixelation.
-     The layer unmounts after the crossfade, so the filter only runs while loading. */
-  filter: blur(var(--iuk-animated-image-blur, 20px));
-  transform: scale(1.06);
-  transform-origin: center;
-  z-index: 1;
-  opacity: 1;
-  transition-property: opacity;
-  transition-timing-function: cubic-bezier(0.25, 0.1, 0.25, 1);
-  pointer-events: none;
-}
-
-.iuk-animated-image__placeholder--hidden {
-  opacity: 0;
-}
-
-.iuk-animated-image__img {
-  position: relative;
-  display: block;
-  z-index: 2;
-  width: 100%;
-  height: auto;
-  opacity: 0;
-  border-radius: inherit;
-  user-select: none;
-  -webkit-user-select: none;
-  -webkit-user-drag: none;
-  transition-property: opacity, transform;
-  transition-timing-function: cubic-bezier(0.25, 0.1, 0.25, 1), cubic-bezier(0.4, 0, 0.2, 1);
-}
-
-.iuk-animated-image__img[data-state='loaded'],
-.iuk-animated-image__img[data-state='error'] {
-  opacity: 1;
-}
-
-.iuk-animated-image--fill .iuk-animated-image__img {
-  position: absolute;
-  inset: 0;
-  height: 100%;
-}
-
-/* Pixel-perfect containment: no overscan or scaling offset */
-.iuk-animated-image--contain .iuk-animated-image__placeholder {
-  inset: 0;
-  width: 100%;
-  height: 100%;
-  transform: none;
-}
-
-.iuk-animated-image--contain .iuk-animated-image__img {
-  transform: none;
-}
-
-.iuk-animated-image__shimmer {
-  position: absolute;
-  inset: 0;
-  z-index: 3;
-  background: linear-gradient(
-    90deg,
-    transparent 0%,
-    var(--iuk-animated-image-shimmer, rgba(255, 255, 255, 0.12)) 50%,
-    transparent 100%
-  );
-  animation: iuk-animated-image-shimmer 1.8s infinite;
-  pointer-events: none;
-  transition: opacity 0.35s ease-out;
-}
-
-.iuk-animated-image__shimmer--hidden {
-  opacity: 0;
-}
-
-@keyframes iuk-animated-image-shimmer {
-  from { transform: translateX(-100%); }
-  to { transform: translateX(100%); }
-}
-
-@media (prefers-reduced-motion: reduce) {
-  .iuk-animated-image__img,
-  .iuk-animated-image__placeholder {
-    transition-duration: 0ms !important;
-    transition-delay: 0ms !important;
-  }
-  .iuk-animated-image__shimmer {
-    animation: none;
-  }
-}
+/* ── AnimatedImage: blur-up crossfade image (Imagine-Global parity) ─────── */
+.iuk-animated-image {
+  position: relative;
+  width: 100%;
+  height: 100%;
+  overflow: hidden;
+  overflow: clip;
+  border-radius: inherit;
+  clip-path: inset(0 round inherit);
+  contain: paint;
+  transition: background-color var(--iuk-animated-image-color-transition, 300ms ease);
+}
+
+.iuk-animated-image--fill {
+  position: absolute;
+  inset: 0;
+}
+
+.iuk-animated-image__placeholder {
+  position: absolute;
+  inset: 0;
+  width: 100%;
+  height: 100%;
+  object-position: center;
+  /* Tiny placeholder stretched to full size is blurred and scaled slightly so
+     blurred edges stay clipped inside the overflow: hidden wrapper. */
+  filter: blur(var(--iuk-animated-image-blur, 20px));
+  transform: scale(var(--iuk-animated-image-placeholder-scale, 1.1));
+  transform-origin: center;
+  z-index: 1;
+  opacity: 1;
+  transition: opacity var(--iuk-ai-ph-dur, 500ms) ease-in-out;
+  pointer-events: none;
+}
+
+.iuk-animated-image__placeholder--hidden {
+  opacity: 0;
+}
+
+.iuk-animated-image__img {
+  position: relative;
+  display: block;
+  z-index: 2;
+  width: 100%;
+  height: auto;
+  opacity: 0;
+  transform: scale(var(--iuk-animated-image-reveal-scale, 1.02));
+  border-radius: inherit;
+  user-select: none;
+  -webkit-user-select: none;
+  -webkit-user-drag: none;
+  transition:
+    opacity var(--iuk-animated-image-duration, 600ms) ease-in-out,
+    transform var(--iuk-animated-image-duration, 600ms) ease-in-out;
+}
+
+.iuk-animated-image__img[data-state='loaded'] {
+  opacity: 1;
+  transform: scale(1);
+}
+
+.iuk-animated-image__img[data-state='error'] {
+  opacity: 0;
+  visibility: hidden;
+}
+
+.iuk-animated-image--fill .iuk-animated-image__img {
+  position: absolute;
+  inset: 0;
+  height: 100%;
+}
+
+/* In contain mode, the generated blur placeholder stays visible with object-fit: cover
+   and scale(1.1) behind the contained image so letterbox/pillarbox bars show the blur. */
+.iuk-animated-image--contain .iuk-animated-image__img {
+  transform: none;
+}
+
+.iuk-animated-image__shimmer {
+  position: absolute;
+  inset: 0;
+  z-index: 3;
+  background: linear-gradient(
+    90deg,
+    transparent 0%,
+    var(--iuk-animated-image-shimmer, rgba(255, 255, 255, 0.1)) 50%,
+    transparent 100%
+  );
+  animation: iuk-animated-image-shimmer 2s infinite;
+  pointer-events: none;
+}
+
+.iuk-animated-image__shimmer--hidden {
+  opacity: 0;
+}
+
+@keyframes iuk-animated-image-shimmer {
+  from { transform: translateX(-100%); }
+  to { transform: translateX(100%); }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .iuk-animated-image__img,
+  .iuk-animated-image__placeholder {
+    transform: none !important;
+    transition-duration: 0ms !important;
+    transition-delay: 0ms !important;
+  }
+  .iuk-animated-image__shimmer {
+    animation: none;
+  }
+}

package/dist/types-BrP-o9nd.d.cts

@@ -0,0 +1,85 @@
+import { I as ImageUploadRecord } from './upload-C5Trd6Dh.cjs';
+
+interface StorageUploadParams {
+    bucket: string;
+    path: string;
+    data: Buffer | Uint8Array;
+    contentType: string;
+    upsert?: boolean;
+    cacheControl?: string;
+    contentHash?: string;
+    metadata?: Record<string, string>;
+}
+interface StorageUploadResult {
+    bucket: string;
+    path: string;
+    url: string;
+}
+interface StorageFileEntry {
+    name: string;
+    id?: string;
+    createdAt?: string;
+    size?: number;
+}
+interface StorageListOptions {
+    cursor?: string;
+    limit?: number;
+}
+type StoragePaginatedListResult = StorageFileEntry[] & {
+    items: StorageFileEntry[];
+    nextCursor?: string;
+};
+type StorageUploadOptions = StorageUploadParams;
+type StorageFileMetadata = StorageFileEntry;
+type StorageListResult = StoragePaginatedListResult;
+interface StorageAdapter {
+    /**
+     * Upload optimized image bytes to your storage backend and return its public URL.
+     */
+    upload(params: StorageUploadParams): Promise<StorageUploadResult>;
+    /**
+     * Delete an image from your storage backend by bucket and relative path.
+     */
+    delete(bucket: string, path: string): Promise<void>;
+    /**
+     * Optional: Check whether an object exists at the given bucket and relative path.
+     */
+    exists?(bucket: string, path: string): Promise<boolean>;
+    /**
+     * Optional: Resolve a public URL for a bucket and path.
+     */
+    getPublicUrl?(bucket: string, path: string): string | Promise<string>;
+    /**
+     * Optional: List files inside a bucket/folder (supports optional cursor/limit pagination).
+     */
+    list?(bucket: string, folder?: string, options?: StorageListOptions): Promise<StoragePaginatedListResult>;
+    /**
+     * Optional: Delete an asset directly from its public URL.
+     */
+    deleteByUrl?(url: string): Promise<boolean>;
+    /**
+     * Optional: Parse a public storage URL into its bucket and relative path.
+     */
+    parseUrl?(url: string): {
+        bucket?: string;
+        path: string;
+    } | null;
+}
+type UploadRecordHook = (record: ImageUploadRecord) => void | Promise<void>;
+/**
+ * Attaches non-enumerable `.items` and `.nextCursor` properties to a `StorageFileEntry[]`
+ * array so both array callers (`entries.map(...)`) and paginated destructuring callers
+ * (`const { items, nextCursor } = await adapter.list(...)`) work seamlessly.
+ */
+declare function toPaginatedListResult(entries: StorageFileEntry[], nextCursor?: string): StoragePaginatedListResult;
+/**
+ * Validates that storage metadata keys and values contain only printable ASCII
+ * characters (preventing HTTP header/CRLF injection) and do not exceed 2 KB total.
+ */
+declare function validateStorageMetadata(metadata?: Record<string, string>): void;
+/**
+ * Type-safe helper for authoring a custom StorageAdapter (S3, R2, Vercel Blob, Firebase, etc.).
+ */
+declare function createStorageAdapter(adapter: StorageAdapter): StorageAdapter;
+
+export { type StorageAdapter as S, type UploadRecordHook as U, type StorageListOptions as a, type StoragePaginatedListResult as b, type StorageFileEntry as c, type StorageFileMetadata as d, type StorageListResult as e, type StorageUploadOptions as f, type StorageUploadParams as g, type StorageUploadResult as h, createStorageAdapter as i, toPaginatedListResult as t, validateStorageMetadata as v };