@nxgt/material-core 0.2.0 → 0.3.1

package/README.md

@@ -67,10 +67,13 @@ built-in.
 | `/pdf-source` | `PdfSource` and its helpers (`toPdfjsSource`, `pdfSourceKey`, …) |
 | `/pdf-file-name` | `resolvePdfFileName`, `DEFAULT_PDF_FILE_NAME` |
 | `/pdf-download` | `downloadPdfFile`, `printPdfFile` — in a browser |
-| `/pdf-viewer` | The PDF viewer's pure half: page geometry and fit (`readerFitScale`, `placeholderSize`, `rotatedSize`, `PdfPageSize`, `FitMode`), page sizes (`readPageSizes`, `createPageSizesLoader`), the scroll spy (`createScrollSpy`, `revealHit`), text search (`pageTextFromItems`, `findTextMatches`, `searchDocument`), `escapeHtml`, `mapPdfOutline` |
+| `/pdf-viewer` | The PDF viewer's pure half: page geometry and fit (`readerFitScale`, `placeholderSize`, `rotatedSize`, `PdfPageSize`, `FitMode`), page sizes (`readPageSizes`, `createPageSizesLoader`), the scroll spy (`createScrollSpy`, `revealHit`, `scrollIntoArea`), the opening page's pin (`pinToPage`, whose optional `onRelease` runs once when it lets go, and `pinHolds`, whether the view is still where it puts the page), text search (`pageTextFromItems`, `findTextMatches`, `searchDocument`), `escapeHtml`, `mapPdfOutline` |
 | `/currency-digits` | `currencyFractionDigits` — the decimals `CurrencyField` shows |
 | `/field-blur-layers` | `layerOf`, `openerOf`, `FieldLayers` — whose overlay a layer of the page is, for a field's blur |
 | `/format-file-size` | `formatFileSize` — a byte count as `'1.5 KB'` |
+| `/slider-ticks` | `tickValues` — where a slider's tick marks sit |
+| `/date-range` | `DATE_RANGE_PRESET_IDS`, `presetRange`, `resolvePresetRange`, `isSameDayRange`, `isRangeDisabled`, `withTimeOf`, `endOfDayTime`, `clampRangeEnd`, `keepRangeTimes` and the types `DayRange`, `PartialDayRange`, `DateRangePreset`, `DateRangePresetId`, `DateRangePresetOption`, `DateRangeRules` — `DateRangeField`'s presets and times |
+| `/file-preview` | `fileKind`, `describeFile`, `safePreviewUrl`, `readTextPreview`, `FilePreviewHttpError`, `FilePreviewUnsafeUrlError`, `TEXT_PREVIEW_MAX_BYTES`, `fileExtension`, `fileNameFromUrl`, `dataUrlType`, `kindOfMimeType`, `normaliseMimeType`, `isTextFileKind`, `TEXT_FILE_KINDS` and the types `FileKind`, `FileKindInput`, `DescribedFile`, `FilePreviewSource`, `TextPreview` — `FilePreview`'s kind detection, URL allow-list and text reader |
 | `/vite` | `pdfkitStandardFonts()` — see below |
 | `/pdfkit-fonts` | **Node only.** `pdfkitStandardFontDirs`, `pdfkitStandardFontFiles`, `PDFKIT_STANDARD_FONTS`, the types `PdfkitStandardFont` and `PdfkitFontsWarn` — where the app's pdfkit keeps its standard fonts, for a server tracer |
 
@@ -276,6 +279,37 @@ const page = pageTextFromItems([{ str: 'Café au', hasEOL: true }, { str: 'lait'
 findTextMatches(page.text, 'cafe au lait'); // [{ start: 0, end: 12 }] — case, accents and line breaks ignored
 ```
 
+To open a reader on a page, `pinToPage(node, beforeScroll, onRelease?)`
+keeps that page at the top of the page area (an element inside the
+`[data-slot="scroll-area-viewport"]` of a `[data-slot="scroll-area"]`) while
+the pages above it change size, until a wheel, touch, pointer or key in the
+page area, or the function it returns. `beforeScroll` runs before each
+correction (hold your scroll spy there); `onRelease` runs once when the pin
+lets go — at once when there is nothing to pin, or no `ResizeObserver` (a
+server). `pinHolds(node)` tells whether the view still shows `node` where the
+pin puts it: at the top, or as near as the area can scroll at its end. A
+scroll that leaves it elsewhere came from find in page, a screen reader's
+cursor or your own `scrollTop`, none of which the pin hears: treat it as the
+user's.
+
+```ts
+import { pinHolds, pinToPage } from '@nxgt/material-core/pdf-viewer';
+
+// pages: Map<number, HTMLElement>; spy: from createScrollSpy
+let pinned = true;
+const unpin = pinToPage(
+  () => pages.get(3), // the page's element, looked up again on each correction
+  () => spy.hold(), // the corrections are not the user's scrolling
+  () => { pinned = false; }, // the pin let go
+);
+
+function onScroll(page: number) {
+  if (pinned && pinHolds(pages.get(3))) return; // still the reader's own scroll
+  unpin(); // the view moved elsewhere: let go, then report
+  reportPage(page);
+}
+```
+
 ### A currency's decimals: `/currency-digits`
 
 ```ts
@@ -304,6 +338,112 @@ formatFileSize(5 * 1024 ** 2); // '5.0 MB'
 formatFileSize(-1); // '' — as for NaN and Infinity
 ```
 
+### A slider's tick marks: `/slider-ticks`
+
+The values both libraries' `SliderField` (`ticks`) draws its marks at, from
+`min` to `max` inclusive and evenly spaced: `false` gives none, a number that
+many, `true` one per `step` (five without one). Any count is kept between 2
+and 21 marks, except when `min === max`: then there is one mark, at `min`.
+
+```ts
+import { tickValues } from '@nxgt/material-core/slider-ticks';
+
+tickValues(0, 100, false); // []
+tickValues(0, 100, 5); // [0, 25, 50, 75, 100]
+tickValues(0, 10, true, 5); // [0, 5, 10]
+tickValues(0, 100, true, 1).length; // 21 — capped
+tickValues(5, 5, true); // [5] — min === max
+```
+
+### A date range's presets and times: `/date-range`
+
+The pure half of both libraries' `DateRangeField` (`presets`, `withTime` /
+`with-time`): the built-in presets' ranges, whether a field's rules rule a
+range out, and the time of day on each end. Plain `Date` maths in the local
+time zone; nothing reads the clock unless you leave `now` out. Both libraries
+re-export `DATE_RANGE_PRESET_IDS` and the preset types.
+
+```ts
+import {
+	clampRangeEnd,
+	isRangeDisabled,
+	presetRange,
+	resolvePresetRange,
+} from '@nxgt/material-core/date-range';
+
+const now = new Date(2026, 2, 18, 15, 30); // Wednesday 18 March 2026
+
+presetRange('last-7-days', now); // 12 → 18 March, both at 00:00 (today counts)
+presetRange('this-month', now); // 1 → 18 March
+presetRange('last-month', now); // 1 → 28 February
+resolvePresetRange('today', now, { withTime: true }); // 18 March 00:00 → 23:59
+resolvePresetRange({ label: 'Q1', range: (n) => ({ from: new Date(n.getFullYear(), 0, 1), to: new Date(n.getFullYear(), 2, 31) }) }, now);
+
+// Ruled out when its end comes before its start, it starts before `min`,
+// ends after `max`, or either end is a disabled day; the days between are
+// not checked.
+isRangeDisabled(presetRange('yesterday', now), { min: now }); // true
+
+// On the same day, an end before the start becomes the start.
+clampRangeEnd({ from: new Date(2026, 2, 18, 14), to: new Date(2026, 2, 18, 9) }); // to: 14:00
+```
+
+`keepRangeTimes(next, previous)` gives days picked on a calendar the times
+`previous` had at each end (a new start 00:00, a new end 23:59), then clamps
+the end;
+`withTimeOf(day, time)` and `endOfDayTime(day)` set one end's time;
+`isSameDayRange(a, b)` compares two ranges by their days.
+
+### A file's preview: `/file-preview`
+
+The pure half of both libraries' `FilePreview`. `fileKind` picks the kind of
+preview — `image`, `pdf`, `video`, `audio`, `text`, `json`, `csv`,
+`markdown` or `other` — from the MIME type when it names one (parameters and
+case ignored, a `data:` URL's own type read), else from the extension of the
+name, then of the URL. `describeFile` does the same for a `File` / `Blob` or a
+URL, with `type` and `name` overriding what the file says (a URL
+`safePreviewUrl` refuses lends no name). `safePreviewUrl` is the allow-list
+for what reaches an `href` or a `src`: `http(s):`, a relative URL, `blob:`,
+and a `data:` URL of an image, video, audio file, plain text, CSV, Markdown,
+JSON or PDF; it returns `null` for anything else (`javascript:`,
+`vbscript:`, `data:text/html`, …), after removing what the browser ignores
+(spaces and control characters at the ends, tabs and newlines anywhere), and
+`FilePreviewUnsafeUrlError` ("Refused to preview a URL with an unsafe
+scheme") is what `FilePreview` reports for one it refused.
+`readTextPreview` reads the first bytes of a `Blob`, or of what a URL answers
+(it stops downloading past the cap), decoded with the `charset` of the
+response's `Content-Type` (or of the `Blob`'s `type`) when `TextDecoder`
+supports it, else as UTF-8, and says whether there was more; an HTTP error
+throws `FilePreviewHttpError` (`Could not read <url>: HTTP <status>`) with
+its `status`, and an aborted `signal` rejects with its reason, for a `Blob`
+too. Nothing runs at import, so it is safe on a server; only
+`readTextPreview` touches `fetch`.
+
+```ts
+import {
+	describeFile,
+	fileKind,
+	readTextPreview,
+	safePreviewUrl,
+} from '@nxgt/material-core/file-preview';
+
+fileKind({ type: 'application/pdf' }); // 'pdf'
+fileKind({ type: 'application/octet-stream', name: 'notes.MD' }); // 'markdown' — the extension decides
+fileKind({ url: 'https://example.com/clip.webm?sig=1' }); // 'video'
+fileKind({ name: 'archive.zip' }); // 'other'
+
+safePreviewUrl('/files/report.pdf'); // '/files/report.pdf'
+safePreviewUrl('javascript:alert(1)'); // null
+safePreviewUrl('data:text/html,<b>hi</b>'); // null
+
+describeFile(new File(['{}'], 'data.json', { type: 'application/json' }));
+// { kind: 'json', name: 'data.json', type: 'application/json', size: 2, blob: File }
+
+const { text, truncated } = await readTextPreview('/logs/today.log', {
+	maxBytes: 64 * 1024, // 256 KB (TEXT_PREVIEW_MAX_BYTES) by default
+});
+```
+
 ### A field's blur across overlays: `/field-blur-layers`
 
 A field whose popover, listbox or dialog renders into `<body>` must not count
@@ -389,6 +529,8 @@ of `@nxgt/material-vue` adds the files to `nitro.externals.traceInclude`.
 | `Cannot find package '@react-pdf/renderer'` (or `'react'`) when importing `/pdf` or `/pdf/render` | `bun add react @react-pdf/renderer@^4.9` — or import from `/pdf/model` where you only build documents |
 | `Cannot find module '#standard-fonts/Helvetica'` on every request of a bundled server | `pdfkitStandardFonts()` from `/vite`, or keep the renderer external |
 | `Cannot find module '…/pdfkit/js/standard-fonts/Helvetica.cjs'` from a traced server output | add `pdfkitStandardFontFiles()` (or the directories' `**/*.cjs`) to the tracer's includes — `withNxgtPrint` and the Nuxt module do |
+| `Could not read <url>: HTTP 401` (`FilePreviewHttpError`) for a file behind authentication | fetch it with your credentials and pass the `Blob` to `readTextPreview` / `FilePreview` |
+| `Refused to preview a URL with an unsafe scheme` (`FilePreviewUnsafeUrlError`) | pass an `https:` or relative URL, or the content as a `Blob` |
 
 Every message, with its cause, is in [troubleshooting](https://cdn.jsdelivr.net/npm/@nxgt/material-core@0/docs/troubleshooting.md).
 

package/dist/file-preview/describe-file.d.ts

@@ -0,0 +1,30 @@
+import { type FileKind } from './file-kind';
+/** What `FilePreview` previews: a `File` or `Blob`, or a URL. */
+export type FilePreviewSource = Blob | string;
+/** A file as `FilePreview` sees it, before anything is read. */
+export type DescribedFile = {
+    kind: FileKind;
+    /**
+     * The given name, else the `File`'s, else the URL's last segment (none
+     * for a URL `safePreviewUrl` refuses); may be `''`.
+     */
+    name: string;
+    /** The given MIME type, else the `Blob`'s or the `data:` URL's; may be `''`. */
+    type: string;
+    /** The size in bytes, known for a `Blob` only. */
+    size?: number;
+    /** The `File` / `Blob` itself. */
+    blob?: Blob;
+    /** The URL, when the file was given as one. */
+    url?: string;
+};
+/**
+ * The kind, name, type and size of a file given as a `File` / `Blob` or a
+ * URL, with `type` and `name` overriding what the file says. `null` for no
+ * file. Reads nothing: a URL is not fetched.
+ */
+export declare function describeFile(file: FilePreviewSource | null | undefined, options?: {
+    type?: string;
+    name?: string;
+}): DescribedFile | null;
+//# sourceMappingURL=describe-file.d.ts.map

package/dist/file-preview/describe-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-file.d.ts","sourceRoot":"","sources":["../../src/file-preview/describe-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,QAAQ,EAIb,MAAM,aAAa,CAAC;AAGrB,iEAAiE;AACjE,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,MAAM,CAAC;AAE9C,gEAAgE;AAChE,MAAM,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,YAAY,CAC3B,IAAI,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,EAC1C,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5C,aAAa,GAAG,IAAI,CAmBtB"}

package/dist/file-preview/file-kind.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Which kind of preview `FilePreview` gives a file: from its MIME type or,
+ * failing that, its extension. Pure string work, safe anywhere.
+ */
+/** What `FilePreview` renders a file as. */
+export type FileKind = 'image' | 'pdf' | 'video' | 'audio' | 'text' | 'json' | 'csv' | 'markdown' | 'other';
+/** The kinds whose content is read as text and shown as such. */
+export declare const TEXT_FILE_KINDS: readonly FileKind[];
+/** `'image/png'` from `'Image/PNG; charset=x'`: lower case, parameters dropped. */
+export declare function normaliseMimeType(type: string | undefined): string;
+/** The kind a MIME type names, or `undefined` when it names none. */
+export declare function kindOfMimeType(type: string | undefined): FileKind | undefined;
+/**
+ * A file name's or a URL's extension, lower case and without its dot:
+ * `'png'` for `'Photo.PNG'` and `'https://x/a.png?v=2#top'`, `''` when there
+ * is none (`'README'`, `'.env'`, a `data:` URL).
+ */
+export declare function fileExtension(nameOrUrl: string | undefined): string;
+/** The MIME type a `data:` URL declares (`''` for any other URL). */
+export declare function dataUrlType(url: string | undefined): string;
+/**
+ * The last segment of a URL's path, decoded: `'report.pdf'` for
+ * `'https://x/files/report.pdf?token=1'`; `''` for a `data:` or `blob:` URL
+ * or a path ending in `/`.
+ */
+export declare function fileNameFromUrl(url: string | undefined): string;
+/** What `fileKind` reads: the MIME type, and a name or URL for the extension. */
+export type FileKindInput = {
+    type?: string;
+    name?: string;
+    url?: string;
+};
+/**
+ * The kind of preview a file gets: from its MIME type (or a `data:` URL's)
+ * when that names one, else from the extension of its name, then of its URL;
+ * `'other'` when neither says.
+ */
+export declare function fileKind({ type, name, url }: FileKindInput): FileKind;
+/** Whether a kind is read as text (`text`, `json`, `csv`, `markdown`). */
+export declare function isTextFileKind(kind: FileKind): boolean;
+//# sourceMappingURL=file-kind.d.ts.map

package/dist/file-preview/file-kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-kind.d.ts","sourceRoot":"","sources":["../../src/file-preview/file-kind.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,4CAA4C;AAC5C,MAAM,MAAM,QAAQ,GACjB,OAAO,GACP,KAAK,GACL,OAAO,GACP,OAAO,GACP,MAAM,GACN,MAAM,GACN,KAAK,GACL,UAAU,GACV,OAAO,CAAC;AAEX,iEAAiE;AACjE,eAAO,MAAM,eAAe,EAAE,SAAS,QAAQ,EAK9C,CAAC;AAkDF,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAElE;AAED,qEAAqE;AACrE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAsB7E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAMnE;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAG3D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAS/D;AAED,iFAAiF;AACjF,MAAM,MAAM,aAAa,GAAG;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,aAAa,GAAG,QAAQ,CAQrE;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAEtD"}

package/dist/file-preview/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The pure half of both libraries' `FilePreview`: which kind of preview a
+ * file gets (`fileKind`, `describeFile`), which URLs it may link to or load
+ * (`safePreviewUrl`), and its text read with a size cap (`readTextPreview`). Safe on a server: nothing runs at import.
+ */
+export { type DescribedFile, describeFile, type FilePreviewSource, } from './describe-file';
+export { dataUrlType, type FileKind, type FileKindInput, fileExtension, fileKind, fileNameFromUrl, isTextFileKind, kindOfMimeType, normaliseMimeType, TEXT_FILE_KINDS, } from './file-kind';
+export { FilePreviewUnsafeUrlError, safePreviewUrl } from './safe-url';
+export { FilePreviewHttpError, readTextPreview, TEXT_PREVIEW_MAX_BYTES, type TextPreview, } from './text-preview';
+//# sourceMappingURL=index.d.ts.map

package/dist/file-preview/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/file-preview/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACN,KAAK,aAAa,EAClB,YAAY,EACZ,KAAK,iBAAiB,GACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,WAAW,EACX,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,aAAa,EACb,QAAQ,EACR,eAAe,EACf,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,eAAe,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,EACN,oBAAoB,EACpB,eAAe,EACf,sBAAsB,EACtB,KAAK,WAAW,GAChB,MAAM,gBAAgB,CAAC"}

package/dist/file-preview/index.js

@@ -0,0 +1,260 @@
+// src/file-preview/file-kind.ts
+var TEXT_FILE_KINDS = [
+  "text",
+  "json",
+  "csv",
+  "markdown"
+];
+var EXTENSION_KINDS = {
+  png: "image",
+  jpg: "image",
+  jpeg: "image",
+  gif: "image",
+  webp: "image",
+  avif: "image",
+  svg: "image",
+  bmp: "image",
+  ico: "image",
+  pdf: "pdf",
+  mp4: "video",
+  m4v: "video",
+  webm: "video",
+  ogv: "video",
+  mov: "video",
+  mp3: "audio",
+  wav: "audio",
+  ogg: "audio",
+  oga: "audio",
+  m4a: "audio",
+  aac: "audio",
+  flac: "audio",
+  opus: "audio",
+  json: "json",
+  csv: "csv",
+  tsv: "csv",
+  md: "markdown",
+  markdown: "markdown",
+  txt: "text",
+  log: "text",
+  xml: "text",
+  yaml: "text",
+  yml: "text",
+  ini: "text",
+  toml: "text"
+};
+var TEXT_APPLICATION_TYPES = new Set([
+  "application/xml",
+  "application/yaml",
+  "application/x-yaml",
+  "application/toml",
+  "application/javascript",
+  "application/x-sh",
+  "application/sql"
+]);
+function normaliseMimeType(type) {
+  return (type ?? "").split(";")[0]?.trim().toLowerCase() ?? "";
+}
+function kindOfMimeType(type) {
+  const mime = normaliseMimeType(type);
+  if (!mime)
+    return;
+  if (mime === "application/pdf")
+    return "pdf";
+  if (mime === "application/json" || mime === "text/json" || mime.endsWith("+json")) {
+    return "json";
+  }
+  if (mime === "text/csv" || mime === "application/csv")
+    return "csv";
+  if (mime === "text/tab-separated-values")
+    return "csv";
+  if (mime === "text/markdown" || mime === "text/x-markdown") {
+    return "markdown";
+  }
+  const [family] = mime.split("/");
+  if (family === "image" || family === "video" || family === "audio") {
+    return family;
+  }
+  if (family === "text" || TEXT_APPLICATION_TYPES.has(mime))
+    return "text";
+  return;
+}
+function fileExtension(nameOrUrl) {
+  if (!nameOrUrl || nameOrUrl.startsWith("data:"))
+    return "";
+  const path = nameOrUrl.split(/[?#]/)[0] ?? "";
+  const base = path.slice(path.lastIndexOf("/") + 1);
+  const dot = base.lastIndexOf(".");
+  return dot > 0 ? base.slice(dot + 1).toLowerCase() : "";
+}
+function dataUrlType(url) {
+  const match = /^data:([^;,]*)/i.exec(url ?? "");
+  return normaliseMimeType(match?.[1]);
+}
+function fileNameFromUrl(url) {
+  if (!url || /^(data|blob):/i.test(url))
+    return "";
+  const path = url.split(/[?#]/)[0] ?? "";
+  const segment = path.slice(path.lastIndexOf("/") + 1);
+  try {
+    return decodeURIComponent(segment);
+  } catch {
+    return segment;
+  }
+}
+function fileKind({ type, name, url }) {
+  return kindOfMimeType(type) ?? kindOfMimeType(dataUrlType(url)) ?? EXTENSION_KINDS[fileExtension(name)] ?? EXTENSION_KINDS[fileExtension(url)] ?? "other";
+}
+function isTextFileKind(kind) {
+  return TEXT_FILE_KINDS.includes(kind);
+}
+
+// src/file-preview/safe-url.ts
+var DATA_TYPES = /^(image\/[\w.+-]+|video\/[\w.+-]+|audio\/[\w.+-]+|text\/(plain|csv|markdown|x-markdown)|application\/(json|pdf))$/;
+var ENDS = /^[\u0000-\u0020]+|[\u0000-\u0020]+$/g;
+var TAB_OR_NEWLINE = /[\t\n\r]/g;
+var SCHEME = /^([a-z][a-z\d+.-]*):/i;
+function safePreviewUrl(url) {
+  if (url == null)
+    return null;
+  const value = url.replace(ENDS, "").replace(TAB_OR_NEWLINE, "");
+  if (!value)
+    return null;
+  const scheme = SCHEME.exec(value)?.[1]?.toLowerCase();
+  if (scheme === undefined) {
+    const head = value.split(/[/?#]/, 1)[0] ?? "";
+    return head.includes(":") ? null : value;
+  }
+  if (scheme === "http" || scheme === "https" || scheme === "blob") {
+    return value;
+  }
+  if (scheme === "data") {
+    const type = value.slice("data:".length).split(/[;,]/, 1)[0]?.toLowerCase();
+    return type && DATA_TYPES.test(type) ? value : null;
+  }
+  return null;
+}
+
+class FilePreviewUnsafeUrlError extends Error {
+  constructor() {
+    super("Refused to preview a URL with an unsafe scheme");
+    this.name = "FilePreviewUnsafeUrlError";
+  }
+}
+
+// src/file-preview/describe-file.ts
+function describeFile(file, options = {}) {
+  if (file == null || file === "")
+    return null;
+  if (typeof file === "string") {
+    const name = options.name ?? (safePreviewUrl(file) === null ? "" : fileNameFromUrl(file));
+    const type = normaliseMimeType(options.type ?? dataUrlType(file));
+    return { kind: fileKind({ type, name, url: file }), name, type, url: file };
+  }
+  const own = "name" in file && typeof file.name === "string" ? file.name : "";
+  const name = options.name ?? own;
+  const type = normaliseMimeType(options.type ?? file.type);
+  return {
+    kind: fileKind({ type, name }),
+    name,
+    type,
+    size: file.size,
+    blob: file
+  };
+}
+// src/file-preview/text-preview.ts
+var TEXT_PREVIEW_MAX_BYTES = 256 * 1024;
+
+class FilePreviewHttpError extends Error {
+  constructor(url, status) {
+    super(`Could not read ${url}: HTTP ${status}`);
+    this.name = "FilePreviewHttpError";
+    this.status = status;
+  }
+}
+function decoderFor(contentType) {
+  const charset = /;\s*charset\s*=\s*"?([^";\s]+)/i.exec(contentType ?? "")?.[1];
+  if (charset) {
+    try {
+      return new TextDecoder(charset);
+    } catch {}
+  }
+  return new TextDecoder;
+}
+function decode(bytes, truncated, contentType) {
+  return decoderFor(contentType).decode(bytes, { stream: truncated });
+}
+async function readBlob(blob, maxBytes, signal, contentType) {
+  signal?.throwIfAborted();
+  const truncated = blob.size > maxBytes;
+  const buffer = await blob.slice(0, maxBytes).arrayBuffer();
+  signal?.throwIfAborted();
+  return {
+    text: decode(new Uint8Array(buffer), truncated, contentType),
+    truncated
+  };
+}
+async function readStream(body, maxBytes, signal, contentType) {
+  const reader = body.getReader();
+  const chunks = [];
+  let length = 0;
+  let truncated = false;
+  while (length <= maxBytes) {
+    const { done, value } = await reader.read();
+    if (signal?.aborted) {
+      await reader.cancel().catch(() => {});
+      signal.throwIfAborted();
+    }
+    if (done)
+      break;
+    chunks.push(value);
+    length += value.length;
+  }
+  if (length > maxBytes) {
+    truncated = true;
+    await reader.cancel().catch(() => {});
+  }
+  const bytes = new Uint8Array(Math.min(length, maxBytes));
+  let offset = 0;
+  for (const chunk of chunks) {
+    if (offset >= bytes.length)
+      break;
+    const part = chunk.subarray(0, bytes.length - offset);
+    bytes.set(part, offset);
+    offset += part.length;
+  }
+  return { text: decode(bytes, truncated, contentType), truncated };
+}
+async function readTextPreview(source, options = {}) {
+  const maxBytes = Math.max(0, options.maxBytes ?? TEXT_PREVIEW_MAX_BYTES);
+  const { signal } = options;
+  if (typeof source !== "string") {
+    return readBlob(source, maxBytes, signal, source.type);
+  }
+  const response = await fetch(source, { signal });
+  if (!response.ok)
+    throw new FilePreviewHttpError(source, response.status);
+  const contentType = response.headers.get("content-type");
+  if (!response.body) {
+    return readBlob(await response.blob(), maxBytes, signal, contentType);
+  }
+  return readStream(response.body, maxBytes, signal, contentType);
+}
+export {
+  FilePreviewHttpError,
+  FilePreviewUnsafeUrlError,
+  TEXT_FILE_KINDS,
+  TEXT_PREVIEW_MAX_BYTES,
+  dataUrlType,
+  describeFile,
+  fileExtension,
+  fileKind,
+  fileNameFromUrl,
+  isTextFileKind,
+  kindOfMimeType,
+  normaliseMimeType,
+  readTextPreview,
+  safePreviewUrl
+};
+
+//# debugId=AA628A1137F8DCB664756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/file-preview/index.js.map

@@ -0,0 +1,13 @@
+{
+  "version": 3,
+  "sources": ["../src/file-preview/file-kind.ts", "../src/file-preview/safe-url.ts", "../src/file-preview/describe-file.ts", "../src/file-preview/text-preview.ts"],
+  "sourcesContent": [
+    "/**\n * Which kind of preview `FilePreview` gives a file: from its MIME type or,\n * failing that, its extension. Pure string work, safe anywhere.\n */\n\n/** What `FilePreview` renders a file as. */\nexport type FileKind =\n\t| 'image'\n\t| 'pdf'\n\t| 'video'\n\t| 'audio'\n\t| 'text'\n\t| 'json'\n\t| 'csv'\n\t| 'markdown'\n\t| 'other';\n\n/** The kinds whose content is read as text and shown as such. */\nexport const TEXT_FILE_KINDS: readonly FileKind[] = [\n\t'text',\n\t'json',\n\t'csv',\n\t'markdown',\n];\n\nconst EXTENSION_KINDS: Record<string, FileKind> = {\n\tpng: 'image',\n\tjpg: 'image',\n\tjpeg: 'image',\n\tgif: 'image',\n\twebp: 'image',\n\tavif: 'image',\n\tsvg: 'image',\n\tbmp: 'image',\n\tico: 'image',\n\tpdf: 'pdf',\n\tmp4: 'video',\n\tm4v: 'video',\n\twebm: 'video',\n\togv: 'video',\n\tmov: 'video',\n\tmp3: 'audio',\n\twav: 'audio',\n\togg: 'audio',\n\toga: 'audio',\n\tm4a: 'audio',\n\taac: 'audio',\n\tflac: 'audio',\n\topus: 'audio',\n\tjson: 'json',\n\tcsv: 'csv',\n\ttsv: 'csv',\n\tmd: 'markdown',\n\tmarkdown: 'markdown',\n\ttxt: 'text',\n\tlog: 'text',\n\txml: 'text',\n\tyaml: 'text',\n\tyml: 'text',\n\tini: 'text',\n\ttoml: 'text',\n};\n\nconst TEXT_APPLICATION_TYPES = new Set([\n\t'application/xml',\n\t'application/yaml',\n\t'application/x-yaml',\n\t'application/toml',\n\t'application/javascript',\n\t'application/x-sh',\n\t'application/sql',\n]);\n\n/** `'image/png'` from `'Image/PNG; charset=x'`: lower case, parameters dropped. */\nexport function normaliseMimeType(type: string | undefined): string {\n\treturn (type ?? '').split(';')[0]?.trim().toLowerCase() ?? '';\n}\n\n/** The kind a MIME type names, or `undefined` when it names none. */\nexport function kindOfMimeType(type: string | undefined): FileKind | undefined {\n\tconst mime = normaliseMimeType(type);\n\tif (!mime) return undefined;\n\tif (mime === 'application/pdf') return 'pdf';\n\tif (\n\t\tmime === 'application/json' ||\n\t\tmime === 'text/json' ||\n\t\tmime.endsWith('+json')\n\t) {\n\t\treturn 'json';\n\t}\n\tif (mime === 'text/csv' || mime === 'application/csv') return 'csv';\n\tif (mime === 'text/tab-separated-values') return 'csv';\n\tif (mime === 'text/markdown' || mime === 'text/x-markdown') {\n\t\treturn 'markdown';\n\t}\n\tconst [family] = mime.split('/');\n\tif (family === 'image' || family === 'video' || family === 'audio') {\n\t\treturn family;\n\t}\n\tif (family === 'text' || TEXT_APPLICATION_TYPES.has(mime)) return 'text';\n\treturn undefined;\n}\n\n/**\n * A file name's or a URL's extension, lower case and without its dot:\n * `'png'` for `'Photo.PNG'` and `'https://x/a.png?v=2#top'`, `''` when there\n * is none (`'README'`, `'.env'`, a `data:` URL).\n */\nexport function fileExtension(nameOrUrl: string | undefined): string {\n\tif (!nameOrUrl || nameOrUrl.startsWith('data:')) return '';\n\tconst path = nameOrUrl.split(/[?#]/)[0] ?? '';\n\tconst base = path.slice(path.lastIndexOf('/') + 1);\n\tconst dot = base.lastIndexOf('.');\n\treturn dot > 0 ? base.slice(dot + 1).toLowerCase() : '';\n}\n\n/** The MIME type a `data:` URL declares (`''` for any other URL). */\nexport function dataUrlType(url: string | undefined): string {\n\tconst match = /^data:([^;,]*)/i.exec(url ?? '');\n\treturn normaliseMimeType(match?.[1]);\n}\n\n/**\n * The last segment of a URL's path, decoded: `'report.pdf'` for\n * `'https://x/files/report.pdf?token=1'`; `''` for a `data:` or `blob:` URL\n * or a path ending in `/`.\n */\nexport function fileNameFromUrl(url: string | undefined): string {\n\tif (!url || /^(data|blob):/i.test(url)) return '';\n\tconst path = url.split(/[?#]/)[0] ?? '';\n\tconst segment = path.slice(path.lastIndexOf('/') + 1);\n\ttry {\n\t\treturn decodeURIComponent(segment);\n\t} catch {\n\t\treturn segment;\n\t}\n}\n\n/** What `fileKind` reads: the MIME type, and a name or URL for the extension. */\nexport type FileKindInput = {\n\ttype?: string;\n\tname?: string;\n\turl?: string;\n};\n\n/**\n * The kind of preview a file gets: from its MIME type (or a `data:` URL's)\n * when that names one, else from the extension of its name, then of its URL;\n * `'other'` when neither says.\n */\nexport function fileKind({ type, name, url }: FileKindInput): FileKind {\n\treturn (\n\t\tkindOfMimeType(type) ??\n\t\tkindOfMimeType(dataUrlType(url)) ??\n\t\tEXTENSION_KINDS[fileExtension(name)] ??\n\t\tEXTENSION_KINDS[fileExtension(url)] ??\n\t\t'other'\n\t);\n}\n\n/** Whether a kind is read as text (`text`, `json`, `csv`, `markdown`). */\nexport function isTextFileKind(kind: FileKind): boolean {\n\treturn TEXT_FILE_KINDS.includes(kind);\n}\n",
+    "/**\n * Which URLs `FilePreview` lets reach a link's `href` or a media element's\n * `src`. Pure: nothing runs at import.\n */\n\n/** `data:` types that may be previewed or downloaded. */\nconst DATA_TYPES =\n\t/^(image\\/[\\w.+-]+|video\\/[\\w.+-]+|audio\\/[\\w.+-]+|text\\/(plain|csv|markdown|x-markdown)|application\\/(json|pdf))$/;\n\n/** What the URL parser trims from the ends: control characters and spaces. */\n// biome-ignore lint/suspicious/noControlCharactersInRegex: control characters are what this trims\nconst ENDS = /^[\\u0000-\\u0020]+|[\\u0000-\\u0020]+$/g;\n\n/** What the URL parser removes anywhere, which could split a scheme. */\nconst TAB_OR_NEWLINE = /[\\t\\n\\r]/g;\n\nconst SCHEME = /^([a-z][a-z\\d+.-]*):/i;\n\n/**\n * `url` when it is safe to put in an `href` or a `src`, else `null`.\n *\n * Allowed: `http:` and `https:`, a relative URL (`/a.pdf`, `files/a.pdf`,\n * `//host/a.pdf`, `?q`, `#x`), `blob:`, and a `data:` URL of an image, a\n * video, an audio file, plain text, CSV, Markdown, JSON or a PDF. Refused:\n * `javascript:`, `vbscript:`, a `data:` URL of anything else (HTML, for\n * one), and every other scheme. What the browser ignores (spaces and\n * control characters at the ends, tabs and newlines anywhere) is removed\n * first, so it cannot hide a scheme.\n */\nexport function safePreviewUrl(url: string | null | undefined): string | null {\n\tif (url == null) return null;\n\tconst value = url.replace(ENDS, '').replace(TAB_OR_NEWLINE, '');\n\tif (!value) return null;\n\tconst scheme = SCHEME.exec(value)?.[1]?.toLowerCase();\n\tif (scheme === undefined) {\n\t\t// No scheme: relative, unless a colon comes before any `/`, `?` or\n\t\t// `#` (something the pattern does not take for a scheme, like `1x:`).\n\t\tconst head = value.split(/[/?#]/, 1)[0] ?? '';\n\t\treturn head.includes(':') ? null : value;\n\t}\n\tif (scheme === 'http' || scheme === 'https' || scheme === 'blob') {\n\t\treturn value;\n\t}\n\tif (scheme === 'data') {\n\t\tconst type = value.slice('data:'.length).split(/[;,]/, 1)[0]?.toLowerCase();\n\t\treturn type && DATA_TYPES.test(type) ? value : null;\n\t}\n\treturn null;\n}\n\n/** A file given as a URL that `safePreviewUrl` refused. */\nexport class FilePreviewUnsafeUrlError extends Error {\n\toverride name = 'FilePreviewUnsafeUrlError';\n\n\tconstructor() {\n\t\tsuper('Refused to preview a URL with an unsafe scheme');\n\t}\n}\n",
+    "import {\n\tdataUrlType,\n\ttype FileKind,\n\tfileKind,\n\tfileNameFromUrl,\n\tnormaliseMimeType,\n} from './file-kind';\nimport { safePreviewUrl } from './safe-url';\n\n/** What `FilePreview` previews: a `File` or `Blob`, or a URL. */\nexport type FilePreviewSource = Blob | string;\n\n/** A file as `FilePreview` sees it, before anything is read. */\nexport type DescribedFile = {\n\tkind: FileKind;\n\t/**\n\t * The given name, else the `File`'s, else the URL's last segment (none\n\t * for a URL `safePreviewUrl` refuses); may be `''`.\n\t */\n\tname: string;\n\t/** The given MIME type, else the `Blob`'s or the `data:` URL's; may be `''`. */\n\ttype: string;\n\t/** The size in bytes, known for a `Blob` only. */\n\tsize?: number;\n\t/** The `File` / `Blob` itself. */\n\tblob?: Blob;\n\t/** The URL, when the file was given as one. */\n\turl?: string;\n};\n\n/**\n * The kind, name, type and size of a file given as a `File` / `Blob` or a\n * URL, with `type` and `name` overriding what the file says. `null` for no\n * file. Reads nothing: a URL is not fetched.\n */\nexport function describeFile(\n\tfile: FilePreviewSource | null | undefined,\n\toptions: { type?: string; name?: string } = {},\n): DescribedFile | null {\n\tif (file == null || file === '') return null;\n\tif (typeof file === 'string') {\n\t\tconst name =\n\t\t\toptions.name ??\n\t\t\t(safePreviewUrl(file) === null ? '' : fileNameFromUrl(file));\n\t\tconst type = normaliseMimeType(options.type ?? dataUrlType(file));\n\t\treturn { kind: fileKind({ type, name, url: file }), name, type, url: file };\n\t}\n\tconst own = 'name' in file && typeof file.name === 'string' ? file.name : '';\n\tconst name = options.name ?? own;\n\tconst type = normaliseMimeType(options.type ?? file.type);\n\treturn {\n\t\tkind: fileKind({ type, name }),\n\t\tname,\n\t\ttype,\n\t\tsize: file.size,\n\t\tblob: file,\n\t};\n}\n",
+    "/**\n * A text file's beginning, read with a size cap, for `FilePreview`. Nothing\n * runs at import: `fetch` and `TextDecoder` are reached only when\n * `readTextPreview` is called.\n */\n\n/** How much of a text file `FilePreview` reads by default: 256 KB. */\nexport const TEXT_PREVIEW_MAX_BYTES = 256 * 1024;\n\n/** A text file's first bytes, decoded, and whether there was more. */\nexport type TextPreview = {\n\ttext: string;\n\t/** The file is longer than `maxBytes`; `text` is its beginning. */\n\ttruncated: boolean;\n};\n\n/** A URL that answered with an HTTP error. */\nexport class FilePreviewHttpError extends Error {\n\toverride name = 'FilePreviewHttpError';\n\treadonly status: number;\n\n\tconstructor(url: string, status: number) {\n\t\tsuper(`Could not read ${url}: HTTP ${status}`);\n\t\tthis.status = status;\n\t}\n}\n\n/**\n * A decoder for the `charset` of a `Content-Type`, when `TextDecoder` knows\n * it; else UTF-8.\n */\nfunction decoderFor(contentType: string | null | undefined): TextDecoder {\n\tconst charset = /;\\s*charset\\s*=\\s*\"?([^\";\\s]+)/i.exec(\n\t\tcontentType ?? '',\n\t)?.[1];\n\tif (charset) {\n\t\ttry {\n\t\t\treturn new TextDecoder(charset);\n\t\t} catch {\n\t\t\t// An encoding `TextDecoder` does not support: fall back to UTF-8.\n\t\t}\n\t}\n\treturn new TextDecoder();\n}\n\nfunction decode(\n\tbytes: Uint8Array,\n\ttruncated: boolean,\n\tcontentType: string | null | undefined,\n): string {\n\t// `stream: true` holds back a character cut in half by the cap, rather\n\t// than ending the text on U+FFFD.\n\treturn decoderFor(contentType).decode(bytes, { stream: truncated });\n}\n\nasync function readBlob(\n\tblob: Blob,\n\tmaxBytes: number,\n\tsignal: AbortSignal | undefined,\n\tcontentType: string | null | undefined,\n): Promise<TextPreview> {\n\tsignal?.throwIfAborted();\n\tconst truncated = blob.size > maxBytes;\n\tconst buffer = await blob.slice(0, maxBytes).arrayBuffer();\n\tsignal?.throwIfAborted();\n\treturn {\n\t\ttext: decode(new Uint8Array(buffer), truncated, contentType),\n\t\ttruncated,\n\t};\n}\n\nasync function readStream(\n\tbody: ReadableStream<Uint8Array>,\n\tmaxBytes: number,\n\tsignal: AbortSignal | undefined,\n\tcontentType: string | null,\n): Promise<TextPreview> {\n\tconst reader = body.getReader();\n\tconst chunks: Uint8Array[] = [];\n\tlet length = 0;\n\tlet truncated = false;\n\twhile (length <= maxBytes) {\n\t\tconst { done, value } = await reader.read();\n\t\tif (signal?.aborted) {\n\t\t\tawait reader.cancel().catch(() => {});\n\t\t\tsignal.throwIfAborted();\n\t\t}\n\t\tif (done) break;\n\t\tchunks.push(value);\n\t\tlength += value.length;\n\t}\n\tif (length > maxBytes) {\n\t\ttruncated = true;\n\t\tawait reader.cancel().catch(() => {});\n\t}\n\tconst bytes = new Uint8Array(Math.min(length, maxBytes));\n\tlet offset = 0;\n\tfor (const chunk of chunks) {\n\t\tif (offset >= bytes.length) break;\n\t\tconst part = chunk.subarray(0, bytes.length - offset);\n\t\tbytes.set(part, offset);\n\t\toffset += part.length;\n\t}\n\treturn { text: decode(bytes, truncated, contentType), truncated };\n}\n\n/**\n * The first `maxBytes` of a `Blob` / `File`, or of what a URL answers, as\n * text, decoded with the `charset` of the URL's `Content-Type` (or of the\n * `Blob`'s `type`) when `TextDecoder` supports it, else as UTF-8. A URL is\n * fetched, and stops downloading once past the cap; an HTTP error throws\n * `FilePreviewHttpError`. Pass `signal` to abort: the promise then rejects\n * with the signal's reason, also for a `Blob`.\n */\nexport async function readTextPreview(\n\tsource: Blob | string,\n\toptions: { maxBytes?: number; signal?: AbortSignal } = {},\n): Promise<TextPreview> {\n\tconst maxBytes = Math.max(0, options.maxBytes ?? TEXT_PREVIEW_MAX_BYTES);\n\tconst { signal } = options;\n\tif (typeof source !== 'string') {\n\t\treturn readBlob(source, maxBytes, signal, source.type);\n\t}\n\tconst response = await fetch(source, { signal });\n\tif (!response.ok) throw new FilePreviewHttpError(source, response.status);\n\tconst contentType = response.headers.get('content-type');\n\tif (!response.body) {\n\t\treturn readBlob(await response.blob(), maxBytes, signal, contentType);\n\t}\n\treturn readStream(response.body, maxBytes, signal, contentType);\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "AA628A1137F8DCB664756E2164756E21",
+  "names": []
+}

package/dist/file-preview/safe-url.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Which URLs `FilePreview` lets reach a link's `href` or a media element's
+ * `src`. Pure: nothing runs at import.
+ */
+/**
+ * `url` when it is safe to put in an `href` or a `src`, else `null`.
+ *
+ * Allowed: `http:` and `https:`, a relative URL (`/a.pdf`, `files/a.pdf`,
+ * `//host/a.pdf`, `?q`, `#x`), `blob:`, and a `data:` URL of an image, a
+ * video, an audio file, plain text, CSV, Markdown, JSON or a PDF. Refused:
+ * `javascript:`, `vbscript:`, a `data:` URL of anything else (HTML, for
+ * one), and every other scheme. What the browser ignores (spaces and
+ * control characters at the ends, tabs and newlines anywhere) is removed
+ * first, so it cannot hide a scheme.
+ */
+export declare function safePreviewUrl(url: string | null | undefined): string | null;
+/** A file given as a URL that `safePreviewUrl` refused. */
+export declare class FilePreviewUnsafeUrlError extends Error {
+    name: string;
+    constructor();
+}
+//# sourceMappingURL=safe-url.d.ts.map

package/dist/file-preview/safe-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-url.d.ts","sourceRoot":"","sources":["../../src/file-preview/safe-url.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAmB5E;AAED,2DAA2D;AAC3D,qBAAa,yBAA0B,SAAQ,KAAK;IAC1C,IAAI,SAA+B;;CAK5C"}

package/dist/file-preview/text-preview.d.ts

@@ -0,0 +1,32 @@
+/**
+ * A text file's beginning, read with a size cap, for `FilePreview`. Nothing
+ * runs at import: `fetch` and `TextDecoder` are reached only when
+ * `readTextPreview` is called.
+ */
+/** How much of a text file `FilePreview` reads by default: 256 KB. */
+export declare const TEXT_PREVIEW_MAX_BYTES: number;
+/** A text file's first bytes, decoded, and whether there was more. */
+export type TextPreview = {
+    text: string;
+    /** The file is longer than `maxBytes`; `text` is its beginning. */
+    truncated: boolean;
+};
+/** A URL that answered with an HTTP error. */
+export declare class FilePreviewHttpError extends Error {
+    name: string;
+    readonly status: number;
+    constructor(url: string, status: number);
+}
+/**
+ * The first `maxBytes` of a `Blob` / `File`, or of what a URL answers, as
+ * text, decoded with the `charset` of the URL's `Content-Type` (or of the
+ * `Blob`'s `type`) when `TextDecoder` supports it, else as UTF-8. A URL is
+ * fetched, and stops downloading once past the cap; an HTTP error throws
+ * `FilePreviewHttpError`. Pass `signal` to abort: the promise then rejects
+ * with the signal's reason, also for a `Blob`.
+ */
+export declare function readTextPreview(source: Blob | string, options?: {
+    maxBytes?: number;
+    signal?: AbortSignal;
+}): Promise<TextPreview>;
+//# sourceMappingURL=text-preview.d.ts.map

package/dist/file-preview/text-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-preview.d.ts","sourceRoot":"","sources":["../../src/file-preview/text-preview.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,sEAAsE;AACtE,eAAO,MAAM,sBAAsB,QAAa,CAAC;AAEjD,sEAAsE;AACtE,MAAM,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,SAAS,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,8CAA8C;AAC9C,qBAAa,oBAAqB,SAAQ,KAAK;IACrC,IAAI,SAA0B;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAIvC;AAiFD;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACpC,MAAM,EAAE,IAAI,GAAG,MAAM,EACrB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GACvD,OAAO,CAAC,WAAW,CAAC,CAatB"}