@flanksource/clicky-ui 0.3.58 → 0.3.59

package/dist/data/clicky-download.cjs

@@ -0,0 +1,251 @@
+const require_UiEye = require("../icons/components/UiEye.cjs");
+const require_UiTable = require("../icons/components/UiTable.cjs");
+const require_UiComment = require("../icons/components/UiComment.cjs");
+const require_UiFileCode = require("../icons/components/UiFileCode.cjs");
+const require_UiJson = require("../icons/components/UiJson.cjs");
+const require_UiMarkdown = require("../icons/components/UiMarkdown.cjs");
+const require_UiFileText = require("../icons/components/UiFileText.cjs");
+const require_UiFileSpreadsheet = require("../icons/components/UiFileSpreadsheet.cjs");
+const require_string = require("../lib/string.cjs");
+// src/data/clicky-download.ts
+var CLICKY_PRIMARY_VIEW_FORMATS = ["clicky", "json"];
+var CLICKY_OVERFLOW_VIEW_FORMATS = [
+	"pdf",
+	"html",
+	"markdown",
+	"yaml",
+	"csv",
+	"pretty",
+	"excel",
+	"slack"
+];
+var CLICKY_DOWNLOAD_FORMATS = [
+	"yaml",
+	"json",
+	"csv",
+	"pdf",
+	"markdown"
+];
+function getDownloadFormats({ url, download }) {
+	if (!(download ? download.all ?? true : !!url) || !url) return [];
+	return download?.formats?.length ? [...download.formats] : [...CLICKY_DOWNLOAD_FORMATS];
+}
+function getDownloadScopes(download) {
+	return download?.scopes?.length ? download.scopes : [void 0];
+}
+function downloadDescription(format, scope, download) {
+	const maxRows = download?.formatMaxRows?.[format];
+	if (maxRows) return `Limited to ${maxRows.toLocaleString()} rows`;
+	if (scope === "all" && download?.allRowsMode === "buffered") return "Compatibility mode buffers the complete result";
+	if (scope === "all" && download?.allRowsMode === "streaming") return "Streams rows as they are read";
+}
+function exportFormatOptions({ url, download }) {
+	if (!url) return [];
+	return getDownloadFormats({
+		url,
+		download
+	}).map((format) => {
+		const meta = getRemoteFormatMeta(format);
+		return {
+			format,
+			label: meta.label,
+			description: meta.description,
+			icon: meta.icon,
+			...meta.iconClassName ? { iconClassName: meta.iconClassName } : {}
+		};
+	});
+}
+function exportScopeOptions(download, pagination) {
+	return getDownloadScopes(download).map((scope) => ({
+		scope,
+		label: scope === "all" || scope === void 0 ? allRowsLabel(pagination) : "Current page",
+		note: (format) => downloadDescription(format, scope, download)
+	}));
+}
+function allRowsLabel(pagination) {
+	const total = pagination?.total;
+	if (total === void 0) return "All rows";
+	const count = total.toLocaleString();
+	return pagination?.totalRelation === "gte" ? `All ${count}+ rows` : `All ${count} rows`;
+}
+async function runClickyDownload({ url, format, scope, download }) {
+	let failure = "";
+	await prepareDownload({
+		url,
+		format,
+		...scope ? { scope } : {},
+		...download ? { download } : {},
+		onError: (message) => {
+			failure = message;
+		}
+	});
+	if (failure) throw new Error(failure);
+}
+async function prepareDownload({ url, format, scope, download, onPending, onError }) {
+	onError?.("");
+	onPending?.(true);
+	try {
+		const prepared = download?.prepare ? await download.prepare({
+			format,
+			...scope ? { scope } : {}
+		}) : {
+			url,
+			...download?.label ? { label: download.label } : {}
+		};
+		if (!prepared.url.trim()) throw new Error("The prepared download URL is empty");
+		triggerDownload(buildDownloadUrl(prepared.url, format, prepared.label ?? download?.label, scope));
+	} catch (error) {
+		onError?.(error instanceof Error ? error.message : "Preparing the download failed");
+	} finally {
+		onPending?.(false);
+	}
+}
+function getRemoteFormatMeta(format) {
+	switch (format) {
+		case "clicky": return {
+			label: "Clicky",
+			description: "Rendered Clicky JSON with the rich Clicky viewer",
+			icon: require_UiEye.UiEye,
+			accept: "application/json+clicky, application/clicky+json;q=0.9, application/json;q=0.8,*/*;q=0.7"
+		};
+		case "json": return {
+			label: "JSON",
+			description: "Plain JSON for inspecting the raw response body",
+			icon: require_UiJson.UiJson,
+			accept: "application/json, text/plain;q=0.8,*/*;q=0.7"
+		};
+		case "ndjson": return {
+			label: "NDJSON",
+			description: "Newline-delimited JSON for streaming data pipelines",
+			icon: require_UiJson.UiJson,
+			accept: "application/x-ndjson, application/ndjson;q=0.9,*/*;q=0.7"
+		};
+		case "pdf": return {
+			label: "PDF",
+			description: "Portable document for sharing and printing",
+			icon: require_UiFileText.UiFileText,
+			iconClassName: "text-rose-600 dark:text-rose-400",
+			accept: "application/pdf, */*;q=0.7"
+		};
+		case "html": return {
+			label: "HTML",
+			description: "Browser-ready HTML preview of the formatted output",
+			icon: require_UiFileCode.UiFileCode,
+			accept: "text/html, */*;q=0.7"
+		};
+		case "markdown": return {
+			label: "Markdown",
+			description: "Markdown formatted for docs, comments, and chat",
+			icon: require_UiMarkdown.UiMarkdown,
+			accept: "text/markdown, text/plain;q=0.8,*/*;q=0.7"
+		};
+		case "yaml": return {
+			label: "YAML",
+			description: "YAML for config-friendly inspection and export",
+			icon: require_UiFileCode.UiFileCode,
+			iconClassName: "text-violet-600 dark:text-violet-400",
+			accept: "application/yaml, text/yaml;q=0.9, text/plain;q=0.8,*/*;q=0.7"
+		};
+		case "csv": return {
+			label: "CSV",
+			description: "Comma-separated values for spreadsheets and imports",
+			icon: require_UiFileSpreadsheet.UiFileSpreadsheet,
+			iconClassName: "text-emerald-600 dark:text-emerald-400",
+			accept: "text/csv, text/plain;q=0.8,*/*;q=0.7"
+		};
+		case "pretty": return {
+			label: "Pretty",
+			description: "Human-readable plain text output from the formatter",
+			icon: require_UiFileCode.UiFileCode,
+			accept: "text/plain, */*;q=0.7"
+		};
+		case "excel": return {
+			label: "Excel",
+			description: "Spreadsheet workbook for offline analysis",
+			icon: require_UiTable.UiTable,
+			accept: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, */*;q=0.7"
+		};
+		case "slack": return {
+			label: "Slack",
+			description: "Slack Block Kit JSON for chat-native output",
+			icon: require_UiComment.UiComment,
+			accept: "application/vnd.slack.block-kit+json, application/json;q=0.8,*/*;q=0.7"
+		};
+	}
+}
+function buildFormatUrl(url, format) {
+	const base = typeof window === "undefined" ? "http://localhost" : window.location.origin;
+	const resolved = new URL(url, base);
+	resolved.searchParams.set("format", format === "clicky" ? "clicky-json" : format);
+	if (isAbsoluteUrl(url)) return resolved.toString();
+	return `${resolved.pathname}${resolved.search}${resolved.hash}`;
+}
+function buildDownloadUrl(url, format, label, scope) {
+	const formatted = buildFormatUrl(url, format);
+	const base = typeof window === "undefined" ? "http://localhost" : window.location.origin;
+	const resolved = new URL(formatted, base);
+	resolved.searchParams.set("filename", downloadFilename(url, format, label));
+	resolved.searchParams.set("_download", Date.now().toString());
+	if (scope) resolved.searchParams.set("scope", scope);
+	if (scope === "all") {
+		resolved.searchParams.delete("limit");
+		resolved.searchParams.delete("offset");
+		resolved.searchParams.delete("page");
+	}
+	if (isAbsoluteUrl(formatted)) return resolved.toString();
+	return `${resolved.pathname}${resolved.search}${resolved.hash}`;
+}
+function downloadFilename(url, format, label) {
+	return `${sanitizeFilenameStem(label || filenameStemFromUrl(url) || "clicky-output")}${downloadExtension(format)}`;
+}
+function filenameStemFromUrl(url) {
+	const base = typeof window === "undefined" ? "http://localhost" : window.location.origin;
+	return new URL(url, base).pathname.split("/").filter(Boolean).at(-1) ?? "";
+}
+function sanitizeFilenameStem(value) {
+	return require_string.stripSurroundingChars(value.trim().replace(/\.[a-z0-9]+$/i, "").replace(/[^a-z0-9._-]+/gi, "-").replace(/-+/g, "-"), "._-") || "clicky-output";
+}
+function downloadExtension(format) {
+	switch (format) {
+		case "clicky": return ".clicky.json";
+		case "json": return ".json";
+		case "ndjson": return ".ndjson";
+		case "pdf": return ".pdf";
+		case "html": return ".html";
+		case "markdown": return ".md";
+		case "yaml": return ".yaml";
+		case "csv": return ".csv";
+		case "pretty": return ".txt";
+		case "excel": return ".xlsx";
+		case "slack": return ".slack.json";
+	}
+}
+var CLICKY_DOWNLOAD_FRAME_ID = "clicky-download-frame";
+function triggerDownload(url) {
+	if (typeof document === "undefined") return;
+	let frame = document.getElementById(CLICKY_DOWNLOAD_FRAME_ID);
+	if (!frame) {
+		frame = document.createElement("iframe");
+		frame.id = CLICKY_DOWNLOAD_FRAME_ID;
+		frame.name = CLICKY_DOWNLOAD_FRAME_ID;
+		frame.title = "Clicky download target";
+		frame.setAttribute("aria-hidden", "true");
+		frame.tabIndex = -1;
+		frame.style.display = "none";
+		document.body.appendChild(frame);
+	}
+	frame.src = url;
+}
+function isAbsoluteUrl(url) {
+	return /^[a-z][a-z\d+\-.]*:/i.test(url) || url.startsWith("//");
+}
+exports.CLICKY_OVERFLOW_VIEW_FORMATS = CLICKY_OVERFLOW_VIEW_FORMATS;
+exports.CLICKY_PRIMARY_VIEW_FORMATS = CLICKY_PRIMARY_VIEW_FORMATS;
+exports.buildFormatUrl = buildFormatUrl;
+exports.exportFormatOptions = exportFormatOptions;
+exports.exportScopeOptions = exportScopeOptions;
+exports.getDownloadFormats = getDownloadFormats;
+exports.getRemoteFormatMeta = getRemoteFormatMeta;
+exports.runClickyDownload = runClickyDownload;
+
+//# sourceMappingURL=clicky-download.cjs.map

package/dist/data/clicky-download.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"clicky-download.cjs","names":["UiEye","UiJson","UiFileText","UiFileCode","UiMarkdown","UiFileSpreadsheet","UiTable","UiComment","stripSurroundingChars"],"sources":["../../src/data/clicky-download.ts"],"sourcesContent":["import type { StaticIconComponent } from \"./Icon\";\nimport {\n  UiComment,\n  UiEye,\n  UiFileCode,\n  UiFileSpreadsheet,\n  UiFileText,\n  UiJson,\n  UiMarkdown,\n  UiTable,\n} from \"../icons\";\nimport type { DataTablePagination } from \"./DataTable\";\nimport type {\n  ClickyExportFormatOption,\n  ClickyExportScopeOption,\n} from \"./clicky-export/ClickyExportDialog\";\nimport { stripSurroundingChars } from \"../lib/string\";\n\n// Remote format and download helpers shared by the Clicky viewer and\n// useClickyTableMenu. Kept out of Clicky.tsx so the hook can be exported without\n// breaking fast refresh (react/only-export-components).\n\nexport const CLICKY_PRIMARY_VIEW_FORMATS = [\"clicky\", \"json\"] as const;\nexport const CLICKY_OVERFLOW_VIEW_FORMATS = [\n  \"pdf\",\n  \"html\",\n  \"markdown\",\n  \"yaml\",\n  \"csv\",\n  \"pretty\",\n  \"excel\",\n  \"slack\",\n] as const;\nconst CLICKY_DOWNLOAD_FORMATS = [\n  \"yaml\",\n  \"json\",\n  \"csv\",\n  \"pdf\",\n  \"markdown\",\n] as const;\n\nexport type ClickyPrimaryViewFormat =\n  (typeof CLICKY_PRIMARY_VIEW_FORMATS)[number];\nexport type ClickyOverflowViewFormat =\n  (typeof CLICKY_OVERFLOW_VIEW_FORMATS)[number];\nexport type ClickyRemoteFormat =\n  | ClickyPrimaryViewFormat\n  | ClickyOverflowViewFormat\n  | \"ndjson\";\n\nexport type ClickyDownloadOptions = {\n  /** Show all advertised download formats in the overflow menu. */\n  all?: boolean;\n  /** Override the download menu label. */\n  label?: string;\n  /** Formats advertised by the endpoint. Defaults to Clicky's legacy set. */\n  formats?: ClickyRemoteFormat[];\n  /** Result ranges advertised by the endpoint. Legacy endpoints omit this. */\n  scopes?: ClickyDownloadScope[];\n  /** Whether all-row export streams or uses a compatibility buffer. */\n  allRowsMode?: \"streaming\" | \"buffered\";\n  /** Per-format server row caps, for example `{ pdf: 1000 }`. */\n  formatMaxRows?: Partial<Record<ClickyRemoteFormat, number>>;\n  /** Prepare an export-specific resource before the native download starts. */\n  prepare?: (request: {\n    format: ClickyRemoteFormat;\n    scope?: ClickyDownloadScope;\n  }) => Promise<{ url: string; label?: string }>;\n};\n\nexport type ClickyDownloadScope = \"page\" | \"all\";\n\nexport function getDownloadFormats({\n  url,\n  download,\n}: {\n  url?: string | undefined;\n  download?: ClickyDownloadOptions | undefined;\n}): ClickyRemoteFormat[] {\n  const enabled = download ? (download.all ?? true) : !!url;\n\n  if (!enabled || !url) {\n    return [];\n  }\n\n  return download?.formats?.length\n    ? [...download.formats]\n    : [...CLICKY_DOWNLOAD_FORMATS];\n}\n\nfunction getDownloadScopes(\n  download?: ClickyDownloadOptions,\n): Array<ClickyDownloadScope | undefined> {\n  return download?.scopes?.length ? download.scopes : [undefined];\n}\n\nfunction downloadDescription(\n  format: ClickyRemoteFormat,\n  scope: ClickyDownloadScope | undefined,\n  download?: ClickyDownloadOptions,\n) {\n  const maxRows = download?.formatMaxRows?.[format];\n  if (maxRows) {\n    return `Limited to ${maxRows.toLocaleString()} rows`;\n  }\n  if (scope === \"all\" && download?.allRowsMode === \"buffered\") {\n    return \"Compatibility mode buffers the complete result\";\n  }\n  if (scope === \"all\" && download?.allRowsMode === \"streaming\") {\n    return \"Streams rows as they are read\";\n  }\n  return undefined;\n}\n\n// exportFormatOptions describes the advertised formats for the export dialog.\n// The dialog is presentational and knows nothing about Clicky's formats, so the\n// labels, icons and blurbs are resolved here, from the same metadata the view\n// switcher reads.\nexport function exportFormatOptions({\n  url,\n  download,\n}: {\n  url?: string | undefined;\n  download?: ClickyDownloadOptions | undefined;\n}): ClickyExportFormatOption[] {\n  if (!url) return [];\n  return getDownloadFormats({ url, download }).map((format) => {\n    const meta = getRemoteFormatMeta(format);\n    return {\n      format,\n      label: meta.label,\n      description: meta.description,\n      icon: meta.icon,\n      ...(meta.iconClassName ? { iconClassName: meta.iconClassName } : {}),\n    };\n  });\n}\n\n// exportScopeOptions describes the ranges the endpoint serves. The per-format\n// note is a function rather than a string because a ceiling belongs to a format\n// and a range together: a PDF stops at 1,000 rows, the CSV beside it does not.\n//\n// The all-rows label carries the count the table was told, because \"all\" is the\n// one number a person needs before starting an export and the only one the page\n// in front of them does not show.\nexport function exportScopeOptions(\n  download?: ClickyDownloadOptions,\n  pagination?: DataTablePagination,\n): ClickyExportScopeOption[] {\n  return getDownloadScopes(download).map((scope) => ({\n    scope,\n    label:\n      scope === \"all\" || scope === undefined\n        ? allRowsLabel(pagination)\n        : \"Current page\",\n    note: (format: string) =>\n      downloadDescription(format as ClickyRemoteFormat, scope, download),\n  }));\n}\n\n// allRowsLabel states the total when the backend gave one. A \"gte\" total is a\n// lower bound a backend stopped counting at, so it is rendered as one rather\n// than as a count nobody promised.\nfunction allRowsLabel(pagination?: DataTablePagination): string {\n  const total = pagination?.total;\n  if (total === undefined) return \"All rows\";\n  const count = total.toLocaleString();\n  return pagination?.totalRelation === \"gte\"\n    ? `All ${count}+ rows`\n    : `All ${count} rows`;\n}\n\n// runClickyDownload is prepareDownload for a caller that awaits it. The export\n// dialog reports its own failure and stays open on one, so the reason has to\n// come back as a rejection rather than through a callback.\nexport async function runClickyDownload({\n  url,\n  format,\n  scope,\n  download,\n}: {\n  url: string;\n  format: ClickyRemoteFormat;\n  scope?: ClickyDownloadScope | undefined;\n  download?: ClickyDownloadOptions | undefined;\n}): Promise<void> {\n  let failure = \"\";\n  await prepareDownload({\n    url,\n    format,\n    ...(scope ? { scope } : {}),\n    ...(download ? { download } : {}),\n    onError: (message) => {\n      failure = message;\n    },\n  });\n  if (failure) throw new Error(failure);\n}\n\nasync function prepareDownload({\n  url,\n  format,\n  scope,\n  download,\n  onPending,\n  onError,\n}: {\n  url: string;\n  format: ClickyRemoteFormat;\n  scope?: ClickyDownloadScope | undefined;\n  download?: ClickyDownloadOptions | undefined;\n  onPending?: ((pending: boolean) => void) | undefined;\n  onError?: ((message: string) => void) | undefined;\n}) {\n  onError?.(\"\");\n  onPending?.(true);\n  try {\n    const prepared = download?.prepare\n      ? await download.prepare({ format, ...(scope ? { scope } : {}) })\n      : { url, ...(download?.label ? { label: download.label } : {}) };\n    if (!prepared.url.trim()) {\n      throw new Error(\"The prepared download URL is empty\");\n    }\n    triggerDownload(\n      buildDownloadUrl(\n        prepared.url,\n        format,\n        prepared.label ?? download?.label,\n        scope,\n      ),\n    );\n  } catch (error) {\n    onError?.(\n      error instanceof Error ? error.message : \"Preparing the download failed\",\n    );\n  } finally {\n    onPending?.(false);\n  }\n}\n\nexport function getRemoteFormatMeta(format: ClickyRemoteFormat): {\n  label: string;\n  description: string;\n  icon: StaticIconComponent;\n  iconClassName?: string;\n  accept: string;\n} {\n  switch (format) {\n    case \"clicky\":\n      return {\n        label: \"Clicky\",\n        description: \"Rendered Clicky JSON with the rich Clicky viewer\",\n        icon: UiEye,\n        accept:\n          \"application/json+clicky, application/clicky+json;q=0.9, application/json;q=0.8,*/*;q=0.7\",\n      };\n    case \"json\":\n      return {\n        label: \"JSON\",\n        description: \"Plain JSON for inspecting the raw response body\",\n        icon: UiJson,\n        accept: \"application/json, text/plain;q=0.8,*/*;q=0.7\",\n      };\n    case \"ndjson\":\n      return {\n        label: \"NDJSON\",\n        description: \"Newline-delimited JSON for streaming data pipelines\",\n        icon: UiJson,\n        accept: \"application/x-ndjson, application/ndjson;q=0.9,*/*;q=0.7\",\n      };\n    case \"pdf\":\n      return {\n        label: \"PDF\",\n        description: \"Portable document for sharing and printing\",\n        icon: UiFileText,\n        iconClassName: \"text-rose-600 dark:text-rose-400\",\n        accept: \"application/pdf, */*;q=0.7\",\n      };\n    case \"html\":\n      return {\n        label: \"HTML\",\n        description: \"Browser-ready HTML preview of the formatted output\",\n        icon: UiFileCode,\n        accept: \"text/html, */*;q=0.7\",\n      };\n    case \"markdown\":\n      return {\n        label: \"Markdown\",\n        description: \"Markdown formatted for docs, comments, and chat\",\n        icon: UiMarkdown,\n        accept: \"text/markdown, text/plain;q=0.8,*/*;q=0.7\",\n      };\n    case \"yaml\":\n      return {\n        label: \"YAML\",\n        description: \"YAML for config-friendly inspection and export\",\n        icon: UiFileCode,\n        iconClassName: \"text-violet-600 dark:text-violet-400\",\n        accept: \"application/yaml, text/yaml;q=0.9, text/plain;q=0.8,*/*;q=0.7\",\n      };\n    case \"csv\":\n      return {\n        label: \"CSV\",\n        description: \"Comma-separated values for spreadsheets and imports\",\n        icon: UiFileSpreadsheet,\n        iconClassName: \"text-emerald-600 dark:text-emerald-400\",\n        accept: \"text/csv, text/plain;q=0.8,*/*;q=0.7\",\n      };\n    case \"pretty\":\n      return {\n        label: \"Pretty\",\n        description: \"Human-readable plain text output from the formatter\",\n        icon: UiFileCode,\n        accept: \"text/plain, */*;q=0.7\",\n      };\n    case \"excel\":\n      return {\n        label: \"Excel\",\n        description: \"Spreadsheet workbook for offline analysis\",\n        icon: UiTable,\n        accept:\n          \"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, */*;q=0.7\",\n      };\n    case \"slack\":\n      return {\n        label: \"Slack\",\n        description: \"Slack Block Kit JSON for chat-native output\",\n        icon: UiComment,\n        accept:\n          \"application/vnd.slack.block-kit+json, application/json;q=0.8,*/*;q=0.7\",\n      };\n  }\n}\n\nexport function buildFormatUrl(url: string, format: ClickyRemoteFormat) {\n  const base =\n    typeof window === \"undefined\" ? \"http://localhost\" : window.location.origin;\n  const resolved = new URL(url, base);\n  resolved.searchParams.set(\n    \"format\",\n    format === \"clicky\" ? \"clicky-json\" : format,\n  );\n\n  if (isAbsoluteUrl(url)) {\n    return resolved.toString();\n  }\n\n  return `${resolved.pathname}${resolved.search}${resolved.hash}`;\n}\n\nfunction buildDownloadUrl(\n  url: string,\n  format: ClickyRemoteFormat,\n  label?: string | undefined,\n  scope?: ClickyDownloadScope | undefined,\n) {\n  const formatted = buildFormatUrl(url, format);\n  const base =\n    typeof window === \"undefined\" ? \"http://localhost\" : window.location.origin;\n  const resolved = new URL(formatted, base);\n  resolved.searchParams.set(\"filename\", downloadFilename(url, format, label));\n  resolved.searchParams.set(\"_download\", Date.now().toString());\n  if (scope) {\n    resolved.searchParams.set(\"scope\", scope);\n  }\n  if (scope === \"all\") {\n    resolved.searchParams.delete(\"limit\");\n    resolved.searchParams.delete(\"offset\");\n    resolved.searchParams.delete(\"page\");\n  }\n\n  if (isAbsoluteUrl(formatted)) {\n    return resolved.toString();\n  }\n\n  return `${resolved.pathname}${resolved.search}${resolved.hash}`;\n}\n\nfunction downloadFilename(\n  url: string,\n  format: ClickyRemoteFormat,\n  label?: string | undefined,\n) {\n  const stem = sanitizeFilenameStem(\n    label || filenameStemFromUrl(url) || \"clicky-output\",\n  );\n  return `${stem}${downloadExtension(format)}`;\n}\n\nfunction filenameStemFromUrl(url: string) {\n  const base =\n    typeof window === \"undefined\" ? \"http://localhost\" : window.location.origin;\n  const resolved = new URL(url, base);\n  const segment = resolved.pathname.split(\"/\").filter(Boolean).at(-1);\n  return segment ?? \"\";\n}\n\nfunction sanitizeFilenameStem(value: string) {\n  const cleaned = stripSurroundingChars(\n    value\n      .trim()\n      .replace(/\\.[a-z0-9]+$/i, \"\")\n      .replace(/[^a-z0-9._-]+/gi, \"-\")\n      .replace(/-+/g, \"-\"),\n    \"._-\",\n  );\n\n  return cleaned || \"clicky-output\";\n}\n\nfunction downloadExtension(format: ClickyRemoteFormat) {\n  switch (format) {\n    case \"clicky\":\n      return \".clicky.json\";\n    case \"json\":\n      return \".json\";\n    case \"ndjson\":\n      return \".ndjson\";\n    case \"pdf\":\n      return \".pdf\";\n    case \"html\":\n      return \".html\";\n    case \"markdown\":\n      return \".md\";\n    case \"yaml\":\n      return \".yaml\";\n    case \"csv\":\n      return \".csv\";\n    case \"pretty\":\n      return \".txt\";\n    case \"excel\":\n      return \".xlsx\";\n    case \"slack\":\n      return \".slack.json\";\n  }\n}\n\nconst CLICKY_DOWNLOAD_FRAME_ID = \"clicky-download-frame\";\n\nfunction triggerDownload(url: string) {\n  if (typeof document === \"undefined\") return;\n\n  let frame = document.getElementById(\n    CLICKY_DOWNLOAD_FRAME_ID,\n  ) as HTMLIFrameElement | null;\n  if (!frame) {\n    frame = document.createElement(\"iframe\");\n    frame.id = CLICKY_DOWNLOAD_FRAME_ID;\n    frame.name = CLICKY_DOWNLOAD_FRAME_ID;\n    frame.title = \"Clicky download target\";\n    frame.setAttribute(\"aria-hidden\", \"true\");\n    frame.tabIndex = -1;\n    frame.style.display = \"none\";\n    document.body.appendChild(frame);\n  }\n\n  frame.src = url;\n}\n\nfunction isAbsoluteUrl(url: string) {\n  return /^[a-z][a-z\\d+\\-.]*:/i.test(url) || url.startsWith(\"//\");\n}\n"],"mappings":"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"}

package/dist/data/clicky-download.d.ts

@@ -0,0 +1,55 @@
+import { StaticIconComponent } from './Icon.js';
+import { DataTablePagination } from './DataTable.js';
+import { ClickyExportFormatOption, ClickyExportScopeOption } from './clicky-export/ClickyExportDialog.js';
+export declare const CLICKY_PRIMARY_VIEW_FORMATS: readonly ["clicky", "json"];
+export declare const CLICKY_OVERFLOW_VIEW_FORMATS: readonly ["pdf", "html", "markdown", "yaml", "csv", "pretty", "excel", "slack"];
+export type ClickyPrimaryViewFormat = (typeof CLICKY_PRIMARY_VIEW_FORMATS)[number];
+export type ClickyOverflowViewFormat = (typeof CLICKY_OVERFLOW_VIEW_FORMATS)[number];
+export type ClickyRemoteFormat = ClickyPrimaryViewFormat | ClickyOverflowViewFormat | "ndjson";
+export type ClickyDownloadOptions = {
+    /** Show all advertised download formats in the overflow menu. */
+    all?: boolean;
+    /** Override the download menu label. */
+    label?: string;
+    /** Formats advertised by the endpoint. Defaults to Clicky's legacy set. */
+    formats?: ClickyRemoteFormat[];
+    /** Result ranges advertised by the endpoint. Legacy endpoints omit this. */
+    scopes?: ClickyDownloadScope[];
+    /** Whether all-row export streams or uses a compatibility buffer. */
+    allRowsMode?: "streaming" | "buffered";
+    /** Per-format server row caps, for example `{ pdf: 1000 }`. */
+    formatMaxRows?: Partial<Record<ClickyRemoteFormat, number>>;
+    /** Prepare an export-specific resource before the native download starts. */
+    prepare?: (request: {
+        format: ClickyRemoteFormat;
+        scope?: ClickyDownloadScope;
+    }) => Promise<{
+        url: string;
+        label?: string;
+    }>;
+};
+export type ClickyDownloadScope = "page" | "all";
+export declare function getDownloadFormats({ url, download, }: {
+    url?: string | undefined;
+    download?: ClickyDownloadOptions | undefined;
+}): ClickyRemoteFormat[];
+export declare function exportFormatOptions({ url, download, }: {
+    url?: string | undefined;
+    download?: ClickyDownloadOptions | undefined;
+}): ClickyExportFormatOption[];
+export declare function exportScopeOptions(download?: ClickyDownloadOptions, pagination?: DataTablePagination): ClickyExportScopeOption[];
+export declare function runClickyDownload({ url, format, scope, download, }: {
+    url: string;
+    format: ClickyRemoteFormat;
+    scope?: ClickyDownloadScope | undefined;
+    download?: ClickyDownloadOptions | undefined;
+}): Promise<void>;
+export declare function getRemoteFormatMeta(format: ClickyRemoteFormat): {
+    label: string;
+    description: string;
+    icon: StaticIconComponent;
+    iconClassName?: string;
+    accept: string;
+};
+export declare function buildFormatUrl(url: string, format: ClickyRemoteFormat): string;
+//# sourceMappingURL=clicky-download.d.ts.map

package/dist/data/clicky-download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clicky-download.d.ts","sourceRoot":"","sources":["../../src/data/clicky-download.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAWlD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,oCAAoC,CAAC;AAO5C,eAAO,MAAM,2BAA2B,6BAA8B,CAAC;AACvE,eAAO,MAAM,4BAA4B,iFAS/B,CAAC;AASX,MAAM,MAAM,uBAAuB,GACjC,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAC/C,MAAM,MAAM,wBAAwB,GAClC,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,CAAC,CAAC;AAChD,MAAM,MAAM,kBAAkB,GAC1B,uBAAuB,GACvB,wBAAwB,GACxB,QAAQ,CAAC;AAEb,MAAM,MAAM,qBAAqB,GAAG;IAClC,iEAAiE;IACjE,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC/B,4EAA4E;IAC5E,MAAM,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,WAAW,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC;IACvC,+DAA+D;IAC/D,aAAa,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5D,6EAA6E;IAC7E,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE;QAClB,MAAM,EAAE,kBAAkB,CAAC;QAC3B,KAAK,CAAC,EAAE,mBAAmB,CAAC;KAC7B,KAAK,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,KAAK,CAAC;AAEjD,wBAAgB,kBAAkB,CAAC,EACjC,GAAG,EACH,QAAQ,GACT,EAAE;IACD,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,QAAQ,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;CAC9C,GAAG,kBAAkB,EAAE,CAUvB;AA8BD,wBAAgB,mBAAmB,CAAC,EAClC,GAAG,EACH,QAAQ,GACT,EAAE;IACD,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,QAAQ,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;CAC9C,GAAG,wBAAwB,EAAE,CAY7B;AASD,wBAAgB,kBAAkB,CAChC,QAAQ,CAAC,EAAE,qBAAqB,EAChC,UAAU,CAAC,EAAE,mBAAmB,GAC/B,uBAAuB,EAAE,CAU3B;AAiBD,wBAAsB,iBAAiB,CAAC,EACtC,GAAG,EACH,MAAM,EACN,KAAK,EACL,QAAQ,GACT,EAAE;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,kBAAkB,CAAC;IAC3B,KAAK,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;CAC9C,GAAG,OAAO,CAAC,IAAI,CAAC,CAYhB;AA2CD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,GAAG;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB,CAsFA;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,UAcrE"}

package/dist/data/clicky-download.js

@@ -0,0 +1,244 @@
+import { UiEye } from "../icons/components/UiEye.js";
+import { UiTable } from "../icons/components/UiTable.js";
+import { UiComment } from "../icons/components/UiComment.js";
+import { UiFileCode } from "../icons/components/UiFileCode.js";
+import { UiJson } from "../icons/components/UiJson.js";
+import { UiMarkdown } from "../icons/components/UiMarkdown.js";
+import { UiFileText } from "../icons/components/UiFileText.js";
+import { UiFileSpreadsheet } from "../icons/components/UiFileSpreadsheet.js";
+import { stripSurroundingChars } from "../lib/string.js";
+// src/data/clicky-download.ts
+var CLICKY_PRIMARY_VIEW_FORMATS = ["clicky", "json"];
+var CLICKY_OVERFLOW_VIEW_FORMATS = [
+	"pdf",
+	"html",
+	"markdown",
+	"yaml",
+	"csv",
+	"pretty",
+	"excel",
+	"slack"
+];
+var CLICKY_DOWNLOAD_FORMATS = [
+	"yaml",
+	"json",
+	"csv",
+	"pdf",
+	"markdown"
+];
+function getDownloadFormats({ url, download }) {
+	if (!(download ? download.all ?? true : !!url) || !url) return [];
+	return download?.formats?.length ? [...download.formats] : [...CLICKY_DOWNLOAD_FORMATS];
+}
+function getDownloadScopes(download) {
+	return download?.scopes?.length ? download.scopes : [void 0];
+}
+function downloadDescription(format, scope, download) {
+	const maxRows = download?.formatMaxRows?.[format];
+	if (maxRows) return `Limited to ${maxRows.toLocaleString()} rows`;
+	if (scope === "all" && download?.allRowsMode === "buffered") return "Compatibility mode buffers the complete result";
+	if (scope === "all" && download?.allRowsMode === "streaming") return "Streams rows as they are read";
+}
+function exportFormatOptions({ url, download }) {
+	if (!url) return [];
+	return getDownloadFormats({
+		url,
+		download
+	}).map((format) => {
+		const meta = getRemoteFormatMeta(format);
+		return {
+			format,
+			label: meta.label,
+			description: meta.description,
+			icon: meta.icon,
+			...meta.iconClassName ? { iconClassName: meta.iconClassName } : {}
+		};
+	});
+}
+function exportScopeOptions(download, pagination) {
+	return getDownloadScopes(download).map((scope) => ({
+		scope,
+		label: scope === "all" || scope === void 0 ? allRowsLabel(pagination) : "Current page",
+		note: (format) => downloadDescription(format, scope, download)
+	}));
+}
+function allRowsLabel(pagination) {
+	const total = pagination?.total;
+	if (total === void 0) return "All rows";
+	const count = total.toLocaleString();
+	return pagination?.totalRelation === "gte" ? `All ${count}+ rows` : `All ${count} rows`;
+}
+async function runClickyDownload({ url, format, scope, download }) {
+	let failure = "";
+	await prepareDownload({
+		url,
+		format,
+		...scope ? { scope } : {},
+		...download ? { download } : {},
+		onError: (message) => {
+			failure = message;
+		}
+	});
+	if (failure) throw new Error(failure);
+}
+async function prepareDownload({ url, format, scope, download, onPending, onError }) {
+	onError?.("");
+	onPending?.(true);
+	try {
+		const prepared = download?.prepare ? await download.prepare({
+			format,
+			...scope ? { scope } : {}
+		}) : {
+			url,
+			...download?.label ? { label: download.label } : {}
+		};
+		if (!prepared.url.trim()) throw new Error("The prepared download URL is empty");
+		triggerDownload(buildDownloadUrl(prepared.url, format, prepared.label ?? download?.label, scope));
+	} catch (error) {
+		onError?.(error instanceof Error ? error.message : "Preparing the download failed");
+	} finally {
+		onPending?.(false);
+	}
+}
+function getRemoteFormatMeta(format) {
+	switch (format) {
+		case "clicky": return {
+			label: "Clicky",
+			description: "Rendered Clicky JSON with the rich Clicky viewer",
+			icon: UiEye,
+			accept: "application/json+clicky, application/clicky+json;q=0.9, application/json;q=0.8,*/*;q=0.7"
+		};
+		case "json": return {
+			label: "JSON",
+			description: "Plain JSON for inspecting the raw response body",
+			icon: UiJson,
+			accept: "application/json, text/plain;q=0.8,*/*;q=0.7"
+		};
+		case "ndjson": return {
+			label: "NDJSON",
+			description: "Newline-delimited JSON for streaming data pipelines",
+			icon: UiJson,
+			accept: "application/x-ndjson, application/ndjson;q=0.9,*/*;q=0.7"
+		};
+		case "pdf": return {
+			label: "PDF",
+			description: "Portable document for sharing and printing",
+			icon: UiFileText,
+			iconClassName: "text-rose-600 dark:text-rose-400",
+			accept: "application/pdf, */*;q=0.7"
+		};
+		case "html": return {
+			label: "HTML",
+			description: "Browser-ready HTML preview of the formatted output",
+			icon: UiFileCode,
+			accept: "text/html, */*;q=0.7"
+		};
+		case "markdown": return {
+			label: "Markdown",
+			description: "Markdown formatted for docs, comments, and chat",
+			icon: UiMarkdown,
+			accept: "text/markdown, text/plain;q=0.8,*/*;q=0.7"
+		};
+		case "yaml": return {
+			label: "YAML",
+			description: "YAML for config-friendly inspection and export",
+			icon: UiFileCode,
+			iconClassName: "text-violet-600 dark:text-violet-400",
+			accept: "application/yaml, text/yaml;q=0.9, text/plain;q=0.8,*/*;q=0.7"
+		};
+		case "csv": return {
+			label: "CSV",
+			description: "Comma-separated values for spreadsheets and imports",
+			icon: UiFileSpreadsheet,
+			iconClassName: "text-emerald-600 dark:text-emerald-400",
+			accept: "text/csv, text/plain;q=0.8,*/*;q=0.7"
+		};
+		case "pretty": return {
+			label: "Pretty",
+			description: "Human-readable plain text output from the formatter",
+			icon: UiFileCode,
+			accept: "text/plain, */*;q=0.7"
+		};
+		case "excel": return {
+			label: "Excel",
+			description: "Spreadsheet workbook for offline analysis",
+			icon: UiTable,
+			accept: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, */*;q=0.7"
+		};
+		case "slack": return {
+			label: "Slack",
+			description: "Slack Block Kit JSON for chat-native output",
+			icon: UiComment,
+			accept: "application/vnd.slack.block-kit+json, application/json;q=0.8,*/*;q=0.7"
+		};
+	}
+}
+function buildFormatUrl(url, format) {
+	const base = typeof window === "undefined" ? "http://localhost" : window.location.origin;
+	const resolved = new URL(url, base);
+	resolved.searchParams.set("format", format === "clicky" ? "clicky-json" : format);
+	if (isAbsoluteUrl(url)) return resolved.toString();
+	return `${resolved.pathname}${resolved.search}${resolved.hash}`;
+}
+function buildDownloadUrl(url, format, label, scope) {
+	const formatted = buildFormatUrl(url, format);
+	const base = typeof window === "undefined" ? "http://localhost" : window.location.origin;
+	const resolved = new URL(formatted, base);
+	resolved.searchParams.set("filename", downloadFilename(url, format, label));
+	resolved.searchParams.set("_download", Date.now().toString());
+	if (scope) resolved.searchParams.set("scope", scope);
+	if (scope === "all") {
+		resolved.searchParams.delete("limit");
+		resolved.searchParams.delete("offset");
+		resolved.searchParams.delete("page");
+	}
+	if (isAbsoluteUrl(formatted)) return resolved.toString();
+	return `${resolved.pathname}${resolved.search}${resolved.hash}`;
+}
+function downloadFilename(url, format, label) {
+	return `${sanitizeFilenameStem(label || filenameStemFromUrl(url) || "clicky-output")}${downloadExtension(format)}`;
+}
+function filenameStemFromUrl(url) {
+	const base = typeof window === "undefined" ? "http://localhost" : window.location.origin;
+	return new URL(url, base).pathname.split("/").filter(Boolean).at(-1) ?? "";
+}
+function sanitizeFilenameStem(value) {
+	return stripSurroundingChars(value.trim().replace(/\.[a-z0-9]+$/i, "").replace(/[^a-z0-9._-]+/gi, "-").replace(/-+/g, "-"), "._-") || "clicky-output";
+}
+function downloadExtension(format) {
+	switch (format) {
+		case "clicky": return ".clicky.json";
+		case "json": return ".json";
+		case "ndjson": return ".ndjson";
+		case "pdf": return ".pdf";
+		case "html": return ".html";
+		case "markdown": return ".md";
+		case "yaml": return ".yaml";
+		case "csv": return ".csv";
+		case "pretty": return ".txt";
+		case "excel": return ".xlsx";
+		case "slack": return ".slack.json";
+	}
+}
+var CLICKY_DOWNLOAD_FRAME_ID = "clicky-download-frame";
+function triggerDownload(url) {
+	if (typeof document === "undefined") return;
+	let frame = document.getElementById(CLICKY_DOWNLOAD_FRAME_ID);
+	if (!frame) {
+		frame = document.createElement("iframe");
+		frame.id = CLICKY_DOWNLOAD_FRAME_ID;
+		frame.name = CLICKY_DOWNLOAD_FRAME_ID;
+		frame.title = "Clicky download target";
+		frame.setAttribute("aria-hidden", "true");
+		frame.tabIndex = -1;
+		frame.style.display = "none";
+		document.body.appendChild(frame);
+	}
+	frame.src = url;
+}
+function isAbsoluteUrl(url) {
+	return /^[a-z][a-z\d+\-.]*:/i.test(url) || url.startsWith("//");
+}
+export { CLICKY_OVERFLOW_VIEW_FORMATS, CLICKY_PRIMARY_VIEW_FORMATS, buildFormatUrl, exportFormatOptions, exportScopeOptions, getDownloadFormats, getRemoteFormatMeta, runClickyDownload };
+
+//# sourceMappingURL=clicky-download.js.map

package/dist/data/clicky-download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clicky-download.js","names":[],"sources":["../../src/data/clicky-download.ts"],"sourcesContent":["import type { StaticIconComponent } from \"./Icon\";\nimport {\n  UiComment,\n  UiEye,\n  UiFileCode,\n  UiFileSpreadsheet,\n  UiFileText,\n  UiJson,\n  UiMarkdown,\n  UiTable,\n} from \"../icons\";\nimport type { DataTablePagination } from \"./DataTable\";\nimport type {\n  ClickyExportFormatOption,\n  ClickyExportScopeOption,\n} from \"./clicky-export/ClickyExportDialog\";\nimport { stripSurroundingChars } from \"../lib/string\";\n\n// Remote format and download helpers shared by the Clicky viewer and\n// useClickyTableMenu. Kept out of Clicky.tsx so the hook can be exported without\n// breaking fast refresh (react/only-export-components).\n\nexport const CLICKY_PRIMARY_VIEW_FORMATS = [\"clicky\", \"json\"] as const;\nexport const CLICKY_OVERFLOW_VIEW_FORMATS = [\n  \"pdf\",\n  \"html\",\n  \"markdown\",\n  \"yaml\",\n  \"csv\",\n  \"pretty\",\n  \"excel\",\n  \"slack\",\n] as const;\nconst CLICKY_DOWNLOAD_FORMATS = [\n  \"yaml\",\n  \"json\",\n  \"csv\",\n  \"pdf\",\n  \"markdown\",\n] as const;\n\nexport type ClickyPrimaryViewFormat =\n  (typeof CLICKY_PRIMARY_VIEW_FORMATS)[number];\nexport type ClickyOverflowViewFormat =\n  (typeof CLICKY_OVERFLOW_VIEW_FORMATS)[number];\nexport type ClickyRemoteFormat =\n  | ClickyPrimaryViewFormat\n  | ClickyOverflowViewFormat\n  | \"ndjson\";\n\nexport type ClickyDownloadOptions = {\n  /** Show all advertised download formats in the overflow menu. */\n  all?: boolean;\n  /** Override the download menu label. */\n  label?: string;\n  /** Formats advertised by the endpoint. Defaults to Clicky's legacy set. */\n  formats?: ClickyRemoteFormat[];\n  /** Result ranges advertised by the endpoint. Legacy endpoints omit this. */\n  scopes?: ClickyDownloadScope[];\n  /** Whether all-row export streams or uses a compatibility buffer. */\n  allRowsMode?: \"streaming\" | \"buffered\";\n  /** Per-format server row caps, for example `{ pdf: 1000 }`. */\n  formatMaxRows?: Partial<Record<ClickyRemoteFormat, number>>;\n  /** Prepare an export-specific resource before the native download starts. */\n  prepare?: (request: {\n    format: ClickyRemoteFormat;\n    scope?: ClickyDownloadScope;\n  }) => Promise<{ url: string; label?: string }>;\n};\n\nexport type ClickyDownloadScope = \"page\" | \"all\";\n\nexport function getDownloadFormats({\n  url,\n  download,\n}: {\n  url?: string | undefined;\n  download?: ClickyDownloadOptions | undefined;\n}): ClickyRemoteFormat[] {\n  const enabled = download ? (download.all ?? true) : !!url;\n\n  if (!enabled || !url) {\n    return [];\n  }\n\n  return download?.formats?.length\n    ? [...download.formats]\n    : [...CLICKY_DOWNLOAD_FORMATS];\n}\n\nfunction getDownloadScopes(\n  download?: ClickyDownloadOptions,\n): Array<ClickyDownloadScope | undefined> {\n  return download?.scopes?.length ? download.scopes : [undefined];\n}\n\nfunction downloadDescription(\n  format: ClickyRemoteFormat,\n  scope: ClickyDownloadScope | undefined,\n  download?: ClickyDownloadOptions,\n) {\n  const maxRows = download?.formatMaxRows?.[format];\n  if (maxRows) {\n    return `Limited to ${maxRows.toLocaleString()} rows`;\n  }\n  if (scope === \"all\" && download?.allRowsMode === \"buffered\") {\n    return \"Compatibility mode buffers the complete result\";\n  }\n  if (scope === \"all\" && download?.allRowsMode === \"streaming\") {\n    return \"Streams rows as they are read\";\n  }\n  return undefined;\n}\n\n// exportFormatOptions describes the advertised formats for the export dialog.\n// The dialog is presentational and knows nothing about Clicky's formats, so the\n// labels, icons and blurbs are resolved here, from the same metadata the view\n// switcher reads.\nexport function exportFormatOptions({\n  url,\n  download,\n}: {\n  url?: string | undefined;\n  download?: ClickyDownloadOptions | undefined;\n}): ClickyExportFormatOption[] {\n  if (!url) return [];\n  return getDownloadFormats({ url, download }).map((format) => {\n    const meta = getRemoteFormatMeta(format);\n    return {\n      format,\n      label: meta.label,\n      description: meta.description,\n      icon: meta.icon,\n      ...(meta.iconClassName ? { iconClassName: meta.iconClassName } : {}),\n    };\n  });\n}\n\n// exportScopeOptions describes the ranges the endpoint serves. The per-format\n// note is a function rather than a string because a ceiling belongs to a format\n// and a range together: a PDF stops at 1,000 rows, the CSV beside it does not.\n//\n// The all-rows label carries the count the table was told, because \"all\" is the\n// one number a person needs before starting an export and the only one the page\n// in front of them does not show.\nexport function exportScopeOptions(\n  download?: ClickyDownloadOptions,\n  pagination?: DataTablePagination,\n): ClickyExportScopeOption[] {\n  return getDownloadScopes(download).map((scope) => ({\n    scope,\n    label:\n      scope === \"all\" || scope === undefined\n        ? allRowsLabel(pagination)\n        : \"Current page\",\n    note: (format: string) =>\n      downloadDescription(format as ClickyRemoteFormat, scope, download),\n  }));\n}\n\n// allRowsLabel states the total when the backend gave one. A \"gte\" total is a\n// lower bound a backend stopped counting at, so it is rendered as one rather\n// than as a count nobody promised.\nfunction allRowsLabel(pagination?: DataTablePagination): string {\n  const total = pagination?.total;\n  if (total === undefined) return \"All rows\";\n  const count = total.toLocaleString();\n  return pagination?.totalRelation === \"gte\"\n    ? `All ${count}+ rows`\n    : `All ${count} rows`;\n}\n\n// runClickyDownload is prepareDownload for a caller that awaits it. The export\n// dialog reports its own failure and stays open on one, so the reason has to\n// come back as a rejection rather than through a callback.\nexport async function runClickyDownload({\n  url,\n  format,\n  scope,\n  download,\n}: {\n  url: string;\n  format: ClickyRemoteFormat;\n  scope?: ClickyDownloadScope | undefined;\n  download?: ClickyDownloadOptions | undefined;\n}): Promise<void> {\n  let failure = \"\";\n  await prepareDownload({\n    url,\n    format,\n    ...(scope ? { scope } : {}),\n    ...(download ? { download } : {}),\n    onError: (message) => {\n      failure = message;\n    },\n  });\n  if (failure) throw new Error(failure);\n}\n\nasync function prepareDownload({\n  url,\n  format,\n  scope,\n  download,\n  onPending,\n  onError,\n}: {\n  url: string;\n  format: ClickyRemoteFormat;\n  scope?: ClickyDownloadScope | undefined;\n  download?: ClickyDownloadOptions | undefined;\n  onPending?: ((pending: boolean) => void) | undefined;\n  onError?: ((message: string) => void) | undefined;\n}) {\n  onError?.(\"\");\n  onPending?.(true);\n  try {\n    const prepared = download?.prepare\n      ? await download.prepare({ format, ...(scope ? { scope } : {}) })\n      : { url, ...(download?.label ? { label: download.label } : {}) };\n    if (!prepared.url.trim()) {\n      throw new Error(\"The prepared download URL is empty\");\n    }\n    triggerDownload(\n      buildDownloadUrl(\n        prepared.url,\n        format,\n        prepared.label ?? download?.label,\n        scope,\n      ),\n    );\n  } catch (error) {\n    onError?.(\n      error instanceof Error ? error.message : \"Preparing the download failed\",\n    );\n  } finally {\n    onPending?.(false);\n  }\n}\n\nexport function getRemoteFormatMeta(format: ClickyRemoteFormat): {\n  label: string;\n  description: string;\n  icon: StaticIconComponent;\n  iconClassName?: string;\n  accept: string;\n} {\n  switch (format) {\n    case \"clicky\":\n      return {\n        label: \"Clicky\",\n        description: \"Rendered Clicky JSON with the rich Clicky viewer\",\n        icon: UiEye,\n        accept:\n          \"application/json+clicky, application/clicky+json;q=0.9, application/json;q=0.8,*/*;q=0.7\",\n      };\n    case \"json\":\n      return {\n        label: \"JSON\",\n        description: \"Plain JSON for inspecting the raw response body\",\n        icon: UiJson,\n        accept: \"application/json, text/plain;q=0.8,*/*;q=0.7\",\n      };\n    case \"ndjson\":\n      return {\n        label: \"NDJSON\",\n        description: \"Newline-delimited JSON for streaming data pipelines\",\n        icon: UiJson,\n        accept: \"application/x-ndjson, application/ndjson;q=0.9,*/*;q=0.7\",\n      };\n    case \"pdf\":\n      return {\n        label: \"PDF\",\n        description: \"Portable document for sharing and printing\",\n        icon: UiFileText,\n        iconClassName: \"text-rose-600 dark:text-rose-400\",\n        accept: \"application/pdf, */*;q=0.7\",\n      };\n    case \"html\":\n      return {\n        label: \"HTML\",\n        description: \"Browser-ready HTML preview of the formatted output\",\n        icon: UiFileCode,\n        accept: \"text/html, */*;q=0.7\",\n      };\n    case \"markdown\":\n      return {\n        label: \"Markdown\",\n        description: \"Markdown formatted for docs, comments, and chat\",\n        icon: UiMarkdown,\n        accept: \"text/markdown, text/plain;q=0.8,*/*;q=0.7\",\n      };\n    case \"yaml\":\n      return {\n        label: \"YAML\",\n        description: \"YAML for config-friendly inspection and export\",\n        icon: UiFileCode,\n        iconClassName: \"text-violet-600 dark:text-violet-400\",\n        accept: \"application/yaml, text/yaml;q=0.9, text/plain;q=0.8,*/*;q=0.7\",\n      };\n    case \"csv\":\n      return {\n        label: \"CSV\",\n        description: \"Comma-separated values for spreadsheets and imports\",\n        icon: UiFileSpreadsheet,\n        iconClassName: \"text-emerald-600 dark:text-emerald-400\",\n        accept: \"text/csv, text/plain;q=0.8,*/*;q=0.7\",\n      };\n    case \"pretty\":\n      return {\n        label: \"Pretty\",\n        description: \"Human-readable plain text output from the formatter\",\n        icon: UiFileCode,\n        accept: \"text/plain, */*;q=0.7\",\n      };\n    case \"excel\":\n      return {\n        label: \"Excel\",\n        description: \"Spreadsheet workbook for offline analysis\",\n        icon: UiTable,\n        accept:\n          \"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, */*;q=0.7\",\n      };\n    case \"slack\":\n      return {\n        label: \"Slack\",\n        description: \"Slack Block Kit JSON for chat-native output\",\n        icon: UiComment,\n        accept:\n          \"application/vnd.slack.block-kit+json, application/json;q=0.8,*/*;q=0.7\",\n      };\n  }\n}\n\nexport function buildFormatUrl(url: string, format: ClickyRemoteFormat) {\n  const base =\n    typeof window === \"undefined\" ? \"http://localhost\" : window.location.origin;\n  const resolved = new URL(url, base);\n  resolved.searchParams.set(\n    \"format\",\n    format === \"clicky\" ? \"clicky-json\" : format,\n  );\n\n  if (isAbsoluteUrl(url)) {\n    return resolved.toString();\n  }\n\n  return `${resolved.pathname}${resolved.search}${resolved.hash}`;\n}\n\nfunction buildDownloadUrl(\n  url: string,\n  format: ClickyRemoteFormat,\n  label?: string | undefined,\n  scope?: ClickyDownloadScope | undefined,\n) {\n  const formatted = buildFormatUrl(url, format);\n  const base =\n    typeof window === \"undefined\" ? \"http://localhost\" : window.location.origin;\n  const resolved = new URL(formatted, base);\n  resolved.searchParams.set(\"filename\", downloadFilename(url, format, label));\n  resolved.searchParams.set(\"_download\", Date.now().toString());\n  if (scope) {\n    resolved.searchParams.set(\"scope\", scope);\n  }\n  if (scope === \"all\") {\n    resolved.searchParams.delete(\"limit\");\n    resolved.searchParams.delete(\"offset\");\n    resolved.searchParams.delete(\"page\");\n  }\n\n  if (isAbsoluteUrl(formatted)) {\n    return resolved.toString();\n  }\n\n  return `${resolved.pathname}${resolved.search}${resolved.hash}`;\n}\n\nfunction downloadFilename(\n  url: string,\n  format: ClickyRemoteFormat,\n  label?: string | undefined,\n) {\n  const stem = sanitizeFilenameStem(\n    label || filenameStemFromUrl(url) || \"clicky-output\",\n  );\n  return `${stem}${downloadExtension(format)}`;\n}\n\nfunction filenameStemFromUrl(url: string) {\n  const base =\n    typeof window === \"undefined\" ? \"http://localhost\" : window.location.origin;\n  const resolved = new URL(url, base);\n  const segment = resolved.pathname.split(\"/\").filter(Boolean).at(-1);\n  return segment ?? \"\";\n}\n\nfunction sanitizeFilenameStem(value: string) {\n  const cleaned = stripSurroundingChars(\n    value\n      .trim()\n      .replace(/\\.[a-z0-9]+$/i, \"\")\n      .replace(/[^a-z0-9._-]+/gi, \"-\")\n      .replace(/-+/g, \"-\"),\n    \"._-\",\n  );\n\n  return cleaned || \"clicky-output\";\n}\n\nfunction downloadExtension(format: ClickyRemoteFormat) {\n  switch (format) {\n    case \"clicky\":\n      return \".clicky.json\";\n    case \"json\":\n      return \".json\";\n    case \"ndjson\":\n      return \".ndjson\";\n    case \"pdf\":\n      return \".pdf\";\n    case \"html\":\n      return \".html\";\n    case \"markdown\":\n      return \".md\";\n    case \"yaml\":\n      return \".yaml\";\n    case \"csv\":\n      return \".csv\";\n    case \"pretty\":\n      return \".txt\";\n    case \"excel\":\n      return \".xlsx\";\n    case \"slack\":\n      return \".slack.json\";\n  }\n}\n\nconst CLICKY_DOWNLOAD_FRAME_ID = \"clicky-download-frame\";\n\nfunction triggerDownload(url: string) {\n  if (typeof document === \"undefined\") return;\n\n  let frame = document.getElementById(\n    CLICKY_DOWNLOAD_FRAME_ID,\n  ) as HTMLIFrameElement | null;\n  if (!frame) {\n    frame = document.createElement(\"iframe\");\n    frame.id = CLICKY_DOWNLOAD_FRAME_ID;\n    frame.name = CLICKY_DOWNLOAD_FRAME_ID;\n    frame.title = \"Clicky download target\";\n    frame.setAttribute(\"aria-hidden\", \"true\");\n    frame.tabIndex = -1;\n    frame.style.display = \"none\";\n    document.body.appendChild(frame);\n  }\n\n  frame.src = url;\n}\n\nfunction isAbsoluteUrl(url: string) {\n  return /^[a-z][a-z\\d+\\-.]*:/i.test(url) || url.startsWith(\"//\");\n}\n"],"mappings":";;;;;;;;;;AAsBA,IAAa,8BAA8B,CAAC,UAAU,MAAM;AAC5D,IAAa,+BAA+B;CAC1C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AACA,IAAM,0BAA0B;CAC9B;CACA;CACA;CACA;CACA;AACF;AAiCA,SAAgB,mBAAmB,EACjC,KACA,YAIuB;CAGvB,IAAI,EAFY,WAAY,SAAS,OAAO,OAAQ,CAAC,CAAC,QAEtC,CAAC,KACf,OAAO,CAAC;CAGV,OAAO,UAAU,SAAS,SACtB,CAAC,GAAG,SAAS,OAAO,IACpB,CAAC,GAAG,uBAAuB;AACjC;AAEA,SAAS,kBACP,UACwC;CACxC,OAAO,UAAU,QAAQ,SAAS,SAAS,SAAS,CAAC,KAAA,CAAS;AAChE;AAEA,SAAS,oBACP,QACA,OACA,UACA;CACA,MAAM,UAAU,UAAU,gBAAgB;CAC1C,IAAI,SACF,OAAO,cAAc,QAAQ,eAAe,EAAE;CAEhD,IAAI,UAAU,SAAS,UAAU,gBAAgB,YAC/C,OAAO;CAET,IAAI,UAAU,SAAS,UAAU,gBAAgB,aAC/C,OAAO;AAGX;AAMA,SAAgB,oBAAoB,EAClC,KACA,YAI6B;CAC7B,IAAI,CAAC,KAAK,OAAO,CAAC;CAClB,OAAO,mBAAmB;EAAE;EAAK;CAAS,CAAC,CAAC,CAAC,KAAK,WAAW;EAC3D,MAAM,OAAO,oBAAoB,MAAM;EACvC,OAAO;GACL;GACA,OAAO,KAAK;GACZ,aAAa,KAAK;GAClB,MAAM,KAAK;GACX,GAAI,KAAK,gBAAgB,EAAE,eAAe,KAAK,cAAc,IAAI,CAAC;EACpE;CACF,CAAC;AACH;AASA,SAAgB,mBACd,UACA,YAC2B;CAC3B,OAAO,kBAAkB,QAAQ,CAAC,CAAC,KAAK,WAAW;EACjD;EACA,OACE,UAAU,SAAS,UAAU,KAAA,IACzB,aAAa,UAAU,IACvB;EACN,OAAO,WACL,oBAAoB,QAA8B,OAAO,QAAQ;CACrE,EAAE;AACJ;AAKA,SAAS,aAAa,YAA0C;CAC9D,MAAM,QAAQ,YAAY;CAC1B,IAAI,UAAU,KAAA,GAAW,OAAO;CAChC,MAAM,QAAQ,MAAM,eAAe;CACnC,OAAO,YAAY,kBAAkB,QACjC,OAAO,MAAM,UACb,OAAO,MAAM;AACnB;AAKA,eAAsB,kBAAkB,EACtC,KACA,QACA,OACA,YAMgB;CAChB,IAAI,UAAU;CACd,MAAM,gBAAgB;EACpB;EACA;EACA,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC;EACzB,GAAI,WAAW,EAAE,SAAS,IAAI,CAAC;EAC/B,UAAU,YAAY;GACpB,UAAU;EACZ;CACF,CAAC;CACD,IAAI,SAAS,MAAM,IAAI,MAAM,OAAO;AACtC;AAEA,eAAe,gBAAgB,EAC7B,KACA,QACA,OACA,UACA,WACA,WAQC;CACD,UAAU,EAAE;CACZ,YAAY,IAAI;CAChB,IAAI;EACF,MAAM,WAAW,UAAU,UACvB,MAAM,SAAS,QAAQ;GAAE;GAAQ,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC;EAAG,CAAC,IAC9D;GAAE;GAAK,GAAI,UAAU,QAAQ,EAAE,OAAO,SAAS,MAAM,IAAI,CAAC;EAAG;EACjE,IAAI,CAAC,SAAS,IAAI,KAAK,GACrB,MAAM,IAAI,MAAM,oCAAoC;EAEtD,gBACE,iBACE,SAAS,KACT,QACA,SAAS,SAAS,UAAU,OAC5B,KACF,CACF;CACF,SAAS,OAAO;EACd,UACE,iBAAiB,QAAQ,MAAM,UAAU,+BAC3C;CACF,UAAU;EACR,YAAY,KAAK;CACnB;AACF;AAEA,SAAgB,oBAAoB,QAMlC;CACA,QAAQ,QAAR;EACE,KAAK,UACH,OAAO;GACL,OAAO;GACP,aAAa;GACb,MAAM;GACN,QACE;EACJ;EACF,KAAK,QACH,OAAO;GACL,OAAO;GACP,aAAa;GACb,MAAM;GACN,QAAQ;EACV;EACF,KAAK,UACH,OAAO;GACL,OAAO;GACP,aAAa;GACb,MAAM;GACN,QAAQ;EACV;EACF,KAAK,OACH,OAAO;GACL,OAAO;GACP,aAAa;GACb,MAAM;GACN,eAAe;GACf,QAAQ;EACV;EACF,KAAK,QACH,OAAO;GACL,OAAO;GACP,aAAa;GACb,MAAM;GACN,QAAQ;EACV;EACF,KAAK,YACH,OAAO;GACL,OAAO;GACP,aAAa;GACb,MAAM;GACN,QAAQ;EACV;EACF,KAAK,QACH,OAAO;GACL,OAAO;GACP,aAAa;GACb,MAAM;GACN,eAAe;GACf,QAAQ;EACV;EACF,KAAK,OACH,OAAO;GACL,OAAO;GACP,aAAa;GACb,MAAM;GACN,eAAe;GACf,QAAQ;EACV;EACF,KAAK,UACH,OAAO;GACL,OAAO;GACP,aAAa;GACb,MAAM;GACN,QAAQ;EACV;EACF,KAAK,SACH,OAAO;GACL,OAAO;GACP,aAAa;GACb,MAAM;GACN,QACE;EACJ;EACF,KAAK,SACH,OAAO;GACL,OAAO;GACP,aAAa;GACb,MAAM;GACN,QACE;EACJ;CACJ;AACF;AAEA,SAAgB,eAAe,KAAa,QAA4B;CACtE,MAAM,OACJ,OAAO,WAAW,cAAc,qBAAqB,OAAO,SAAS;CACvE,MAAM,WAAW,IAAI,IAAI,KAAK,IAAI;CAClC,SAAS,aAAa,IACpB,UACA,WAAW,WAAW,gBAAgB,MACxC;CAEA,IAAI,cAAc,GAAG,GACnB,OAAO,SAAS,SAAS;CAG3B,OAAO,GAAG,SAAS,WAAW,SAAS,SAAS,SAAS;AAC3D;AAEA,SAAS,iBACP,KACA,QACA,OACA,OACA;CACA,MAAM,YAAY,eAAe,KAAK,MAAM;CAC5C,MAAM,OACJ,OAAO,WAAW,cAAc,qBAAqB,OAAO,SAAS;CACvE,MAAM,WAAW,IAAI,IAAI,WAAW,IAAI;CACxC,SAAS,aAAa,IAAI,YAAY,iBAAiB,KAAK,QAAQ,KAAK,CAAC;CAC1E,SAAS,aAAa,IAAI,aAAa,KAAK,IAAI,CAAC,CAAC,SAAS,CAAC;CAC5D,IAAI,OACF,SAAS,aAAa,IAAI,SAAS,KAAK;CAE1C,IAAI,UAAU,OAAO;EACnB,SAAS,aAAa,OAAO,OAAO;EACpC,SAAS,aAAa,OAAO,QAAQ;EACrC,SAAS,aAAa,OAAO,MAAM;CACrC;CAEA,IAAI,cAAc,SAAS,GACzB,OAAO,SAAS,SAAS;CAG3B,OAAO,GAAG,SAAS,WAAW,SAAS,SAAS,SAAS;AAC3D;AAEA,SAAS,iBACP,KACA,QACA,OACA;CAIA,OAAO,GAHM,qBACX,SAAS,oBAAoB,GAAG,KAAK,eAE7B,IAAO,kBAAkB,MAAM;AAC3C;AAEA,SAAS,oBAAoB,KAAa;CACxC,MAAM,OACJ,OAAO,WAAW,cAAc,qBAAqB,OAAO,SAAS;CAGvE,OADgB,IADK,IAAI,KAAK,IACd,CAAA,CAAS,SAAS,MAAM,GAAG,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,GAAG,EACzD,KAAW;AACpB;AAEA,SAAS,qBAAqB,OAAe;CAU3C,OATgB,sBACd,MACG,KAAK,CAAC,CACN,QAAQ,iBAAiB,EAAE,CAAC,CAC5B,QAAQ,mBAAmB,GAAG,CAAC,CAC/B,QAAQ,OAAO,GAAG,GACrB,KAGK,KAAW;AACpB;AAEA,SAAS,kBAAkB,QAA4B;CACrD,QAAQ,QAAR;EACE,KAAK,UACH,OAAO;EACT,KAAK,QACH,OAAO;EACT,KAAK,UACH,OAAO;EACT,KAAK,OACH,OAAO;EACT,KAAK,QACH,OAAO;EACT,KAAK,YACH,OAAO;EACT,KAAK,QACH,OAAO;EACT,KAAK,OACH,OAAO;EACT,KAAK,UACH,OAAO;EACT,KAAK,SACH,OAAO;EACT,KAAK,SACH,OAAO;CACX;AACF;AAEA,IAAM,2BAA2B;AAEjC,SAAS,gBAAgB,KAAa;CACpC,IAAI,OAAO,aAAa,aAAa;CAErC,IAAI,QAAQ,SAAS,eACnB,wBACF;CACA,IAAI,CAAC,OAAO;EACV,QAAQ,SAAS,cAAc,QAAQ;EACvC,MAAM,KAAK;EACX,MAAM,OAAO;EACb,MAAM,QAAQ;EACd,MAAM,aAAa,eAAe,MAAM;EACxC,MAAM,WAAW;EACjB,MAAM,MAAM,UAAU;EACtB,SAAS,KAAK,YAAY,KAAK;CACjC;CAEA,MAAM,MAAM;AACd;AAEA,SAAS,cAAc,KAAa;CAClC,OAAO,uBAAuB,KAAK,GAAG,KAAK,IAAI,WAAW,IAAI;AAChE"}

package/dist/data/traces/index.d.ts

@@ -19,6 +19,8 @@ export type { HttpExchangeRequest, HttpExchangeResponse, GoProfileRecord, HttpEx
 export { OtelTraceDetail } from './otel/OtelTraceDetail.js';
 export { OtelTraceSearch } from './otel/OtelTraceSearch.js';
 export { OtelTraceTable, type OtelTraceTableProps } from './otel/OtelTraceTable.js';
+export { profileSpans } from './otel/profile-spans.js';
+export { profileListingSort, profileTraceListing } from './otel/profile-listing.js';
 export { searchParams as otelSearchParams, readSearchValues as readOtelSearchValues } from './otel/api.js';
 export { durationOf as otelDurationOf } from './otel/query.js';
 export type { Span as OtelSpan, Summary as OtelSummary, SearchForm as OtelSearchForm } from './otel/api.js';