@iamsaroj/smart-ui 0.2.0

package/dist/lib/xlsx.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Dependency-free `.xlsx` (OOXML SpreadsheetML) writer.
+ *
+ * The library externalizes every runtime dependency and ships no CSS, so rather
+ * than pull a heavyweight spreadsheet package in for a single export button, we
+ * emit a minimal-yet-valid workbook by hand: a small set of OOXML parts packed
+ * into a ZIP using **stored** (uncompressed) entries. Strings are written as
+ * inline strings (`t="inlineStr"`) so no shared-strings table is needed, and
+ * finite numbers are written as numeric cells so Excel treats them as numbers.
+ *
+ * This is intentionally tiny — it covers a single worksheet with a header row,
+ * which is exactly what a data-grid export needs. It is **not** a general
+ * spreadsheet library.
+ *
+ * Exports are styled by default (see {@link XlsxTheme}): a colored header row
+ * with bold text and filter dropdowns, zebra-striped data rows, a frozen
+ * header, and auto-fit column widths — all emitted through a hand-written
+ * `xl/styles.xml`, still with zero dependencies. Pass `theme: "plain"` for
+ * bare cells.
+ *
+ * **Performance contract:** the build is synchronous on the main thread.
+ * Measured on V8 (Node 22, Chromium-class engine, 2026-07): 10k cells ≈ 30 ms,
+ * **50k cells ≈ 135 ms**, 100k cells ≈ 450 ms, 200k cells ≈ 1 s. Exports up to
+ * ~50k cells are comfortable; beyond ~100k cells the UI freeze becomes
+ * noticeable — at that scale, call {@link buildXlsx} (it is pure and
+ * environment-agnostic) from a Web Worker and hand the resulting bytes back for
+ * download instead of using {@link downloadXlsx} directly.
+ */
+/** A value that can be written to a worksheet cell. */
+export type XlsxCell = string | number | boolean | null | undefined;
+/**
+ * Visual treatment for the workbook. All fields optional — the defaults give
+ * exports a polished look out of the box (indigo header with bold white text,
+ * zebra-striped rows, frozen header with filter dropdowns, auto-fit columns).
+ */
+export interface XlsxTheme {
+    /** Header row fill, hex RGB (`"4F46E5"` or `"#4F46E5"`). */
+    headerFill?: string;
+    /** Header text color, hex RGB. Default white. */
+    headerText?: string;
+    /** Fill for every second data row, hex RGB; `false` disables striping. */
+    stripe?: string | false;
+    /** Keep the header row visible while scrolling. Default `true`. */
+    freezeHeader?: boolean;
+    /** Filter dropdowns on the header row. Default `true`. */
+    autoFilter?: boolean;
+    /** Fit column widths to their longest content. Default `true`. */
+    autoWidth?: boolean;
+}
+/** One worksheet's worth of tabular data. */
+export interface XlsxSheet {
+    /** Worksheet tab name. Default `"Sheet1"`. */
+    name?: string;
+    /** The header row. */
+    headers: string[];
+    /** Body rows, each aligned to `headers`. */
+    rows: XlsxCell[][];
+    /**
+     * Styling. Omit for the themed default look, override individual
+     * {@link XlsxTheme} fields, or pass `"plain"` for bare unstyled cells.
+     */
+    theme?: XlsxTheme | "plain";
+}
+/**
+ * Build a single-worksheet `.xlsx` workbook as raw bytes. Pure and
+ * environment-agnostic — call {@link downloadXlsx} to also trigger a download.
+ */
+export declare const buildXlsx: (sheet: XlsxSheet) => Uint8Array;
+/**
+ * Timestamp suffix for an export filename, e.g. `2025-06-25-4-18-07-005`
+ * (`year-month-day-hour-minute-second-millisecond`). The hour is not
+ * zero-padded, matching the requested format.
+ */
+export declare const timestampForFilename: (date?: Date) => string;
+/**
+ * Build a `.xlsx` workbook and trigger a browser download. `fileName` may omit
+ * the `.xlsx` extension (it is appended when missing). No-op outside a DOM.
+ */
+export declare const downloadXlsx: (fileName: string, sheet: XlsxSheet) => void;
+//# sourceMappingURL=xlsx.d.ts.map

package/dist/lib/xlsx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xlsx.d.ts","sourceRoot":"","sources":["../../src/lib/xlsx.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,uDAAuD;AACvD,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAA;AAEnE;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IACvB,mEAAmE;IACnE,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,kEAAkE;IAClE,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,6CAA6C;AAC7C,MAAM,WAAW,SAAS;IACxB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,sBAAsB;IACtB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,4CAA4C;IAC5C,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAA;IAClB;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,CAAA;CAC5B;AA6WD;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,SAAS,KAAG,UAqB5C,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,OAAM,IAAiB,KAAG,MAY9D,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,UAAU,MAAM,EAAE,OAAO,SAAS,KAAG,IAsBjE,CAAA"}

package/dist/lib/xlsx.js

@@ -0,0 +1,377 @@
+/**
+ * Dependency-free `.xlsx` (OOXML SpreadsheetML) writer.
+ *
+ * The library externalizes every runtime dependency and ships no CSS, so rather
+ * than pull a heavyweight spreadsheet package in for a single export button, we
+ * emit a minimal-yet-valid workbook by hand: a small set of OOXML parts packed
+ * into a ZIP using **stored** (uncompressed) entries. Strings are written as
+ * inline strings (`t="inlineStr"`) so no shared-strings table is needed, and
+ * finite numbers are written as numeric cells so Excel treats them as numbers.
+ *
+ * This is intentionally tiny — it covers a single worksheet with a header row,
+ * which is exactly what a data-grid export needs. It is **not** a general
+ * spreadsheet library.
+ *
+ * Exports are styled by default (see {@link XlsxTheme}): a colored header row
+ * with bold text and filter dropdowns, zebra-striped data rows, a frozen
+ * header, and auto-fit column widths — all emitted through a hand-written
+ * `xl/styles.xml`, still with zero dependencies. Pass `theme: "plain"` for
+ * bare cells.
+ *
+ * **Performance contract:** the build is synchronous on the main thread.
+ * Measured on V8 (Node 22, Chromium-class engine, 2026-07): 10k cells ≈ 30 ms,
+ * **50k cells ≈ 135 ms**, 100k cells ≈ 450 ms, 200k cells ≈ 1 s. Exports up to
+ * ~50k cells are comfortable; beyond ~100k cells the UI freeze becomes
+ * noticeable — at that scale, call {@link buildXlsx} (it is pure and
+ * environment-agnostic) from a Web Worker and hand the resulting bytes back for
+ * download instead of using {@link downloadXlsx} directly.
+ */
+/* --------------------------------- CRC-32 --------------------------------- */
+const CRC_TABLE = /* @__PURE__ */ (() => {
+    const table = new Uint32Array(256);
+    for (let n = 0; n < 256; n += 1) {
+        let c = n;
+        for (let k = 0; k < 8; k += 1) {
+            c = (c & 1) !== 0 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
+        }
+        table[n] = c >>> 0;
+    }
+    return table;
+})();
+const crc32 = (bytes) => {
+    let crc = 0xffffffff;
+    for (let i = 0; i < bytes.length; i += 1) {
+        crc = CRC_TABLE[(crc ^ bytes[i]) & 0xff] ^ (crc >>> 8);
+    }
+    return (crc ^ 0xffffffff) >>> 0;
+};
+const pushU16 = (out, value) => {
+    out.push(value & 0xff, (value >>> 8) & 0xff);
+};
+const pushU32 = (out, value) => {
+    out.push(value & 0xff, (value >>> 8) & 0xff, (value >>> 16) & 0xff, (value >>> 24) & 0xff);
+};
+const pushBytes = (out, bytes) => {
+    for (let i = 0; i < bytes.length; i += 1)
+        out.push(bytes[i]);
+};
+/** Pack entries into a ZIP archive using stored (method 0 / no compression) entries. */
+const zipStore = (entries) => {
+    const encoder = new TextEncoder();
+    const local = [];
+    const records = [];
+    for (const entry of entries) {
+        const nameBytes = encoder.encode(entry.name);
+        const crc = crc32(entry.data);
+        const offset = local.length;
+        pushU32(local, 0x04034b50); // local file header signature
+        pushU16(local, 20); // version needed to extract
+        pushU16(local, 0); // general purpose flags
+        pushU16(local, 0); // compression method (0 = stored)
+        pushU16(local, 0); // last mod time
+        pushU16(local, 0); // last mod date
+        pushU32(local, crc);
+        pushU32(local, entry.data.length); // compressed size
+        pushU32(local, entry.data.length); // uncompressed size
+        pushU16(local, nameBytes.length);
+        pushU16(local, 0); // extra field length
+        pushBytes(local, nameBytes);
+        pushBytes(local, entry.data);
+        records.push({ nameBytes, crc, size: entry.data.length, offset });
+    }
+    const centralOffset = local.length;
+    const central = [];
+    for (const record of records) {
+        pushU32(central, 0x02014b50); // central directory header signature
+        pushU16(central, 20); // version made by
+        pushU16(central, 20); // version needed to extract
+        pushU16(central, 0); // general purpose flags
+        pushU16(central, 0); // compression method
+        pushU16(central, 0); // last mod time
+        pushU16(central, 0); // last mod date
+        pushU32(central, record.crc);
+        pushU32(central, record.size); // compressed size
+        pushU32(central, record.size); // uncompressed size
+        pushU16(central, record.nameBytes.length);
+        pushU16(central, 0); // extra field length
+        pushU16(central, 0); // file comment length
+        pushU16(central, 0); // disk number start
+        pushU16(central, 0); // internal file attributes
+        pushU32(central, 0); // external file attributes
+        pushU32(central, record.offset); // relative offset of local header
+        pushBytes(central, record.nameBytes);
+    }
+    const eocd = [];
+    pushU32(eocd, 0x06054b50); // end of central directory signature
+    pushU16(eocd, 0); // number of this disk
+    pushU16(eocd, 0); // disk where central directory starts
+    pushU16(eocd, records.length); // central directory records on this disk
+    pushU16(eocd, records.length); // total central directory records
+    pushU32(eocd, central.length); // size of central directory
+    pushU32(eocd, centralOffset); // offset of central directory
+    pushU16(eocd, 0); // comment length
+    return Uint8Array.from(local.concat(central, eocd));
+};
+/* --------------------------------- OOXML ---------------------------------- */
+const XML_DECLARATION = '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>';
+/**
+ * Drop characters that are illegal in XML 1.0 (control chars below `0x20` other
+ * than tab, LF and CR) so a stray control byte in the data can never corrupt the
+ * workbook. Implemented as a char-code scan to avoid a control-char regex.
+ */
+const stripIllegalXmlChars = (value) => {
+    let out = "";
+    for (let i = 0; i < value.length; i += 1) {
+        const code = value.charCodeAt(i);
+        if (code < 0x20 && code !== 0x09 && code !== 0x0a && code !== 0x0d)
+            continue;
+        out += value[i];
+    }
+    return out;
+};
+const escapeXml = (value) => stripIllegalXmlChars(value)
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;");
+/** 0 → `A`, 25 → `Z`, 26 → `AA`, … (spreadsheet column letters). */
+const columnName = (index) => {
+    let n = index;
+    let name = "";
+    do {
+        name = String.fromCharCode(65 + (n % 26)) + name;
+        n = Math.floor(n / 26) - 1;
+    } while (n >= 0);
+    return name;
+};
+/** `"#4f46e5"` / `"4F46E5"` → OOXML ARGB `"FF4F46E5"`; invalid input → fallback. */
+const toArgb = (color, fallback) => {
+    const hex = (color ?? "").replace(/^#/, "").toUpperCase();
+    return /^[0-9A-F]{6}$/.test(hex) ? `FF${hex}` : `FF${fallback}`;
+};
+/** Darken an ARGB color (used for the header's bottom accent border). */
+const darkenArgb = (argb, factor = 0.72) => {
+    let out = "FF";
+    for (let i = 2; i < 8; i += 2) {
+        const channel = Math.round(parseInt(argb.slice(i, i + 2), 16) * factor);
+        out += channel.toString(16).padStart(2, "0").toUpperCase();
+    }
+    return out;
+};
+const resolveTheme = (theme) => {
+    if (theme === "plain") {
+        return {
+            headerFill: "",
+            headerText: "",
+            stripe: false,
+            freezeHeader: false,
+            autoFilter: false,
+            autoWidth: false,
+            styled: false,
+        };
+    }
+    return {
+        headerFill: toArgb(theme?.headerFill, "4F46E5"), // indigo-600
+        headerText: toArgb(theme?.headerText, "FFFFFF"),
+        stripe: theme?.stripe === false ? false : toArgb(theme?.stripe, "F1F5F9"), // slate-100
+        freezeHeader: theme?.freezeHeader ?? true,
+        autoFilter: theme?.autoFilter ?? true,
+        autoWidth: theme?.autoWidth ?? true,
+        styled: true,
+    };
+};
+/**
+ * Cell style indices into `cellXfs` in {@link stylesXml}. Order matters — keep
+ * the two lists in sync.
+ */
+const STYLE_HEADER = 1;
+const STYLE_STRIPE = 2;
+const stylesXml = (theme) => XML_DECLARATION +
+    '<styleSheet xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main">' +
+    '<fonts count="2">' +
+    '<font><sz val="11"/><name val="Calibri"/></font>' +
+    `<font><b/><sz val="11"/><color rgb="${theme.headerText}"/><name val="Calibri"/></font>` +
+    "</fonts>" +
+    // Fill indices 0 (none) and 1 (gray125) are reserved by the spec.
+    '<fills count="4">' +
+    '<fill><patternFill patternType="none"/></fill>' +
+    '<fill><patternFill patternType="gray125"/></fill>' +
+    `<fill><patternFill patternType="solid"><fgColor rgb="${theme.headerFill}"/><bgColor indexed="64"/></patternFill></fill>` +
+    `<fill><patternFill patternType="solid"><fgColor rgb="${theme.stripe === false ? "FFF1F5F9" : theme.stripe}"/><bgColor indexed="64"/></patternFill></fill>` +
+    "</fills>" +
+    '<borders count="2">' +
+    "<border><left/><right/><top/><bottom/><diagonal/></border>" +
+    `<border><left/><right/><top/><bottom style="thin"><color rgb="${darkenArgb(theme.headerFill)}"/></bottom><diagonal/></border>` +
+    "</borders>" +
+    '<cellStyleXfs count="1"><xf numFmtId="0" fontId="0" fillId="0" borderId="0"/></cellStyleXfs>' +
+    '<cellXfs count="3">' +
+    '<xf numFmtId="0" fontId="0" fillId="0" borderId="0" xfId="0"/>' +
+    // STYLE_HEADER
+    '<xf numFmtId="0" fontId="1" fillId="2" borderId="1" xfId="0" applyFont="1" applyFill="1" applyBorder="1" applyAlignment="1"><alignment vertical="center"/></xf>' +
+    // STYLE_STRIPE
+    '<xf numFmtId="0" fontId="0" fillId="3" borderId="0" xfId="0" applyFill="1"/>' +
+    "</cellXfs>" +
+    "</styleSheet>";
+/**
+ * Approximate Excel column widths (in characters) from the longest content in
+ * each column. Scans at most the first 1,000 rows so huge exports don't pay
+ * for a second full pass.
+ */
+const columnWidths = (sheet) => {
+    const widths = sheet.headers.map((header) => header.length);
+    const sample = sheet.rows.slice(0, 1000);
+    for (const row of sample) {
+        row.forEach((value, index) => {
+            if (value == null)
+                return;
+            const length = String(value).length;
+            if (length > (widths[index] ?? 0))
+                widths[index] = length;
+        });
+    }
+    // +3 leaves room for the header's filter dropdown arrow.
+    return widths.map((w) => Math.min(Math.max(w + 3, 10), 60));
+};
+const cellXml = (ref, value, styleId) => {
+    const s = styleId > 0 ? ` s="${styleId}"` : "";
+    if (value == null || value === "")
+        return `<c r="${ref}"${s}/>`;
+    if (typeof value === "number" && Number.isFinite(value))
+        return `<c r="${ref}"${s}><v>${value}</v></c>`;
+    if (typeof value === "boolean")
+        return `<c r="${ref}"${s} t="b"><v>${value ? 1 : 0}</v></c>`;
+    return `<c r="${ref}"${s} t="inlineStr"><is><t xml:space="preserve">${escapeXml(String(value))}</t></is></c>`;
+};
+const rowXml = (rowNumber, cells, styleId, height) => {
+    const body = cells
+        .map((value, col) => cellXml(`${columnName(col)}${rowNumber}`, value, styleId))
+        .join("");
+    const ht = height != null ? ` ht="${height}" customHeight="1"` : "";
+    return `<row r="${rowNumber}"${ht}>${body}</row>`;
+};
+const sheetXml = (sheet, theme) => {
+    const rows = [
+        rowXml(1, sheet.headers, theme.styled ? STYLE_HEADER : 0, theme.styled ? 22 : undefined),
+    ];
+    sheet.rows.forEach((row, index) => {
+        // Stripe every second data row (data starts on row 2 → stripe 3, 5, 7…).
+        const striped = theme.styled && theme.stripe !== false && index % 2 === 1;
+        rows.push(rowXml(index + 2, row, striped ? STYLE_STRIPE : 0));
+    });
+    const lastColumn = columnName(Math.max(sheet.headers.length - 1, 0));
+    const lastRow = sheet.rows.length + 1;
+    const sheetViews = theme.freezeHeader
+        ? '<sheetViews><sheetView workbookViewId="0"><pane ySplit="1" topLeftCell="A2" activePane="bottomLeft" state="frozen"/></sheetView></sheetViews>'
+        : "";
+    const cols = theme.autoWidth
+        ? `<cols>${columnWidths(sheet)
+            .map((width, index) => `<col min="${index + 1}" max="${index + 1}" width="${width}" customWidth="1"/>`)
+            .join("")}</cols>`
+        : "";
+    const autoFilter = theme.autoFilter && sheet.headers.length > 0
+        ? `<autoFilter ref="A1:${lastColumn}${lastRow}"/>`
+        : "";
+    return (XML_DECLARATION +
+        '<worksheet xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main">' +
+        sheetViews +
+        cols +
+        `<sheetData>${rows.join("")}</sheetData>` +
+        autoFilter +
+        "</worksheet>");
+};
+const contentTypesXml = () => XML_DECLARATION +
+    '<Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types">' +
+    '<Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/>' +
+    '<Default Extension="xml" ContentType="application/xml"/>' +
+    '<Override PartName="/xl/workbook.xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.main+xml"/>' +
+    '<Override PartName="/xl/worksheets/sheet1.xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.worksheet+xml"/>' +
+    '<Override PartName="/xl/styles.xml" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.styles+xml"/>' +
+    "</Types>";
+const rootRelsXml = () => XML_DECLARATION +
+    '<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">' +
+    '<Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument" Target="xl/workbook.xml"/>' +
+    "</Relationships>";
+const workbookXml = (sheetName) => XML_DECLARATION +
+    '<workbook xmlns="http://schemas.openxmlformats.org/spreadsheetml/2006/main" ' +
+    'xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships">' +
+    `<sheets><sheet name="${escapeXml(sheetName)}" sheetId="1" r:id="rId1"/></sheets>` +
+    "</workbook>";
+const workbookRelsXml = () => XML_DECLARATION +
+    '<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">' +
+    '<Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet" Target="worksheets/sheet1.xml"/>' +
+    '<Relationship Id="rId2" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles" Target="styles.xml"/>' +
+    "</Relationships>";
+/** Excel worksheet names cannot exceed 31 chars or contain `\ / ? * [ ] :`. */
+const sanitizeSheetName = (name) => {
+    const cleaned = (name ?? "").replace(/[\\/?*[\]:]/g, " ").trim();
+    return cleaned.length > 0 ? cleaned.slice(0, 31) : "Sheet1";
+};
+/**
+ * Build a single-worksheet `.xlsx` workbook as raw bytes. Pure and
+ * environment-agnostic — call {@link downloadXlsx} to also trigger a download.
+ */
+export const buildXlsx = (sheet) => {
+    const theme = resolveTheme(sheet.theme);
+    const encoder = new TextEncoder();
+    const entries = [
+        { name: "[Content_Types].xml", data: encoder.encode(contentTypesXml()) },
+        { name: "_rels/.rels", data: encoder.encode(rootRelsXml()) },
+        {
+            name: "xl/workbook.xml",
+            data: encoder.encode(workbookXml(sanitizeSheetName(sheet.name))),
+        },
+        {
+            name: "xl/_rels/workbook.xml.rels",
+            data: encoder.encode(workbookRelsXml()),
+        },
+        { name: "xl/styles.xml", data: encoder.encode(stylesXml(theme)) },
+        {
+            name: "xl/worksheets/sheet1.xml",
+            data: encoder.encode(sheetXml(sheet, theme)),
+        },
+    ];
+    return zipStore(entries);
+};
+/**
+ * Timestamp suffix for an export filename, e.g. `2025-06-25-4-18-07-005`
+ * (`year-month-day-hour-minute-second-millisecond`). The hour is not
+ * zero-padded, matching the requested format.
+ */
+export const timestampForFilename = (date = new Date()) => {
+    const pad = (value, length = 2) => String(value).padStart(length, "0");
+    return [
+        date.getFullYear(),
+        pad(date.getMonth() + 1),
+        pad(date.getDate()),
+        date.getHours(),
+        pad(date.getMinutes()),
+        pad(date.getSeconds()),
+        pad(date.getMilliseconds(), 3),
+    ].join("-");
+};
+/**
+ * Build a `.xlsx` workbook and trigger a browser download. `fileName` may omit
+ * the `.xlsx` extension (it is appended when missing). No-op outside a DOM.
+ */
+export const downloadXlsx = (fileName, sheet) => {
+    if (typeof document === "undefined" ||
+        typeof URL.createObjectURL !== "function")
+        return;
+    const bytes = buildXlsx(sheet);
+    // Copy into a concrete ArrayBuffer so the Blob part type is unambiguous.
+    const buffer = new ArrayBuffer(bytes.byteLength);
+    new Uint8Array(buffer).set(bytes);
+    const blob = new Blob([buffer], {
+        type: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    });
+    const url = URL.createObjectURL(blob);
+    const anchor = document.createElement("a");
+    anchor.href = url;
+    anchor.download = /\.xlsx$/i.test(fileName) ? fileName : `${fileName}.xlsx`;
+    document.body.appendChild(anchor);
+    anchor.click();
+    anchor.remove();
+    // Revoke on the next tick so the click has a chance to start the download.
+    setTimeout(() => URL.revokeObjectURL(url), 0);
+};
+//# sourceMappingURL=xlsx.js.map

package/dist/lib/xlsx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xlsx.js","sourceRoot":"","sources":["../../src/lib/xlsx.ts"],"names":[],"mappings":"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"}

package/dist/search-engine/build-query.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Query building for the search engine: collapse a raw form-state object (which
+ * carries a value for *every* field, most of them blank) down to only the
+ * meaningful filters, so the object handed to the API is clean.
+ *
+ *   { name: "", email: "a@b.com", role: null, status: [] }  →  { email: "a@b.com" }
+ */
+/**
+ * Whether a value carries no filter intent and should be dropped from the query.
+ *
+ * - `null` / `undefined` → empty
+ * - empty or whitespace-only string → empty
+ * - empty array → empty
+ * - `false` boolean → empty (a checkbox/switch filters only when *on*; an
+ *   explicit "no" filter should model its two states as a string/enum instead)
+ * - `Date` → never empty
+ * - object (e.g. a date range) → empty only when every own value is empty
+ * - numbers (incl. `0`) → never empty
+ */
+export declare const isEmptyValue: (value: unknown) => boolean;
+/**
+ * Prune a raw search-state object to only its meaningful values, trimming
+ * strings along the way. The result is a `Partial<T>` suitable for sending to an
+ * API or serializing into a URL — empty fields simply aren't present.
+ */
+export declare const buildSearchQuery: <T extends Record<string, unknown>>(data: T) => Partial<T>;
+/** Number of active (non-empty) filters in a raw search-state object. */
+export declare const countActiveFilters: (data: Record<string, unknown>) => number;
+//# sourceMappingURL=build-query.d.ts.map

package/dist/search-engine/build-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-query.d.ts","sourceRoot":"","sources":["../../src/search-engine/build-query.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,OAAO,KAAG,OAS7C,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,MAAM,CAAC,KACN,OAAO,CAAC,CAAC,CAOX,CAAA;AAED,yEAAyE;AACzE,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,MACvB,CAAA"}

package/dist/search-engine/build-query.js

@@ -0,0 +1,51 @@
+/**
+ * Query building for the search engine: collapse a raw form-state object (which
+ * carries a value for *every* field, most of them blank) down to only the
+ * meaningful filters, so the object handed to the API is clean.
+ *
+ *   { name: "", email: "a@b.com", role: null, status: [] }  →  { email: "a@b.com" }
+ */
+/**
+ * Whether a value carries no filter intent and should be dropped from the query.
+ *
+ * - `null` / `undefined` → empty
+ * - empty or whitespace-only string → empty
+ * - empty array → empty
+ * - `false` boolean → empty (a checkbox/switch filters only when *on*; an
+ *   explicit "no" filter should model its two states as a string/enum instead)
+ * - `Date` → never empty
+ * - object (e.g. a date range) → empty only when every own value is empty
+ * - numbers (incl. `0`) → never empty
+ */
+export const isEmptyValue = (value) => {
+    if (value == null)
+        return true;
+    if (typeof value === "string")
+        return value.trim() === "";
+    if (Array.isArray(value))
+        return value.length === 0;
+    if (typeof value === "boolean")
+        return !value;
+    if (value instanceof Date)
+        return false;
+    if (typeof value === "object")
+        return Object.values(value).every(isEmptyValue);
+    return false;
+};
+/**
+ * Prune a raw search-state object to only its meaningful values, trimming
+ * strings along the way. The result is a `Partial<T>` suitable for sending to an
+ * API or serializing into a URL — empty fields simply aren't present.
+ */
+export const buildSearchQuery = (data) => {
+    const out = {};
+    for (const [key, value] of Object.entries(data)) {
+        if (isEmptyValue(value))
+            continue;
+        out[key] = typeof value === "string" ? value.trim() : value;
+    }
+    return out;
+};
+/** Number of active (non-empty) filters in a raw search-state object. */
+export const countActiveFilters = (data) => Object.keys(buildSearchQuery(data)).length;
+//# sourceMappingURL=build-query.js.map

package/dist/search-engine/build-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-query.js","sourceRoot":"","sources":["../../src/search-engine/build-query.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAc,EAAW,EAAE;IACtD,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,IAAI,CAAA;IAC9B,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAA;IACzD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAA;IACnD,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,KAAK,CAAA;IAC7C,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,KAAK,CAAA;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAC3B,OAAO,MAAM,CAAC,MAAM,CAAC,KAAgC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;IAC5E,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,IAAO,EACK,EAAE;IACd,MAAM,GAAG,GAA4B,EAAE,CAAA;IACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,YAAY,CAAC,KAAK,CAAC;YAAE,SAAQ;QACjC,GAAG,CAAC,GAAG,CAAC,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAA;IAC7D,CAAC;IACD,OAAO,GAAiB,CAAA;AAC1B,CAAC,CAAA;AAED,yEAAyE;AACzE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAA6B,EAAU,EAAE,CAC1E,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAA"}

package/dist/search-engine/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `@iamsaroj/smart-ui/search-engine` — a reusable search / filter bar built on top of
+ * the form engine.
+ *
+ *   import { SmartSearchForm, type SearchFieldDefinition } from "@iamsaroj/smart-ui/search-engine"
+ *
+ * `SmartSearchForm` composes `SmartForm`: same declarative fields and Zod
+ * validation, plus manual/auto search, empty-value pruning, and an action bar.
+ * `SearchEngine` is an alias of the same component.
+ */
+export { SmartSearchForm, SearchEngine } from "./smart-search-form";
+export type { SmartSearchFormProps } from "./smart-search-form";
+export type { SearchFieldDefinition, SearchFieldType } from "./types";
+export { buildSearchQuery, countActiveFilters, isEmptyValue, } from "./build-query";
+//# sourceMappingURL=index.d.ts.map

package/dist/search-engine/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/search-engine/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACnE,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC/D,YAAY,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AACrE,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,GACb,MAAM,eAAe,CAAA"}

package/dist/search-engine/index.js

@@ -0,0 +1,13 @@
+/**
+ * `@iamsaroj/smart-ui/search-engine` — a reusable search / filter bar built on top of
+ * the form engine.
+ *
+ *   import { SmartSearchForm, type SearchFieldDefinition } from "@iamsaroj/smart-ui/search-engine"
+ *
+ * `SmartSearchForm` composes `SmartForm`: same declarative fields and Zod
+ * validation, plus manual/auto search, empty-value pruning, and an action bar.
+ * `SearchEngine` is an alias of the same component.
+ */
+export { SmartSearchForm, SearchEngine } from "./smart-search-form";
+export { buildSearchQuery, countActiveFilters, isEmptyValue, } from "./build-query";
+//# sourceMappingURL=index.js.map

package/dist/search-engine/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/search-engine/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAGnE,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,GACb,MAAM,eAAe,CAAA"}