@lichens-innovation/ts-common 1.7.0 → 1.9.0

package/dist/web.d.ts

@@ -0,0 +1,82 @@
+import { D as Dimensions } from './dimensions.utils-BwIBA5op.js';
+
+declare const getCurrentUrl: () => string;
+
+/**
+ * Converts a Blob to a data URI string.
+ */
+declare const blobToDataUri: (blob: Blob) => Promise<string | null>;
+/**
+ * Fetches a resource by URL and returns its content as a data URI.
+ * Content type is inferred from the response Content-Type header when possible.
+ */
+declare const fetchUrlAsDataUri: (url: string) => Promise<string | null>;
+
+declare const hasRechartsElements: (svg: SVGSVGElement) => boolean;
+declare const findRechartsSvg: (svgs: NodeListOf<SVGSVGElement> | SVGSVGElement[]) => SVGSVGElement | null;
+declare const getElement: (id: string) => HTMLElement | null;
+interface GetRechartsSvgFromElementArgs {
+    chartElement: HTMLElement;
+    chartElementId: string;
+}
+declare const getRechartsSvgFromElement: ({ chartElement, chartElementId, }: GetRechartsSvgFromElementArgs) => SVGSVGElement | null;
+declare const getSvgDimensions: (svgElement: SVGSVGElement) => Dimensions;
+interface PrepareSvgCloneArgs {
+    svgElement: SVGSVGElement;
+    dimensions: Dimensions;
+}
+/**
+ * Clones an SVG element and ensures it has the required width and height attributes.
+ *
+ * This function is necessary for two main reasons:
+ *
+ * 1. **Defensive cloning**: Cloning prevents modifying the original SVG element in the DOM.
+ *    Although `XMLSerializer.serializeToString()` does not modify the element, cloning ensures
+ *    that no accidental modifications are made to the source element.
+ *
+ * 2. **Required width/height attributes**: When converting SVG → PNG via `svgToPngDataUri`,
+ *    the HTML Image element requires the SVG to have explicit intrinsic dimensions.
+ *    Without width/height attributes, the SVG may not render correctly on the canvas,
+ *    resulting in an incorrect or empty PNG image.
+ *
+ * @param svgElement - The original SVG element to clone
+ * @param dimensions - The dimensions to apply to the cloned SVG if attributes are missing
+ * @returns A new cloned SVG element with guaranteed width/height attributes
+ */
+declare const prepareSvgClone: ({ svgElement, dimensions }: PrepareSvgCloneArgs) => SVGSVGElement;
+declare const convertSvgToDataUri: (svgXml: string) => string;
+interface ResizeSvgXmlArgs {
+    svgXml: string;
+    targetWidth: number;
+    targetHeight: number;
+}
+/**
+ * Modifies SVG XML to set the root <svg> width and height attributes.
+ * Used to resize the SVG before converting to PNG at target dimensions (e.g. from PDF layout).
+ */
+declare const resizeSvgXml: ({ svgXml, targetWidth, targetHeight }: ResizeSvgXmlArgs) => string;
+interface GetChartAsPngDataUriArgs {
+    chartElementId: string;
+    width: number;
+    height: number;
+}
+/**
+ * Gets the Recharts chart as a PNG data URI at the given dimensions (e.g. from PDF zone).
+ * Resizes the SVG via resizeSvgXml before conversion; does not use the SVG's intrinsic dimensions.
+ */
+declare const getChartAsPngDataUri: ({ chartElementId, width, height, }: GetChartAsPngDataUriArgs) => Promise<string | null>;
+/**
+ * Retrieves the SVG from a Recharts chart element and converts it to SVG base64
+ * @param chartElementId - The ID of the element containing the chart
+ * @returns The SVG encoded in base64 with data URI prefix (data:image/svg+xml;base64,...), or null if an error occurs
+ */
+declare const getSvgAsBase64DataUri: (chartElementId: string) => string | null;
+declare const getRechartSvgXml: (chartElementId: string) => string | null;
+interface SvgToPngArgs {
+    svgDataUri?: string | null;
+    dimensions: Dimensions;
+    backgroundColor?: string;
+}
+declare const svgToPngDataUri: ({ svgDataUri, dimensions, backgroundColor, }: SvgToPngArgs) => Promise<string | null>;
+
+export { type GetChartAsPngDataUriArgs, type GetRechartsSvgFromElementArgs, type PrepareSvgCloneArgs, type ResizeSvgXmlArgs, type SvgToPngArgs, blobToDataUri, convertSvgToDataUri, fetchUrlAsDataUri, findRechartsSvg, getChartAsPngDataUri, getCurrentUrl, getElement, getRechartSvgXml, getRechartsSvgFromElement, getSvgAsBase64DataUri, getSvgDimensions, hasRechartsElements, prepareSvgClone, resizeSvgXml, svgToPngDataUri };

package/dist/web.js

@@ -0,0 +1,219 @@
+// src/web/browser.utils.ts
+var getCurrentUrl = () => {
+  if (typeof window === "undefined") {
+    return "";
+  }
+  return window.location.href;
+};
+
+// src/utils/errors.utils.ts
+var getErrorMessage = (error) => {
+  if (!error) {
+    return "";
+  }
+  if (typeof error === "string") {
+    return error;
+  }
+  if (typeof error === "object" && "message" in error) {
+    return error.message;
+  }
+  return JSON.stringify(error);
+};
+
+// src/web/fetch.utils.ts
+var blobToDataUri = (blob) => {
+  return new Promise((resolve, reject) => {
+    const reader = new FileReader();
+    reader.onerror = () => reject(reader.error);
+    reader.onloadend = () => {
+      const { result } = reader;
+      resolve(typeof result === "string" ? result : null);
+    };
+    reader.readAsDataURL(blob);
+  });
+};
+var fetchUrlAsDataUri = async (url) => {
+  try {
+    const response = await fetch(url);
+    if (!response.ok) {
+      console.warn(`[fetchUrlAsDataUri] Response not ok (${response.status}). url: "${url}"`);
+      return null;
+    }
+    const blob = await response.blob();
+    return blobToDataUri(blob);
+  } catch (e) {
+    const message = getErrorMessage(e);
+    console.error(`[fetchUrlAsDataUri] "${message}". url: "${url}"`, e);
+    return null;
+  }
+};
+
+// src/web/image.utils.ts
+var hasRechartsElements = (svg) => {
+  return svg.querySelector("g.recharts-layer") !== null || svg.querySelector("g.recharts-cartesian-axis") !== null || svg.querySelector("g.recharts-cartesian-grid") !== null || svg.querySelector("path.recharts-curve") !== null;
+};
+var findRechartsSvg = (svgs) => {
+  for (const svg of Array.from(svgs)) {
+    if (hasRechartsElements(svg)) {
+      return svg;
+    }
+  }
+  return null;
+};
+var getElement = (id) => {
+  const element = document?.getElementById(id);
+  if (!element) {
+    console.info(`[getElement] Element with id "${id}" not found`);
+    return null;
+  }
+  return element;
+};
+var getRechartsSvgFromElement = ({
+  chartElement,
+  chartElementId
+}) => {
+  const allSvgs = chartElement.querySelectorAll("svg");
+  if (allSvgs.length === 0) {
+    console.info(`[getRechartsSvgFromElement] SVG element not found inside element with id "${chartElementId}"`);
+    return null;
+  }
+  const rechartSvg = findRechartsSvg(allSvgs);
+  if (!rechartSvg) {
+    console.info(`[getRechartsSvgFromElement] No Recharts SVG element found inside element with id "${chartElementId}"`);
+    return null;
+  }
+  return rechartSvg;
+};
+var getSvgDimensions = (svgElement) => {
+  const width = svgElement.clientWidth || parseInt(svgElement.getAttribute("width") || "800", 10);
+  const height = svgElement.clientHeight || parseInt(svgElement.getAttribute("height") || "600", 10);
+  return { width, height };
+};
+var prepareSvgClone = ({ svgElement, dimensions }) => {
+  const clonedSvg = svgElement.cloneNode(true);
+  if (!clonedSvg.hasAttribute("width")) {
+    clonedSvg.setAttribute("width", dimensions.width.toString());
+  }
+  if (!clonedSvg.hasAttribute("height")) {
+    clonedSvg.setAttribute("height", dimensions.height.toString());
+  }
+  return clonedSvg;
+};
+var convertSvgToDataUri = (svgXml) => {
+  const encoder = new TextEncoder();
+  const data = encoder.encode(svgXml);
+  let binaryString = "";
+  for (let i = 0; i < data.length; i++) {
+    binaryString += String.fromCharCode(data[i]);
+  }
+  const base64 = btoa(binaryString);
+  return `data:image/svg+xml;base64,${base64}`;
+};
+var resizeSvgXml = ({ svgXml, targetWidth, targetHeight }) => {
+  const widthAttr = `width="${targetWidth}"`;
+  const heightAttr = `height="${targetHeight}"`;
+  let result = svgXml.replace(/\bwidth=["'][^"']*["']/, widthAttr);
+  if (!/\bwidth\s*=/.test(result)) {
+    result = result.replace(/<svg/, `<svg ${widthAttr}`);
+  }
+  result = result.replace(/\bheight=["'][^"']*["']/, heightAttr);
+  if (!/\bheight\s*=/.test(result)) {
+    result = result.replace(/<svg/, `<svg ${heightAttr}`);
+  }
+  return result;
+};
+var getChartAsPngDataUri = async ({
+  chartElementId,
+  width,
+  height
+}) => {
+  if (!chartElementId) {
+    return null;
+  }
+  const chartElement = getElement(chartElementId);
+  if (!chartElement) {
+    return null;
+  }
+  const svgElement = getRechartsSvgFromElement({ chartElement, chartElementId });
+  if (!svgElement) {
+    return null;
+  }
+  const svgXml = new XMLSerializer().serializeToString(svgElement);
+  const resizedXml = resizeSvgXml({ svgXml, targetWidth: width, targetHeight: height });
+  const svgDataUri = convertSvgToDataUri(resizedXml);
+  return svgToPngDataUri({
+    svgDataUri,
+    dimensions: { width, height },
+    backgroundColor: "white"
+  });
+};
+var getSvgAsBase64DataUri = (chartElementId) => {
+  const svgXml = getRechartSvgXml(chartElementId);
+  if (!svgXml) {
+    return null;
+  }
+  return convertSvgToDataUri(svgXml);
+};
+var getRechartSvgXml = (chartElementId) => {
+  if (!chartElementId) {
+    console.info(`[getRechartSvgXml] No chart element id provided`);
+    return null;
+  }
+  const chartElement = getElement(chartElementId);
+  if (!chartElement) {
+    console.info(`[getRechartSvgXml] Element with id "${chartElementId}" not found`);
+    return null;
+  }
+  const svgElement = getRechartsSvgFromElement({ chartElement, chartElementId });
+  if (!svgElement) {
+    console.info(`[getRechartSvgXml] No SVG element found inside element with id "${chartElementId}"`);
+    return null;
+  }
+  const dimensions = getSvgDimensions(svgElement);
+  const clonedSvg = prepareSvgClone({ svgElement, dimensions });
+  const svgXml = new XMLSerializer().serializeToString(clonedSvg);
+  return svgXml;
+};
+var svgToPngDataUri = async ({
+  svgDataUri,
+  dimensions,
+  backgroundColor
+}) => {
+  if (!svgDataUri) {
+    return null;
+  }
+  const { width, height } = dimensions;
+  return new Promise((resolve, reject) => {
+    const img = new Image();
+    img.onload = () => {
+      try {
+        const canvas = document.createElement("canvas");
+        canvas.width = width;
+        canvas.height = height;
+        const ctx = canvas.getContext("2d");
+        if (!ctx) {
+          reject(new Error("Failed to get canvas 2D context"));
+          return;
+        }
+        if (backgroundColor) {
+          ctx.fillStyle = backgroundColor;
+          ctx.fillRect(0, 0, width, height);
+        }
+        ctx.drawImage(img, 0, 0, width, height);
+        const pngDataUri = canvas.toDataURL("image/png");
+        resolve(pngDataUri);
+      } catch (error) {
+        reject(error);
+      }
+    };
+    img.onerror = (error) => {
+      const message = getErrorMessage(error);
+      reject(new Error(`Failed to load SVG image: ${message}`));
+    };
+    img.src = svgDataUri;
+  });
+};
+
+export { blobToDataUri, convertSvgToDataUri, fetchUrlAsDataUri, findRechartsSvg, getChartAsPngDataUri, getCurrentUrl, getElement, getRechartSvgXml, getRechartsSvgFromElement, getSvgAsBase64DataUri, getSvgDimensions, hasRechartsElements, prepareSvgClone, resizeSvgXml, svgToPngDataUri };
+//# sourceMappingURL=web.js.map
+//# sourceMappingURL=web.js.map

package/dist/web.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/web/browser.utils.ts","../src/utils/errors.utils.ts","../src/web/fetch.utils.ts","../src/web/image.utils.ts"],"names":[],"mappings":"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","file":"web.js","sourcesContent":["export const getCurrentUrl = (): string => {\n  if (typeof window === \"undefined\") {\n    return \"\";\n  }\n\n  return window.location.href;\n};\n","export const getErrorMessage = (error: unknown): string => {\n  if (!error) {\n    return \"\";\n  }\n\n  if (typeof error === \"string\") {\n    return error;\n  }\n\n  if (typeof error === \"object\" && \"message\" in error) {\n    return (error as { message: string }).message;\n  }\n\n  return JSON.stringify(error);\n};\n","import { getErrorMessage } from \"../utils\";\n\n/**\n * Converts a Blob to a data URI string.\n */\nexport const blobToDataUri = (blob: Blob): Promise<string | null> => {\n  return new Promise((resolve, reject) => {\n    const reader = new FileReader();\n\n    reader.onerror = () => reject(reader.error);\n    reader.onloadend = () => {\n      const { result } = reader;\n      resolve(typeof result === \"string\" ? result : null);\n    };\n\n    reader.readAsDataURL(blob);\n  });\n};\n\n/**\n * Fetches a resource by URL and returns its content as a data URI.\n * Content type is inferred from the response Content-Type header when possible.\n */\nexport const fetchUrlAsDataUri = async (url: string): Promise<string | null> => {\n  try {\n    const response = await fetch(url);\n    if (!response.ok) {\n      console.warn(`[fetchUrlAsDataUri] Response not ok (${response.status}). url: \"${url}\"`);\n      return null;\n    }\n\n    const blob = await response.blob();\n    return blobToDataUri(blob);\n  } catch (e: unknown) {\n    const message = getErrorMessage(e);\n    console.error(`[fetchUrlAsDataUri] \"${message}\". url: \"${url}\"`, e);\n    return null;\n  }\n};\n","import { getErrorMessage, type Dimensions } from \"../utils\";\n\nexport const hasRechartsElements = (svg: SVGSVGElement): boolean => {\n  return (\n    svg.querySelector(\"g.recharts-layer\") !== null ||\n    svg.querySelector(\"g.recharts-cartesian-axis\") !== null ||\n    svg.querySelector(\"g.recharts-cartesian-grid\") !== null ||\n    svg.querySelector(\"path.recharts-curve\") !== null\n  );\n};\n\nexport const findRechartsSvg = (svgs: NodeListOf<SVGSVGElement> | SVGSVGElement[]): SVGSVGElement | null => {\n  for (const svg of Array.from(svgs)) {\n    if (hasRechartsElements(svg)) {\n      return svg;\n    }\n  }\n\n  return null;\n};\n\nexport const getElement = (id: string): HTMLElement | null => {\n  const element = document?.getElementById(id);\n  if (!element) {\n    console.info(`[getElement] Element with id \"${id}\" not found`);\n    return null;\n  }\n\n  return element;\n};\n\nexport interface GetRechartsSvgFromElementArgs {\n  chartElement: HTMLElement;\n  chartElementId: string;\n}\n\nexport const getRechartsSvgFromElement = ({\n  chartElement,\n  chartElementId,\n}: GetRechartsSvgFromElementArgs): SVGSVGElement | null => {\n  const allSvgs = chartElement.querySelectorAll<SVGSVGElement>(\"svg\");\n  if (allSvgs.length === 0) {\n    console.info(`[getRechartsSvgFromElement] SVG element not found inside element with id \"${chartElementId}\"`);\n    return null;\n  }\n\n  const rechartSvg = findRechartsSvg(allSvgs);\n  if (!rechartSvg) {\n    console.info(`[getRechartsSvgFromElement] No Recharts SVG element found inside element with id \"${chartElementId}\"`);\n    return null;\n  }\n\n  return rechartSvg;\n};\n\nexport const getSvgDimensions = (svgElement: SVGSVGElement): Dimensions => {\n  const width = svgElement.clientWidth || parseInt(svgElement.getAttribute(\"width\") || \"800\", 10);\n  const height = svgElement.clientHeight || parseInt(svgElement.getAttribute(\"height\") || \"600\", 10);\n  return { width, height };\n};\n\nexport interface PrepareSvgCloneArgs {\n  svgElement: SVGSVGElement;\n  dimensions: Dimensions;\n}\n\n/**\n * Clones an SVG element and ensures it has the required width and height attributes.\n *\n * This function is necessary for two main reasons:\n *\n * 1. **Defensive cloning**: Cloning prevents modifying the original SVG element in the DOM.\n *    Although `XMLSerializer.serializeToString()` does not modify the element, cloning ensures\n *    that no accidental modifications are made to the source element.\n *\n * 2. **Required width/height attributes**: When converting SVG → PNG via `svgToPngDataUri`,\n *    the HTML Image element requires the SVG to have explicit intrinsic dimensions.\n *    Without width/height attributes, the SVG may not render correctly on the canvas,\n *    resulting in an incorrect or empty PNG image.\n *\n * @param svgElement - The original SVG element to clone\n * @param dimensions - The dimensions to apply to the cloned SVG if attributes are missing\n * @returns A new cloned SVG element with guaranteed width/height attributes\n */\nexport const prepareSvgClone = ({ svgElement, dimensions }: PrepareSvgCloneArgs): SVGSVGElement => {\n  const clonedSvg = svgElement.cloneNode(true) as SVGSVGElement;\n\n  if (!clonedSvg.hasAttribute(\"width\")) {\n    clonedSvg.setAttribute(\"width\", dimensions.width.toString());\n  }\n  if (!clonedSvg.hasAttribute(\"height\")) {\n    clonedSvg.setAttribute(\"height\", dimensions.height.toString());\n  }\n\n  return clonedSvg;\n};\n\nexport const convertSvgToDataUri = (svgXml: string): string => {\n  const encoder = new TextEncoder();\n  const data = encoder.encode(svgXml);\n  let binaryString = \"\";\n  for (let i = 0; i < data.length; i++) {\n    binaryString += String.fromCharCode(data[i]);\n  }\n  const base64 = btoa(binaryString);\n  return `data:image/svg+xml;base64,${base64}`;\n};\n\nexport interface ResizeSvgXmlArgs {\n  svgXml: string;\n  targetWidth: number;\n  targetHeight: number;\n}\n\n/**\n * Modifies SVG XML to set the root <svg> width and height attributes.\n * Used to resize the SVG before converting to PNG at target dimensions (e.g. from PDF layout).\n */\nexport const resizeSvgXml = ({ svgXml, targetWidth, targetHeight }: ResizeSvgXmlArgs): string => {\n  const widthAttr = `width=\"${targetWidth}\"`;\n  const heightAttr = `height=\"${targetHeight}\"`;\n\n  let result = svgXml.replace(/\\bwidth=[\"'][^\"']*[\"']/, widthAttr);\n  if (!/\\bwidth\\s*=/.test(result)) {\n    result = result.replace(/<svg/, `<svg ${widthAttr}`);\n  }\n\n  result = result.replace(/\\bheight=[\"'][^\"']*[\"']/, heightAttr);\n  if (!/\\bheight\\s*=/.test(result)) {\n    result = result.replace(/<svg/, `<svg ${heightAttr}`);\n  }\n\n  return result;\n};\n\nexport interface GetChartAsPngDataUriArgs {\n  chartElementId: string;\n  width: number;\n  height: number;\n}\n\n/**\n * Gets the Recharts chart as a PNG data URI at the given dimensions (e.g. from PDF zone).\n * Resizes the SVG via resizeSvgXml before conversion; does not use the SVG's intrinsic dimensions.\n */\nexport const getChartAsPngDataUri = async ({\n  chartElementId,\n  width,\n  height,\n}: GetChartAsPngDataUriArgs): Promise<string | null> => {\n  if (!chartElementId) {\n    return null;\n  }\n\n  const chartElement: HTMLElement | null = getElement(chartElementId);\n  if (!chartElement) {\n    return null;\n  }\n\n  const svgElement: SVGSVGElement | null = getRechartsSvgFromElement({ chartElement, chartElementId });\n  if (!svgElement) {\n    return null;\n  }\n\n  const svgXml: string = new XMLSerializer().serializeToString(svgElement);\n  const resizedXml: string = resizeSvgXml({ svgXml, targetWidth: width, targetHeight: height });\n  const svgDataUri: string = convertSvgToDataUri(resizedXml);\n\n  return svgToPngDataUri({\n    svgDataUri,\n    dimensions: { width, height },\n    backgroundColor: \"white\",\n  });\n};\n\n/**\n * Retrieves the SVG from a Recharts chart element and converts it to SVG base64\n * @param chartElementId - The ID of the element containing the chart\n * @returns The SVG encoded in base64 with data URI prefix (data:image/svg+xml;base64,...), or null if an error occurs\n */\nexport const getSvgAsBase64DataUri = (chartElementId: string): string | null => {\n  const svgXml = getRechartSvgXml(chartElementId);\n  if (!svgXml) {\n    return null;\n  }\n\n  return convertSvgToDataUri(svgXml);\n};\n\nexport const getRechartSvgXml = (chartElementId: string): string | null => {\n  if (!chartElementId) {\n    console.info(`[getRechartSvgXml] No chart element id provided`);\n    return null;\n  }\n\n  const chartElement: HTMLElement | null = getElement(chartElementId);\n  if (!chartElement) {\n    console.info(`[getRechartSvgXml] Element with id \"${chartElementId}\" not found`);\n    return null;\n  }\n\n  const svgElement: SVGSVGElement | null = getRechartsSvgFromElement({ chartElement, chartElementId });\n  if (!svgElement) {\n    console.info(`[getRechartSvgXml] No SVG element found inside element with id \"${chartElementId}\"`);\n    return null;\n  }\n\n  const dimensions = getSvgDimensions(svgElement);\n  const clonedSvg: SVGSVGElement = prepareSvgClone({ svgElement, dimensions });\n  const svgXml: string = new XMLSerializer().serializeToString(clonedSvg);\n\n  return svgXml;\n};\n\nexport interface SvgToPngArgs {\n  svgDataUri?: string | null;\n  dimensions: Dimensions;\n  backgroundColor?: string;\n}\n\nexport const svgToPngDataUri = async ({\n  svgDataUri,\n  dimensions,\n  backgroundColor,\n}: SvgToPngArgs): Promise<string | null> => {\n  if (!svgDataUri) {\n    return null;\n  }\n\n  const { width, height } = dimensions;\n\n  return new Promise((resolve, reject) => {\n    const img = new Image();\n\n    img.onload = () => {\n      try {\n        const canvas = document.createElement(\"canvas\");\n        canvas.width = width;\n        canvas.height = height;\n\n        const ctx = canvas.getContext(\"2d\");\n        if (!ctx) {\n          reject(new Error(\"Failed to get canvas 2D context\"));\n          return;\n        }\n\n        if (backgroundColor) {\n          ctx.fillStyle = backgroundColor;\n          ctx.fillRect(0, 0, width, height);\n        }\n\n        ctx.drawImage(img, 0, 0, width, height);\n        const pngDataUri = canvas.toDataURL(\"image/png\");\n        resolve(pngDataUri);\n      } catch (error) {\n        reject(error);\n      }\n    };\n\n    img.onerror = (error) => {\n      const message = getErrorMessage(error);\n      reject(new Error(`Failed to load SVG image: ${message}`));\n    };\n\n    img.src = svgDataUri;\n  });\n};\n"]}

package/package.json

@@ -1,14 +1,8 @@
 {
   "name": "@lichens-innovation/ts-common",
-  "version": "1.7.0",
+  "version": "1.9.0",
   "description": "Reusable generic typescript utilities, types, constants, helpers",
-  "keywords": [
-    "typescript",
-    "utilities",
-    "utils",
-    "helpers",
-    "common"
-  ],
+  "keywords": ["typescript", "utilities", "utils", "helpers", "common"],
   "main": "dist/index.cjs",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -18,12 +12,40 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs",
       "default": "./dist/index.js"
+    },
+    "./excel": {
+      "types": "./dist/excel.d.ts",
+      "import": "./dist/excel.js",
+      "require": "./dist/excel.cjs",
+      "default": "./dist/excel.js"
+    },
+    "./csv": {
+      "types": "./dist/csv.d.ts",
+      "import": "./dist/csv.js",
+      "require": "./dist/csv.cjs",
+      "default": "./dist/csv.js"
+    },
+    "./pdf": {
+      "types": "./dist/pdf.d.ts",
+      "import": "./dist/pdf.js",
+      "require": "./dist/pdf.cjs",
+      "default": "./dist/pdf.js"
+    },
+    "./web": {
+      "types": "./dist/web.d.ts",
+      "import": "./dist/web.js",
+      "require": "./dist/web.cjs",
+      "default": "./dist/web.js"
+    },
+    "./mime": {
+      "types": "./dist/mime.d.ts",
+      "import": "./dist/mime.js",
+      "require": "./dist/mime.cjs",
+      "default": "./dist/mime.js"
     }
   },
   "sideEffects": false,
-  "files": [
-    "dist"
-  ],
+  "files": ["dist"],
   "repository": "git@github.com:Lichens-Innovation/ts-common.git",
   "author": "Lichens Innovation",
   "license": "MIT",
@@ -44,6 +66,20 @@
   "dependencies": {
     "date-fns": "^3.0.0"
   },
+  "peerDependencies": {
+    "exceljs": "^4.4.0",
+    "papaparse": "^5.4.1",
+    "jspdf": "^4.1.0",
+    "jspdf-autotable": "^5.0.7",
+    "mime": "^4.1.0"
+  },
+  "peerDependenciesMeta": {
+    "exceljs": { "optional": true },
+    "papaparse": { "optional": true },
+    "jspdf": { "optional": true },
+    "jspdf-autotable": { "optional": true },
+    "mime": { "optional": true }
+  },
   "engines": {
     "node": ">=20.0.0"
   },
@@ -53,18 +89,24 @@
     "@eslint/js": "^9.39.1",
     "@faker-js/faker": "^10.1.0",
     "@types/node": "^24.10.0",
+    "@types/papaparse": "^5.3.14",
     "@vitest/coverage-v8": "4.0.8",
     "commitlint": "^20.1.0",
     "cross-env": "^10.1.0",
     "eslint": "^9.39.1",
+    "exceljs": "^4.4.0",
     "husky": "^9.1.7",
+    "jspdf": "^4.1.0",
+    "jspdf-autotable": "^5.0.7",
+    "mime": "^4.1.0",
+    "papaparse": "^5.4.1",
     "prettier": "^3.6.2",
     "rimraf": "^6.1.0",
     "typescript": "~5.9.3",
     "typescript-eslint": "^8.46.3",
+    "tsup": "^8.3.5",
     "vite": "^7.2.2",
     "vite-tsconfig-paths": "^5.1.4",
-    "vitest": "^4.0.8",
-    "tsup": "^8.3.5"
+    "vitest": "^4.0.8"
   }
 }