@drawnagency/primitives 0.1.114 → 0.1.115

package/dist/{chunk-OAGJBCSH.js → chunk-4WQ36ZP7.js}

@@ -1,21 +1,36 @@
+import {
+  diagnosticsCollector
+} from "./chunk-GNF6KFQ7.js";
+
 // src/lib/tags.ts
 function reconcileTags(entries, sections) {
+  return reconcileTagsReport(entries, sections).entries;
+}
+function reconcileTagsReport(entries, sections) {
+  const report = diagnosticsCollector();
   const entryList = Array.isArray(entries) ? entries : [];
   const validIds = new Set(sections && typeof sections === "object" ? Object.keys(sections) : []);
   const seenTagIds = /* @__PURE__ */ new Set();
   const result = [];
   for (const entry of entryList) {
     if (!entry || typeof entry !== "object") continue;
-    if (typeof entry.id !== "string" || entry.id === "" || seenTagIds.has(entry.id)) continue;
+    if (typeof entry.id !== "string" || entry.id === "") continue;
+    if (seenTagIds.has(entry.id)) {
+      report.add("duplicate-id", entry.id);
+      continue;
+    }
     seenTagIds.add(entry.id);
     const claimed = Array.isArray(entry.sectionIds) ? entry.sectionIds : [];
     const sectionIds = [];
     for (const id of claimed) {
-      if (typeof id === "string" && validIds.has(id) && !sectionIds.includes(id)) sectionIds.push(id);
+      if (typeof id !== "string") continue;
+      if (!validIds.has(id)) report.add("dangling", id);
+      else if (sectionIds.includes(id)) report.add("duplicate-member", id);
+      else sectionIds.push(id);
     }
     result.push({ id: entry.id, label: typeof entry.label === "string" ? entry.label : "", sectionIds });
   }
-  return result;
+  return { entries: result, diagnostics: report.list() };
 }
 function siteTags(index) {
   return reconcileTags(index.tags ?? [], index.sections);
@@ -61,6 +76,7 @@ function mergeTags(args) {
 
 export {
   reconcileTags,
+  reconcileTagsReport,
   siteTags,
   tagDisplayLabel,
   mergeTags

package/dist/{chunk-PTY2RG2K.js → chunk-67P34WNW.js}

@@ -1,100 +1,50 @@
 import {
   documentOptionsSchema
 } from "./chunk-4TZJZU2T.js";
+import {
+  MediaConfigSchema
+} from "./chunk-APIJPTFG.js";
 import {
   FontNameSchema,
   HexColorSchema
 } from "./chunk-AASEGXNT.js";
 
-// src/schemas/media.ts
-import { z } from "zod";
-var VariantSchema = z.object({
-  width: z.number().int().positive(),
-  height: z.number().int().positive(),
-  size: z.number().int().nonnegative()
-});
-var MediaFolderSchema = z.object({
-  name: z.string().min(1),
-  parentId: z.string().nullable()
-  // null = root
-});
-var MediaItemSchema = z.object({
-  id: z.string(),
-  hash: z.string(),
-  kind: z.enum(["image", "animated", "video"]),
-  originalName: z.string(),
-  width: z.number().int().positive(),
-  height: z.number().int().positive(),
-  mimeType: z.string(),
-  size: z.number().int().nonnegative(),
-  folder: z.string(),
-  variants: z.array(VariantSchema),
-  alt: z.string().default(""),
-  // Where the original bytes live. "github" = committed to the repo (images,
-  // small loops); "assets" = large original in the AssetStore bucket. Legacy
-  // manifests have no field — default keeps them on the git path.
-  storage: z.enum(["github", "assets"]).default("github"),
-  // Public CDN URL for assets-backed originals, baked at upload time so
-  // resolution needs no env access in the browser or at SSR.
-  url: z.string().optional(),
-  // Seconds; videos only. Informational (library UI).
-  duration: z.number().positive().optional(),
-  // Display folder (MediaFolderSchema key). Absent = root/unfiled. NOT the
-  // git storage dir — that's `folder` above, which never changes.
-  folderId: z.string().optional(),
-  // System-generated assets (e.g. the Phase 3 social-preview raster) set this
-  // so the media-library UI can exclude them. Absent on all user uploads.
-  hidden: z.boolean().optional()
-});
-var ImageManifestSchema = z.object({
-  images: z.record(z.string(), MediaItemSchema),
-  folders: z.record(z.string(), MediaFolderSchema).default({})
-});
-var MediaConfigSchema = z.object({
-  sizes: z.array(z.number()).default([640, 1080, 1920]),
-  maxFileSize: z.number().default(5242880),
-  quality: z.number().min(1).max(100).default(85),
-  // Per-file cap for bucket-backed video uploads (bytes). The git-path cap is
-  // maxFileSize; anything between the two routes to the AssetStore.
-  maxAssetSize: z.number().default(209715200)
-});
-
 // src/schemas/site-config.ts
-import { z as z2 } from "zod";
+import { z } from "zod";
 
 // src/lib/corner-radius.ts
 var CORNER_RADIUS_OPTIONS = ["none", "small", "medium", "large"];
 
 // src/schemas/site-config.ts
-var StatusSchema = z2.enum(["draft", "live", "archived", "published"]).transform(
+var StatusSchema = z.enum(["draft", "live", "archived", "published"]).transform(
   (val) => val === "published" ? "live" : val
 );
-var SectionMetaSchema = z2.object({
-  type: z2.string(),
+var SectionMetaSchema = z.object({
+  type: z.string(),
   status: StatusSchema,
-  access: z2.array(z2.string())
+  access: z.array(z.string())
 });
 var RESERVED_SLUGS = ["edit", "api", "login", "set-password", "404", "present", "print", "audiences", "decks"];
 var PARSE_REJECTED_SLUGS = ["edit", "api", "login", "set-password", "404"];
-var PageStatusSchema = z2.enum(["live", "archived"]);
-var PageSchema = z2.object({
-  id: z2.string().min(1),
-  title: z2.string(),
-  slug: z2.string(),
-  isHome: z2.boolean(),
-  showInNav: z2.boolean(),
+var PageStatusSchema = z.enum(["live", "archived"]);
+var PageSchema = z.object({
+  id: z.string().min(1),
+  title: z.string(),
+  slug: z.string(),
+  isHome: z.boolean(),
+  showInNav: z.boolean(),
   status: PageStatusSchema,
-  access: z2.array(z2.string()),
-  order: z2.array(z2.string()),
+  access: z.array(z.string()),
+  order: z.array(z.string()),
   document: documentOptionsSchema.optional()
 });
 var SLUG_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
-var RawIndexSchema = z2.object({
-  siteId: z2.string(),
-  order: z2.array(z2.string()).optional(),
-  pages: z2.array(PageSchema).optional(),
-  sections: z2.record(z2.string(), SectionMetaSchema),
-  lastModified: z2.string().nullable().optional()
+var RawIndexSchema = z.object({
+  siteId: z.string(),
+  order: z.array(z.string()).optional(),
+  pages: z.array(PageSchema).optional(),
+  sections: z.record(z.string(), SectionMetaSchema),
+  lastModified: z.string().nullable().optional()
 });
 function normalizeRawIndex(data) {
   if (data.pages && data.pages.length > 0) {
@@ -124,34 +74,34 @@ function normalizeRawIndex(data) {
     lastModified: data.lastModified ?? null
   };
 }
-var CanonicalIndexSchema = z2.object({
-  siteId: z2.string(),
-  pages: z2.array(PageSchema),
-  sections: z2.record(z2.string(), SectionMetaSchema),
-  lastModified: z2.string().nullable().optional()
+var CanonicalIndexSchema = z.object({
+  siteId: z.string(),
+  pages: z.array(PageSchema),
+  sections: z.record(z.string(), SectionMetaSchema),
+  lastModified: z.string().nullable().optional()
 }).superRefine((data, ctx) => {
   const homes = data.pages.filter((p) => p.isHome);
   if (homes.length !== 1) {
-    ctx.addIssue({ code: z2.ZodIssueCode.custom, message: "Exactly one page must be the home page" });
+    ctx.addIssue({ code: z.ZodIssueCode.custom, message: "Exactly one page must be the home page" });
   }
   if (homes[0]?.status === "archived") {
-    ctx.addIssue({ code: z2.ZodIssueCode.custom, message: "The home page cannot be archived" });
+    ctx.addIssue({ code: z.ZodIssueCode.custom, message: "The home page cannot be archived" });
   }
   if (homes[0] && homes[0].slug !== "") {
-    ctx.addIssue({ code: z2.ZodIssueCode.custom, message: "The home page slug must be empty" });
+    ctx.addIssue({ code: z.ZodIssueCode.custom, message: "The home page slug must be empty" });
   }
   const seenSlugs = /* @__PURE__ */ new Set();
   for (const p of data.pages) {
     if (!p.isHome) {
       if (!SLUG_RE.test(p.slug)) {
-        ctx.addIssue({ code: z2.ZodIssueCode.custom, message: `Invalid slug "${p.slug}"` });
+        ctx.addIssue({ code: z.ZodIssueCode.custom, message: `Invalid slug "${p.slug}"` });
       }
       if (PARSE_REJECTED_SLUGS.includes(p.slug)) {
-        ctx.addIssue({ code: z2.ZodIssueCode.custom, message: `Slug "${p.slug}" is reserved` });
+        ctx.addIssue({ code: z.ZodIssueCode.custom, message: `Slug "${p.slug}" is reserved` });
       }
     }
     if (seenSlugs.has(p.slug)) {
-      ctx.addIssue({ code: z2.ZodIssueCode.custom, message: `Duplicate slug "${p.slug}"` });
+      ctx.addIssue({ code: z.ZodIssueCode.custom, message: `Duplicate slug "${p.slug}"` });
     }
     seenSlugs.add(p.slug);
   }
@@ -166,21 +116,21 @@ var CanonicalIndexSchema = z2.object({
   const duplicated = [...counts].filter(([, n]) => n > 1).map(([id]) => id);
   if (duplicated.length > 0) {
     ctx.addIssue({
-      code: z2.ZodIssueCode.custom,
+      code: z.ZodIssueCode.custom,
       message: `Section id(s) appear in more than one page order: ${fmtIds(duplicated)}`
     });
   }
   const orderedNotInSections = [...fromPagesSet].filter((id) => !sectionSet.has(id));
   if (orderedNotInSections.length > 0) {
     ctx.addIssue({
-      code: z2.ZodIssueCode.custom,
+      code: z.ZodIssueCode.custom,
       message: `Section id(s) in a page order but missing from sections{}: ${fmtIds(orderedNotInSections)}`
     });
   }
   const sectionsNotOrdered = sectionKeys.filter((id) => !fromPagesSet.has(id));
   if (sectionsNotOrdered.length > 0) {
     ctx.addIssue({
-      code: z2.ZodIssueCode.custom,
+      code: z.ZodIssueCode.custom,
       message: `Section id(s) in sections{} but not in any page order: ${fmtIds(sectionsNotOrdered)}`
     });
   }
@@ -189,60 +139,60 @@ var IndexSchema = RawIndexSchema.transform(normalizeRawIndex).pipe(CanonicalInde
 function normalizeSiteIndex(raw) {
   return IndexSchema.parse(raw);
 }
-var ChatbotTaskIdSchema = z2.string().min(1).max(32).regex(
+var ChatbotTaskIdSchema = z.string().min(1).max(32).regex(
   /^[a-z0-9](?:[a-z0-9_-]*[a-z0-9])?$/,
   "Task id must be lowercase letters, numbers, dashes, or underscores"
 );
-var ChatbotTaskSchema = z2.object({
+var ChatbotTaskSchema = z.object({
   id: ChatbotTaskIdSchema,
-  label: z2.string().min(1).max(60),
-  prompt: z2.string().max(4e3),
+  label: z.string().min(1).max(60),
+  prompt: z.string().max(4e3),
   // Audience names allowed to see this task; [] = all — same semantics as SectionMeta.access.
-  access: z2.array(z2.string()).default([])
+  access: z.array(z.string()).default([])
 });
-var ChatbotConfigSchema = z2.object({
-  enabled: z2.boolean().default(false),
+var ChatbotConfigSchema = z.object({
+  enabled: z.boolean().default(false),
   // Assistant display name shown in the widget header and used in the system
   // prompt. Blank falls back to "Portal Assistant" (resolveChatbotName).
-  name: z2.string().max(60).default("Portal Assistant"),
+  name: z.string().max(60).default("Portal Assistant"),
   // Per-audience name overrides, keyed by audience name — same inert-when-
   // deselected semantics as audiencePrompts.
-  audienceNames: z2.record(z2.string(), z2.string().max(60)).default({}),
+  audienceNames: z.record(z.string(), z.string().max(60)).default({}),
   // Brand-flavored waiting phrases, shown (with "…" appended) while the
   // assistant streams no text yet. Empty = the widget's "Thinking…" default.
-  thinkingPhrases: z2.array(z2.string().max(80)).max(30).default([]),
-  systemPrompt: z2.string().max(8e3).default(""),
+  thinkingPhrases: z.array(z.string().max(80)).max(30).default([]),
+  systemPrompt: z.string().max(8e3).default(""),
   // Audience names the widget is shown to — strict opt-in: [] = no viewer
   // sees it (editors always can via /edit). Gates: [...slug].astro + /api/chat.
-  audiences: z2.array(z2.string()).default([]),
+  audiences: z.array(z.string()).default([]),
   // Per-audience prompt overlays, keyed by audience name. Appended AFTER the
   // base systemPrompt, and ONLY for requests whose session audience matches
   // (or an editor's explicit test-panel simulation) — enforced in
   // assembleBrandChat. Keys are not validated against the audience list:
   // entries for deselected/renamed audiences are inert (strict opt-in means
   // those audiences cannot chat at all).
-  audiencePrompts: z2.record(z2.string(), z2.string().max(8e3)).default({}),
-  tasks: z2.array(ChatbotTaskSchema).max(20).default([])
+  audiencePrompts: z.record(z.string(), z.string().max(8e3)).default({}),
+  tasks: z.array(ChatbotTaskSchema).max(20).default([])
 }).superRefine((cfg, ctx) => {
   const seen = /* @__PURE__ */ new Set();
   for (const t of cfg.tasks) {
     if (seen.has(t.id)) {
-      ctx.addIssue({ code: z2.ZodIssueCode.custom, message: `Duplicate task id "${t.id}"` });
+      ctx.addIssue({ code: z.ZodIssueCode.custom, message: `Duplicate task id "${t.id}"` });
     }
     seen.add(t.id);
   }
 });
-var DeckBuilderConfigSchema = z2.object({
+var DeckBuilderConfigSchema = z.object({
   // Audience names whose members may CREATE decks — a Deck Creator. Strict
   // opt-in exactly like chatbot.audiences: [] = no viewer may build a deck.
   // Editors are super-admins over decks and are never gated by this list.
   // Gates: [...slug].astro's FAB, /decks, and POST /api/decks (canCreateDeck).
-  audiences: z2.array(z2.string()).default([]).describe(
+  audiences: z.array(z.string()).default([]).describe(
     "Audience names allowed to create decks in the Deck Builder. Strict opt-in \u2014 an empty list means no viewer can. Editors always can."
   )
 });
-var SiteConfigSchema = z2.object({
-  siteName: z2.string().default("Brand Portal"),
+var SiteConfigSchema = z.object({
+  siteName: z.string().default("Brand Portal"),
   primaryColor: HexColorSchema.default("#009ca6"),
   primaryContrast: HexColorSchema.default("#f0f0f0"),
   // Dark-mode overrides for the brand primary / accent. Only applied when
@@ -251,31 +201,31 @@ var SiteConfigSchema = z2.object({
   // CSS light-dark() function (see lib/theme-vars.ts).
   primaryColorDark: HexColorSchema.nullable().default(null),
   primaryContrastDark: HexColorSchema.nullable().default(null),
-  darkMode: z2.enum(["light", "dark", "optional"]).default("light"),
+  darkMode: z.enum(["light", "dark", "optional"]).default("light"),
   // Maps to the --radius-outer design token (see lib/corner-radius.ts);
   // defaults so pre-existing site-config.json files keep parsing.
-  cornerRadius: z2.enum(CORNER_RADIUS_OPTIONS).default("medium"),
+  cornerRadius: z.enum(CORNER_RADIUS_OPTIONS).default("medium"),
   headingFont: FontNameSchema.default("system-ui"),
   bodyFont: FontNameSchema.default("system-ui"),
-  uppercaseHeadings: z2.boolean().default(true),
-  uppercaseSubheadings: z2.boolean().default(true),
-  uppercaseNavHeadings: z2.boolean().default(true),
-  googleFontsUrl: z2.string().refine((url) => url.startsWith("https://fonts.googleapis.com/"), "Must be a Google Fonts URL").nullable().default(null),
+  uppercaseHeadings: z.boolean().default(true),
+  uppercaseSubheadings: z.boolean().default(true),
+  uppercaseNavHeadings: z.boolean().default(true),
+  googleFontsUrl: z.string().refine((url) => url.startsWith("https://fonts.googleapis.com/"), "Must be a Google Fonts URL").nullable().default(null),
   // Favicon stored as a data URL (SVG/PNG, small) so it travels with
   // site-config.json — no media manifest or CDN round-trip needed.
-  favicon: z2.string().refine((v) => v.startsWith("data:image/"), "Favicon must be an image data URL").nullable().default(null),
+  favicon: z.string().refine((v) => v.startsWith("data:image/"), "Favicon must be an image data URL").nullable().default(null),
   // Optional site logo, stored as media-library references (so it participates
   // in usage tracking + GC protection, and its resolved URL is reusable for the
   // Phase 3 social-preview image). Every field defaults so pre-existing
   // site-config.json files keep parsing.
-  logo: z2.object({
-    light: z2.object({ imageId: z2.string() }),
-    dark: z2.object({ imageId: z2.string() }).nullable().default(null),
-    invertInDark: z2.boolean().default(false),
-    showInNav: z2.boolean().default(true),
+  logo: z.object({
+    light: z.object({ imageId: z.string() }),
+    dark: z.object({ imageId: z.string() }).nullable().default(null),
+    invertInDark: z.boolean().default(false),
+    showInNav: z.boolean().default(true),
     // A nav logo stands in for the site name by default; the toggle is for
     // wordmark-less logos that still need the name spelled out.
-    hideTitle: z2.boolean().default(true)
+    hideTitle: z.boolean().default(true)
   }).nullable().default(null),
   media: MediaConfigSchema.default(MediaConfigSchema.parse({})),
   // Composed social-preview raster, stored as a media-library reference so it
@@ -284,17 +234,17 @@ var SiteConfigSchema = z2.object({
   // (the /api/media route only serves exact generated-variant widths), so the
   // og:image URL + dimensions are correct. Defaults null so pre-existing
   // configs keep parsing and sites without a preview emit no og:image tags.
-  previewImage: z2.object({
-    imageId: z2.string(),
-    width: z2.number().int().positive(),
-    height: z2.number().int().positive(),
+  previewImage: z.object({
+    imageId: z.string(),
+    width: z.number().int().positive(),
+    height: z.number().int().positive(),
     // Compose-logic version that produced this raster. Pre-existing rasters
     // (and manifests written before this field) default to 0, which is below
     // any current PREVIEW_COMPOSE_VERSION, so the editor regenerates them.
-    version: z2.number().int().nonnegative().default(0)
+    version: z.number().int().nonnegative().default(0)
   }).nullable().default(null),
   // Optional site description → og:description + <meta name="description">.
-  description: z2.string().max(300).nullable().default(null),
+  description: z.string().max(300).nullable().default(null),
   // Brand chatbot config (editor-owned; the platform kill switch lives in the
   // sites table, not here). Every field defaults so pre-existing
   // site-config.json files keep parsing.
@@ -305,11 +255,6 @@ var SiteConfigSchema = z2.object({
 });
 
 export {
-  VariantSchema,
-  MediaFolderSchema,
-  MediaItemSchema,
-  ImageManifestSchema,
-  MediaConfigSchema,
   StatusSchema,
   SectionMetaSchema,
   RESERVED_SLUGS,

package/dist/chunk-APIJPTFG.js

@@ -0,0 +1,64 @@
+// src/schemas/media.ts
+import { z } from "zod";
+var VariantSchema = z.object({
+  width: z.number().int().positive(),
+  height: z.number().int().positive(),
+  size: z.number().int().nonnegative()
+});
+var MediaFolderSchema = z.object({
+  name: z.string().min(1),
+  parentId: z.string().nullable()
+  // null = root
+});
+var MediaItemSchema = z.object({
+  id: z.string(),
+  hash: z.string(),
+  kind: z.enum(["image", "animated", "video"]),
+  originalName: z.string(),
+  width: z.number().int().positive(),
+  height: z.number().int().positive(),
+  mimeType: z.string(),
+  size: z.number().int().nonnegative(),
+  folder: z.string(),
+  variants: z.array(VariantSchema),
+  alt: z.string().default(""),
+  // Where the original bytes live. "github" = committed to the repo (images,
+  // small loops); "assets" = large original in the AssetStore bucket. Legacy
+  // manifests have no field — default keeps them on the git path.
+  storage: z.enum(["github", "assets"]).default("github"),
+  // Public CDN URL for assets-backed originals, baked at upload time so
+  // resolution needs no env access in the browser or at SSR.
+  url: z.string().optional(),
+  // Seconds; videos only. Informational (library UI).
+  duration: z.number().positive().optional(),
+  // Display folder (MediaFolderSchema key). Absent = root/unfiled. NOT the
+  // git storage dir — that's `folder` above, which never changes.
+  folderId: z.string().optional(),
+  // System-generated assets (e.g. the Phase 3 social-preview raster) set this
+  // so the media-library UI can exclude them. Absent on all user uploads.
+  hidden: z.boolean().optional()
+});
+var ImageManifestSchema = z.object({
+  images: z.record(z.string(), MediaItemSchema),
+  folders: z.record(z.string(), MediaFolderSchema).default({})
+});
+var MEDIA_GIT_MAX_BYTES = 5242880;
+var MEDIA_BUCKET_MAX_BYTES = 209715200;
+var MediaConfigSchema = z.object({
+  sizes: z.array(z.number()).default([640, 1080, 1920]),
+  maxFileSize: z.number().default(MEDIA_GIT_MAX_BYTES),
+  quality: z.number().min(1).max(100).default(85),
+  // Per-file cap for bucket-backed video uploads (bytes). The git-path cap is
+  // maxFileSize; anything between the two routes to the AssetStore.
+  maxAssetSize: z.number().default(MEDIA_BUCKET_MAX_BYTES)
+});
+
+export {
+  VariantSchema,
+  MediaFolderSchema,
+  MediaItemSchema,
+  ImageManifestSchema,
+  MEDIA_GIT_MAX_BYTES,
+  MEDIA_BUCKET_MAX_BYTES,
+  MediaConfigSchema
+};

package/dist/chunk-CDBURDPX.js

@@ -0,0 +1,90 @@
+import {
+  slugifyPageSlug
+} from "./chunk-S7QRHUWO.js";
+
+// src/media/utils.ts
+async function hashFileBuffer(buffer) {
+  if (typeof crypto !== "undefined" && crypto.subtle) {
+    const hashBuffer = await crypto.subtle.digest("SHA-256", buffer);
+    const hashArray = new Uint8Array(hashBuffer);
+    return Array.from(hashArray.slice(0, 8)).map((b) => b.toString(16).padStart(2, "0")).join("");
+  }
+  const bytes = new Uint8Array(buffer);
+  const seeds = [2166136261, 84696351];
+  let result = "";
+  for (const seed of seeds) {
+    let h = seed;
+    for (let i = 0; i < bytes.length; i++) {
+      h ^= bytes[i];
+      h = Math.imul(h, 16777619);
+    }
+    result += (h >>> 0).toString(16).padStart(8, "0");
+  }
+  return result;
+}
+function sanitizeMediaName(name) {
+  return slugifyPageSlug(name.replace(/\.[^.]+$/, ""));
+}
+var MIME_TO_EXT = {
+  "image/gif": "gif",
+  "image/apng": "apng",
+  "image/png": "png",
+  "image/jpeg": "jpg",
+  "image/webp": "webp",
+  "image/svg+xml": "svg",
+  "video/mp4": "mp4",
+  "video/webm": "webm"
+};
+var EXT_TO_MIME = {
+  ...Object.fromEntries(
+    Object.entries(MIME_TO_EXT).map(([mime, ext]) => [`.${ext}`, mime])
+  ),
+  ".jpeg": "image/jpeg"
+};
+function mimeToExt(mime) {
+  return MIME_TO_EXT[mime] ?? "bin";
+}
+function mediaThumbnailUrl(item) {
+  if (item.mimeType === "image/svg+xml" || item.kind !== "image") {
+    return `/api/media/${item.id}/original.${mimeToExt(item.mimeType)}`;
+  }
+  if (item.variants.length === 0) return null;
+  const smallest = item.variants.reduce((a, b) => a.width < b.width ? a : b);
+  return `/api/media/${item.id}/${smallest.width}.webp`;
+}
+function imageThumbnailUrl(item) {
+  return item?.kind === "image" ? mediaThumbnailUrl(item) : null;
+}
+function displayFilenameExt(mime) {
+  const ext = MIME_TO_EXT[mime];
+  return ext ? `.${ext}` : "";
+}
+function displayFilename(originalName, mimeType) {
+  const ext = MIME_TO_EXT[mimeType];
+  if (!ext) return originalName;
+  const suffix = `.${ext}`;
+  if (originalName.toLowerCase().endsWith(suffix)) return originalName;
+  return `${originalName}${suffix}`;
+}
+function formatFileSize(bytes) {
+  if (bytes >= 1048576) return `${Math.round(bytes / 1048576)}MB`;
+  if (bytes >= 1024) return `${Math.round(bytes / 1024)}KB`;
+  return `${bytes}B`;
+}
+function displayName(item) {
+  return item.originalName;
+}
+
+export {
+  hashFileBuffer,
+  sanitizeMediaName,
+  MIME_TO_EXT,
+  EXT_TO_MIME,
+  mimeToExt,
+  mediaThumbnailUrl,
+  imageThumbnailUrl,
+  displayFilenameExt,
+  displayFilename,
+  formatFileSize,
+  displayName
+};