@graphysdk/data-import-utils 1.8.0 → 1.8.1-beta.1786024899180

package/LICENSE.md

@@ -0,0 +1,17 @@
+# License
+
+This software is available under any of the following licenses, at your option,
+depending on which one's conditions you meet:
+
+- **PolyForm Noncommercial 1.0.0** — for noncommercial use (personal,
+  charitable, educational, research, government).
+  See [licenses/PolyForm-NonCommercial-1.0.0.md](licenses/PolyForm-NonCommercial-1.0.0.md)
+
+- **PolyForm Small Business 1.0.0** — free commercial use for organizations
+  under the size thresholds defined in the license.
+  See [licenses/PolyForm-Small-Business-1.0.0.md](licenses/PolyForm-Small-Business-1.0.0.md)
+
+- **PolyForm Free Trial 1.0.0** — a 32-day evaluation for anyone else.
+  See [licenses/PolyForm-Free-Trial-1.0.0.md](licenses/PolyForm-Free-Trial-1.0.0.md)
+
+For commercial use beyond these terms, contact [hello@graphy.dev](mailto:hello@graphy.dev) or visit [https://graphy.dev](https://graphy.dev).

package/README.md

@@ -1,6 +1,12 @@
 # `@graphysdk/data-import-utils`
 
-Parse CSV, TSV, and spreadsheet files into the `{ columns, rows }` data shape expected by `@graphysdk/core`.
+Parse CSV, TSV, JSON, and spreadsheet files into the `{ columns, rows }` data shape used by Graphy agents and chart configs.
+
+## Docs
+
+- [Data Import overview](https://docs.graphy.dev/data-import-utils)
+- [Examples](https://docs.graphy.dev/data-import-utils/examples)
+- [Agents SDK](https://docs.graphy.dev/agents/sdk/installation) — feed parsed data into `@graphysdk/agents-sdk`
 
 ## Installation
 
@@ -8,13 +14,7 @@ Parse CSV, TSV, and spreadsheet files into the `{ columns, rows }` data shape ex
 pnpm add @graphysdk/data-import-utils
 ```
 
-### Peer Dependencies
-
-`@graphysdk/core` is required:
-
-```bash
-pnpm add @graphysdk/core
-```
+No npm org token and no `@graphysdk/core` dependency required.
 
 ## Usage
 
@@ -24,7 +24,7 @@ pnpm add @graphysdk/core
 import { fromFile } from '@graphysdk/data-import-utils/file';
 
 const data = await fromFile('sales.csv');
-const data = await fromFile('report.xlsx', { sheet: 'Revenue' });
+const spreadsheet = await fromFile('report.xlsx', { sheet: 'Revenue' });
 ```
 
 ### Parse from a URL
@@ -33,7 +33,7 @@ const data = await fromFile('report.xlsx', { sheet: 'Revenue' });
 import { fromURL } from '@graphysdk/data-import-utils/url';
 
 const data = await fromURL('https://example.com/sales.csv');
-const data = await fromURL('https://example.com/report.xlsx', { sheet: 'Revenue' });
+const spreadsheet = await fromURL('https://example.com/report.xlsx', { sheet: 'Revenue' });
 ```
 
 ### Format-specific imports
@@ -48,7 +48,7 @@ import { fromXLS } from '@graphysdk/data-import-utils/xls';
 import { fromODS } from '@graphysdk/data-import-utils/ods';
 ```
 
-### Feeding into `generateGraph()`
+### Feeding into agents-sdk
 
 ```ts
 import { fromFile } from '@graphysdk/data-import-utils/file';
@@ -72,7 +72,3 @@ const result = await ai.generateGraph({
 | XLSX   | `fromXLSX()` | `ArrayBuffer` |
 | XLS    | `fromXLS()`  | `ArrayBuffer` |
 | ODS    | `fromODS()`  | `ArrayBuffer` |
-
-## Docs
-
-Full documentation: [https://docs.graphy.app/data-import-utils](https://docs.graphy.app/data-import-utils)

package/dist/buffer.cjs

@@ -1 +1 @@
-"use strict";var e=require("tslib");require("papaparse");var t=require("@graphysdk/core/node"),r=require("exceljs");const o=/[^\p{ASCII}]/u,n=/[\u2012\u2013\u2014\u2212](?=\d)/g,l=/\u00A0/g,i=/^-?(?:\d{1,3}(?:,\d{3})*|\d+)(?:\.\d+)?$/,s=/^-?(?:\d{1,3}(?:\.\d{3})*|\d+)(?:,\d+)?$/,u=new Set(["PT_PT","AR"]),a=(e,t="EN_US")=>{let r;if(r=o.test(e)?e.replace(n,"-").replace(l," ").trim():e.trim(),""===r)return null;if(r.length>100)return r;if(u.has(t)){if(s.test(r)){const e=r.replace(/\./g,"").replace(",","."),t=Number(e);if(Number.isFinite(t))return t}}else if(i.test(r)){const e=r.replace(/,/g,""),t=Number(e);if(Number.isFinite(t))return t}return r},c=e=>{const{value:t}=e;if(null==t)return null;if("number"==typeof t)return t;if("string"==typeof t)return""===t?null:t;if("boolean"==typeof t)return t?1:0;if(t instanceof Date)return t.toISOString();if((e=>"object"==typeof e&&null!==e&&"formula"in e)(t)){if("number"==typeof t.result)return t.result;if("string"==typeof t.result)return""===t.result?null:t.result;if("boolean"==typeof t.result)return t.result?1:0;if(t.result instanceof Date)return t.result.toISOString()}const r=e.text;return""===r?null:r},d=["dataValidations","conditionalFormatting","sheetProtection"];const f=(o,n)=>e.__awaiter(void 0,void 0,void 0,function*(){var l,i,s,u,f;const m=1024*(null!==(l=null==n?void 0:n.maxFileSize)&&void 0!==l?l:5)*1024;if(o.byteLength>m)throw new Error(`Input size (${o.byteLength} bytes) exceeds the maximum allowed size of ${m} bytes (${null!==(i=null==n?void 0:n.maxFileSize)&&void 0!==i?i:5} MB).`);const h=null!==(s=null==n?void 0:n.locale)&&void 0!==s?s:"EN_US",p=yield function(t){return e.__awaiter(this,void 0,void 0,function*(){const e=new r.Workbook;return yield e.xlsx.load(t,{ignoreNodes:d}),e})}(o),w=((e,t)=>{if(void 0===t)return e.worksheets[0];if("number"==typeof t){const r=e.worksheets[t];if(!r)throw new Error(`Sheet index ${t} is out of range. Workbook has ${e.worksheets.length} sheet(s).`);return r}const r=e.getWorksheet(t);if(!r){const r=e.worksheets.map(e=>`"${e.name}"`).join(", ");throw new Error(`Sheet "${t}" not found. Available sheets: ${r}`)}return r})(p,null==n?void 0:n.sheet);if(!w||0===w.rowCount)return{columns:[],rows:[]};const v=w.columnCount;if(0===v)return{columns:[],rows:[]};const x=w.getRow(1),g=[];for(let e=1;e<=v;e++){const t=x.getCell(e).value;g.push(String(null!=t?t:""))}const b=((e,r)=>{var o;const n=[];for(let l=0;l<r;l++){const r=null===(o=null==e?void 0:e[l])||void 0===o?void 0:o.trim(),i={key:t.columnIndexToPropertyKey(l)};r&&(i.label=r),n.push(i)}return n})(g,v),y=null!==(u=null==n?void 0:n.maxRows)&&void 0!==u?u:1e5,S=null!==(f=null==n?void 0:n.maxCells)&&void 0!==f?f:5e6,$=[];let k=0,C=0;for(let e=2;e<=w.rowCount;e++){if(k++,k>y)throw new Error(`Row limit exceeded: processed ${k} rows (maximum: ${y}). Use the maxRows option to increase the limit.`);if(C+=v,C>S)throw new Error(`Cell limit exceeded: processed ${C} cells (maximum: ${S}). Use the maxCells option to increase the limit.`);const t=w.getRow(e),r=[];for(let e=1;e<=v;e++)r.push(c(t.getCell(e)));$.push(r)}const _=((e,t,r)=>e.map(e=>{const o={};for(let n=0;n<t.length;n++){const l=t[n];if(!l)continue;const i=e[n];o[l.key]=null==i||""===i?null:"number"==typeof i?i:a(String(i),r)}return o}))($,b,h);return{columns:b,rows:_}});exports.fromBuffer=(t,r,o)=>e.__awaiter(void 0,void 0,void 0,function*(){switch(r){case"xlsx":case"xls":case"ods":return((e,t)=>f(e,t))(t,o);default:throw new Error(`Unsupported binary format "${r}". Supported: xlsx, xls, ods`)}});
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./parse-string-DpdSP3xh.cjs");exports.fromBuffer=e.fromBuffer;

package/dist/buffer.mjs

@@ -1 +1,4 @@
-import{__awaiter as e}from"tslib";import"papaparse";import{columnIndexToPropertyKey as t}from"@graphysdk/core/node";import o from"exceljs";const r=/[^\p{ASCII}]/u,n=/[\u2012\u2013\u2014\u2212](?=\d)/g,l=/\u00A0/g,i=/^-?(?:\d{1,3}(?:,\d{3})*|\d+)(?:\.\d+)?$/,s=/^-?(?:\d{1,3}(?:\.\d{3})*|\d+)(?:,\d+)?$/,u=new Set(["PT_PT","AR"]),c=(e,t="EN_US")=>{let o;if(o=r.test(e)?e.replace(n,"-").replace(l," ").trim():e.trim(),""===o)return null;if(o.length>100)return o;if(u.has(t)){if(s.test(o)){const e=o.replace(/\./g,"").replace(",","."),t=Number(e);if(Number.isFinite(t))return t}}else if(i.test(o)){const e=o.replace(/,/g,""),t=Number(e);if(Number.isFinite(t))return t}return o},d=e=>{const{value:t}=e;if(null==t)return null;if("number"==typeof t)return t;if("string"==typeof t)return""===t?null:t;if("boolean"==typeof t)return t?1:0;if(t instanceof Date)return t.toISOString();if((e=>"object"==typeof e&&null!==e&&"formula"in e)(t)){if("number"==typeof t.result)return t.result;if("string"==typeof t.result)return""===t.result?null:t.result;if("boolean"==typeof t.result)return t.result?1:0;if(t.result instanceof Date)return t.result.toISOString()}const o=e.text;return""===o?null:o},f=["dataValidations","conditionalFormatting","sheetProtection"];const a=(r,n)=>e(void 0,void 0,void 0,function*(){var l,i,s,u,a;const m=1024*(null!==(l=null==n?void 0:n.maxFileSize)&&void 0!==l?l:5)*1024;if(r.byteLength>m)throw new Error(`Input size (${r.byteLength} bytes) exceeds the maximum allowed size of ${m} bytes (${null!==(i=null==n?void 0:n.maxFileSize)&&void 0!==i?i:5} MB).`);const p=null!==(s=null==n?void 0:n.locale)&&void 0!==s?s:"EN_US",h=yield function(t){return e(this,void 0,void 0,function*(){const e=new o.Workbook;return yield e.xlsx.load(t,{ignoreNodes:f}),e})}(r),w=((e,t)=>{if(void 0===t)return e.worksheets[0];if("number"==typeof t){const o=e.worksheets[t];if(!o)throw new Error(`Sheet index ${t} is out of range. Workbook has ${e.worksheets.length} sheet(s).`);return o}const o=e.getWorksheet(t);if(!o){const o=e.worksheets.map(e=>`"${e.name}"`).join(", ");throw new Error(`Sheet "${t}" not found. Available sheets: ${o}`)}return o})(h,null==n?void 0:n.sheet);if(!w||0===w.rowCount)return{columns:[],rows:[]};const v=w.columnCount;if(0===v)return{columns:[],rows:[]};const g=w.getRow(1),x=[];for(let e=1;e<=v;e++){const t=g.getCell(e).value;x.push(String(null!=t?t:""))}const b=((e,o)=>{var r;const n=[];for(let l=0;l<o;l++){const o=null===(r=null==e?void 0:e[l])||void 0===r?void 0:r.trim(),i={key:t(l)};o&&(i.label=o),n.push(i)}return n})(x,v),y=null!==(u=null==n?void 0:n.maxRows)&&void 0!==u?u:1e5,S=null!==(a=null==n?void 0:n.maxCells)&&void 0!==a?a:5e6,$=[];let k=0,C=0;for(let e=2;e<=w.rowCount;e++){if(k++,k>y)throw new Error(`Row limit exceeded: processed ${k} rows (maximum: ${y}). Use the maxRows option to increase the limit.`);if(C+=v,C>S)throw new Error(`Cell limit exceeded: processed ${C} cells (maximum: ${S}). Use the maxCells option to increase the limit.`);const t=w.getRow(e),o=[];for(let e=1;e<=v;e++)o.push(d(t.getCell(e)));$.push(o)}const E=((e,t,o)=>e.map(e=>{const r={};for(let n=0;n<t.length;n++){const l=t[n];if(!l)continue;const i=e[n];r[l.key]=null==i||""===i?null:"number"==typeof i?i:c(String(i),o)}return r}))($,b,p);return{columns:b,rows:E}}),m=(t,o,r)=>e(void 0,void 0,void 0,function*(){switch(o){case"xlsx":case"xls":case"ods":return((e,t)=>a(e,t))(t,r);default:throw new Error(`Unsupported binary format "${o}". Supported: xlsx, xls, ods`)}});export{m as fromBuffer};
+import { t as f } from "./parse-string-VVlSsL2Y.js";
+export {
+  f as fromBuffer
+};

package/dist/constants-BSk6SyUk.cjs

@@ -0,0 +1 @@
+var e=1e5,r=5e6;Object.defineProperty(exports,"DEFAULT_MAX_CELLS",{enumerable:!0,get:function(){return r}});Object.defineProperty(exports,"DEFAULT_MAX_ROWS",{enumerable:!0,get:function(){return e}});

package/dist/constants-PA0Uh9bi.js

@@ -0,0 +1,5 @@
+var a = 1e5, A = 5e6;
+export {
+  a as n,
+  A as t
+};

package/dist/csv.cjs

@@ -1 +1 @@
-"use strict";var e=require("papaparse"),r=require("@graphysdk/core/node");const t=/[^\p{ASCII}]/u,n=/[\u2012\u2013\u2014\u2212](?=\d)/g,l=/\u00A0/g,o=/^-?(?:\d{1,3}(?:,\d{3})*|\d+)(?:\.\d+)?$/,i=/^-?(?:\d{1,3}(?:\.\d{3})*|\d+)(?:,\d+)?$/,u=new Set(["PT_PT","AR"]),s=(e,r="EN_US")=>{let s;if(s=t.test(e)?e.replace(n,"-").replace(l," ").trim():e.trim(),""===s)return null;if(s.length>100)return s;if(u.has(r)){if(i.test(s)){const e=s.replace(/\./g,"").replace(",","."),r=Number(e);if(Number.isFinite(r))return r}}else if(o.test(s)){const e=s.replace(/,/g,""),r=Number(e);if(Number.isFinite(r))return r}return s},d=(t,n,l)=>{var o,i,u,d,a;const c=1024*(null!==(o=null==l?void 0:l.maxFileSize)&&void 0!==o?o:5)*1024;if(t.length>c)throw new Error(`Input size (${t.length} bytes) exceeds the maximum allowed size of ${c} bytes (${null!==(i=null==l?void 0:l.maxFileSize)&&void 0!==i?i:5} MB).`);const m=!1!==(null==l?void 0:l.hasHeader),p=null!==(u=null==l?void 0:l.locale)&&void 0!==u?u:"EN_US",v=e.parse(t,{header:!1,delimiter:n,skipEmptyLines:!0}),f=v.errors.filter(e=>"Quotes"===e.type);if(f.length>0){const e=f[0];throw new Error(`Parse error at row ${null!==(d=null==e?void 0:e.row)&&void 0!==d?d:"?"}: ${null!==(a=null==e?void 0:e.message)&&void 0!==a?a:"Unknown error"}`)}const h=v.data;if(0===h.length)return{columns:[],rows:[]};const g=m?h[0]:void 0,w=m?h.slice(1):h,y=((e,t)=>{var n;const l=[];for(let o=0;o<t;o++){const t=null===(n=null==e?void 0:e[o])||void 0===n?void 0:n.trim(),i={key:r.columnIndexToPropertyKey(o)};t&&(i.label=t),l.push(i)}return l})(g,h.reduce((e,r)=>Math.max(e,r.length),0)),b=((e,r,t)=>e.map(e=>{const n={};for(let l=0;l<r.length;l++){const o=r[l];if(!o)continue;const i=e[l];n[o.key]=null==i||""===i?null:"number"==typeof i?i:s(String(i),t)}return n}))(w,y,p);return{columns:y,rows:b}};exports.fromCSV=(e,r)=>d(e,void 0,r);
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./from-csv-Ccr_5k9u.cjs");exports.fromCSV=e.fromCSV;

package/dist/csv.mjs

@@ -1 +1,4 @@
-import e from"papaparse";import{columnIndexToPropertyKey as r}from"@graphysdk/core/node";const t=/[^\p{ASCII}]/u,n=/[\u2012\u2013\u2014\u2212](?=\d)/g,l=/\u00A0/g,o=/^-?(?:\d{1,3}(?:,\d{3})*|\d+)(?:\.\d+)?$/,i=/^-?(?:\d{1,3}(?:\.\d{3})*|\d+)(?:,\d+)?$/,u=new Set(["PT_PT","AR"]),s=(e,r="EN_US")=>{let s;if(s=t.test(e)?e.replace(n,"-").replace(l," ").trim():e.trim(),""===s)return null;if(s.length>100)return s;if(u.has(r)){if(i.test(s)){const e=s.replace(/\./g,"").replace(",","."),r=Number(e);if(Number.isFinite(r))return r}}else if(o.test(s)){const e=s.replace(/,/g,""),r=Number(e);if(Number.isFinite(r))return r}return s},d=(t,n,l)=>{var o,i,u,d,a;const c=1024*(null!==(o=null==l?void 0:l.maxFileSize)&&void 0!==o?o:5)*1024;if(t.length>c)throw new Error(`Input size (${t.length} bytes) exceeds the maximum allowed size of ${c} bytes (${null!==(i=null==l?void 0:l.maxFileSize)&&void 0!==i?i:5} MB).`);const m=!1!==(null==l?void 0:l.hasHeader),p=null!==(u=null==l?void 0:l.locale)&&void 0!==u?u:"EN_US",f=e.parse(t,{header:!1,delimiter:n,skipEmptyLines:!0}),v=f.errors.filter(e=>"Quotes"===e.type);if(v.length>0){const e=v[0];throw new Error(`Parse error at row ${null!==(d=null==e?void 0:e.row)&&void 0!==d?d:"?"}: ${null!==(a=null==e?void 0:e.message)&&void 0!==a?a:"Unknown error"}`)}const h=f.data;if(0===h.length)return{columns:[],rows:[]};const g=m?h[0]:void 0,w=m?h.slice(1):h,b=((e,t)=>{var n;const l=[];for(let o=0;o<t;o++){const t=null===(n=null==e?void 0:e[o])||void 0===n?void 0:n.trim(),i={key:r(o)};t&&(i.label=t),l.push(i)}return l})(g,h.reduce((e,r)=>Math.max(e,r.length),0)),y=((e,r,t)=>e.map(e=>{const n={};for(let l=0;l<r.length;l++){const o=r[l];if(!o)continue;const i=e[l];n[o.key]=null==i||""===i?null:"number"==typeof i?i:s(String(i),t)}return n}))(w,b,p);return{columns:b,rows:y}},a=(e,r)=>d(e,void 0,r);export{a as fromCSV};
+import { t as r } from "./from-csv-CrQ_H-s5.js";
+export {
+  r as fromCSV
+};

package/dist/file.cjs

@@ -1 +1 @@
-"use strict";var e=require("tslib"),r=require("node:fs/promises"),t=require("node:path"),o=require("papaparse"),n=require("@graphysdk/core/node"),s=require("exceljs");const i=new Set(["csv","tsv","json"]),l={".csv":"csv",".tsv":"tsv",".tab":"tsv",".json":"json",".xlsx":"xlsx",".xls":"xls",".ods":"ods"},u=(e,r)=>{var t;const o=[];for(let s=0;s<r;s++){const r=null===(t=null==e?void 0:e[s])||void 0===t?void 0:t.trim(),i={key:n.columnIndexToPropertyKey(s)};r&&(i.label=r),o.push(i)}return o},a=/[^\p{ASCII}]/u,c=/[\u2012\u2013\u2014\u2212](?=\d)/g,f=/\u00A0/g,d=/^-?(?:\d{1,3}(?:,\d{3})*|\d+)(?:\.\d+)?$/,p=/^-?(?:\d{1,3}(?:\.\d{3})*|\d+)(?:,\d+)?$/,w=new Set(["PT_PT","AR"]),m=(e,r="EN_US")=>{let t;if(t=a.test(e)?e.replace(c,"-").replace(f," ").trim():e.trim(),""===t)return null;if(t.length>100)return t;if(w.has(r)){if(p.test(t)){const e=t.replace(/\./g,"").replace(",","."),r=Number(e);if(Number.isFinite(r))return r}}else if(d.test(t)){const e=t.replace(/,/g,""),r=Number(e);if(Number.isFinite(r))return r}return t},h=(e,r,t)=>e.map(e=>{const o={};for(let n=0;n<r.length;n++){const s=r[n];if(!s)continue;const i=e[n];o[s.key]=null==i||""===i?null:"number"==typeof i?i:m(String(i),t)}return o}),v=(e,r,t)=>{var n,s,i,l,a;const c=1024*(null!==(n=null==t?void 0:t.maxFileSize)&&void 0!==n?n:5)*1024;if(e.length>c)throw new Error(`Input size (${e.length} bytes) exceeds the maximum allowed size of ${c} bytes (${null!==(s=null==t?void 0:t.maxFileSize)&&void 0!==s?s:5} MB).`);const f=!1!==(null==t?void 0:t.hasHeader),d=null!==(i=null==t?void 0:t.locale)&&void 0!==i?i:"EN_US",p=o.parse(e,{header:!1,delimiter:r,skipEmptyLines:!0}),w=p.errors.filter(e=>"Quotes"===e.type);if(w.length>0){const e=w[0];throw new Error(`Parse error at row ${null!==(l=null==e?void 0:e.row)&&void 0!==l?l:"?"}: ${null!==(a=null==e?void 0:e.message)&&void 0!==a?a:"Unknown error"}`)}const m=p.data;if(0===m.length)return{columns:[],rows:[]};const v=f?m[0]:void 0,y=f?m.slice(1):m,b=m.reduce((e,r)=>Math.max(e,r.length),0),g=u(v,b);return{columns:g,rows:h(y,g,d)}},y=e=>"object"==typeof e&&null!==e&&!Array.isArray(e),b=e=>null==e?null:"number"==typeof e?Number.isFinite(e)?e:null:"string"==typeof e?e:"boolean"==typeof e?String(e):JSON.stringify(e),g=(e,r)=>{const t="string"==typeof e?((e,r)=>{var t;const o=null!==(t=null==r?void 0:r.maxFileSize)&&void 0!==t?t:5,n=1024*o*1024,s=(new TextEncoder).encode(e).byteLength;if(s>n)throw new Error(`Input size (${s} bytes) exceeds the maximum allowed size of ${n} bytes (${o} MB).`);try{return JSON.parse(e)}catch(e){throw new Error(`Invalid JSON: ${e instanceof Error?e.message:"could not parse"}`)}})(e,r):e;if(Array.isArray(t))return(e=>{const r=[],t=new Set;for(const o of e){if(!y(o))throw new Error("Each JSON row must be an object mapping column names to values.");for(const e of Object.keys(o))t.has(e)||(t.add(e),r.push(e))}return{columns:r.map(e=>({key:e})),rows:e.map(e=>{const t={};for(const o of r)t[o]=b(e[o]);return t})}})(t);if((e=>y(e)&&Array.isArray(e.columns)&&Array.isArray(e.rows))(t))return(e=>{const r=e.columns.map(e=>{if(!y(e)||"string"!=typeof e.key||0===e.key.length)throw new Error('Each JSON column must be an object with a non-empty string "key".');return void 0!==e.label?{key:e.key,label:String(e.label)}:{key:e.key}}),t=e.rows.map(e=>{if(!y(e))throw new Error("Each JSON row must be an object mapping column keys to values.");const t={};for(const o of r)t[o.key]=b(e[o.key]);return t});return{columns:r,rows:t}})(t);throw new Error("Unsupported JSON dataset: expected an array of row objects or a { columns, rows } object.")},x=e=>{const{value:r}=e;if(null==r)return null;if("number"==typeof r)return r;if("string"==typeof r)return""===r?null:r;if("boolean"==typeof r)return r?1:0;if(r instanceof Date)return r.toISOString();if((e=>"object"==typeof e&&null!==e&&"formula"in e)(r)){if("number"==typeof r.result)return r.result;if("string"==typeof r.result)return""===r.result?null:r.result;if("boolean"==typeof r.result)return r.result?1:0;if(r.result instanceof Date)return r.result.toISOString()}const t=e.text;return""===t?null:t},S=["dataValidations","conditionalFormatting","sheetProtection"];const $=(r,t)=>e.__awaiter(void 0,void 0,void 0,function*(){var o,n,i,l,a;const c=1024*(null!==(o=null==t?void 0:t.maxFileSize)&&void 0!==o?o:5)*1024;if(r.byteLength>c)throw new Error(`Input size (${r.byteLength} bytes) exceeds the maximum allowed size of ${c} bytes (${null!==(n=null==t?void 0:t.maxFileSize)&&void 0!==n?n:5} MB).`);const f=null!==(i=null==t?void 0:t.locale)&&void 0!==i?i:"EN_US",d=yield function(r){return e.__awaiter(this,void 0,void 0,function*(){const e=new s.Workbook;return yield e.xlsx.load(r,{ignoreNodes:S}),e})}(r),p=((e,r)=>{if(void 0===r)return e.worksheets[0];if("number"==typeof r){const t=e.worksheets[r];if(!t)throw new Error(`Sheet index ${r} is out of range. Workbook has ${e.worksheets.length} sheet(s).`);return t}const t=e.getWorksheet(r);if(!t){const t=e.worksheets.map(e=>`"${e.name}"`).join(", ");throw new Error(`Sheet "${r}" not found. Available sheets: ${t}`)}return t})(d,null==t?void 0:t.sheet);if(!p||0===p.rowCount)return{columns:[],rows:[]};const w=p.columnCount;if(0===w)return{columns:[],rows:[]};const m=p.getRow(1),v=[];for(let e=1;e<=w;e++){const r=m.getCell(e).value;v.push(String(null!=r?r:""))}const y=u(v,w),b=null!==(l=null==t?void 0:t.maxRows)&&void 0!==l?l:1e5,g=null!==(a=null==t?void 0:t.maxCells)&&void 0!==a?a:5e6,$=[];let E=0,k=0;for(let e=2;e<=p.rowCount;e++){if(E++,E>b)throw new Error(`Row limit exceeded: processed ${E} rows (maximum: ${b}). Use the maxRows option to increase the limit.`);if(k+=w,k>g)throw new Error(`Cell limit exceeded: processed ${k} cells (maximum: ${g}). Use the maxCells option to increase the limit.`);const r=p.getRow(e),t=[];for(let e=1;e<=w;e++)t.push(x(r.getCell(e)));$.push(t)}return{columns:y,rows:h($,y,f)}}),E=(e,r,t)=>{switch(r){case"csv":return((e,r)=>v(e,void 0,r))(e,t);case"tsv":return((e,r)=>v(e,"\t",r))(e,t);case"json":return g(e,t);default:throw new Error(`Unsupported text format "${r}". Supported: csv, tsv, json`)}},k=(r,t,o)=>e.__awaiter(void 0,void 0,void 0,function*(){switch(t){case"xlsx":case"xls":case"ods":return((e,r)=>$(e,r))(r,o);default:throw new Error(`Unsupported binary format "${t}". Supported: xlsx, xls, ods`)}});exports.fromFile=(o,n)=>e.__awaiter(void 0,void 0,void 0,function*(){if("undefined"!=typeof window&&"undefined"==typeof process)throw new Error("fromFile is only available in Node.js environments. In the browser, read the file using the File API and pass the result to fromCSV (for text) or fromXLSX (for binary formats).");const s=t.extname(o).toLowerCase(),u=(e=>l[e.toLowerCase()])(s);if(!u){const e=Object.keys(l).join(", ");throw new Error(`Unsupported file extension "${s||"(none)"}". Supported: ${e}`)}const a=yield r.readFile(o);return((r,t,o)=>e.__awaiter(void 0,void 0,void 0,function*(){switch(t){case"csv":case"tsv":case"json":if("string"!=typeof r)throw new TypeError(`${t.toUpperCase()} parsing requires a string input, but received an ArrayBuffer.`);return E(r,t,o);case"xlsx":case"xls":case"ods":if("string"==typeof r)throw new TypeError(`${t.toUpperCase()} parsing requires an ArrayBuffer input, but received a string.`);return k(r,t,o);default:throw new Error(`Unsupported format "${t}". Supported formats: csv, tsv, json, xlsx, xls, ods`)}}))(i.has(u)?"string"==typeof a?a:a.toString("utf-8"):a instanceof Buffer?a.buffer.slice(a.byteOffset,a.byteOffset+a.byteLength):a,u,n)});
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("./map-rows-1hzHO_rN.cjs"),t=require("./format-detection-1kqWtVpP.cjs"),u=require("./parse-string-DpdSP3xh.cjs");let d=require("node:fs/promises"),o=require("node:path");o=a.__toESM(o,1);var l=async(n,s)=>{if(typeof window<"u"&&typeof process>"u")throw new Error("fromFile is only available in Node.js environments. In the browser, read the file using the File API and pass the result to fromCSV (for text) or fromXLSX (for binary formats).");const i=o.default.extname(n).toLowerCase(),r=t.formatFromExtension(i);if(!r){const f=Object.keys(t.EXTENSION_MAP).join(", ");throw new Error(`Unsupported file extension "${i||"(none)"}". Supported: ${f}`)}const e=await(0,d.readFile)(n);return u.fromString(t.TEXT_FORMATS.has(r)?typeof e=="string"?e:e.toString("utf-8"):e instanceof Buffer?e.buffer.slice(e.byteOffset,e.byteOffset+e.byteLength):e,r,s)};exports.fromFile=l;

package/dist/file.mjs

@@ -1 +1,17 @@
-import{__awaiter as e}from"tslib";import{readFile as r}from"node:fs/promises";import t from"node:path";import o from"papaparse";import{columnIndexToPropertyKey as n}from"@graphysdk/core/node";import s from"exceljs";const i=new Set(["csv","tsv","json"]),l={".csv":"csv",".tsv":"tsv",".tab":"tsv",".json":"json",".xlsx":"xlsx",".xls":"xls",".ods":"ods"},u=(e,r)=>{var t;const o=[];for(let s=0;s<r;s++){const r=null===(t=null==e?void 0:e[s])||void 0===t?void 0:t.trim(),i={key:n(s)};r&&(i.label=r),o.push(i)}return o},a=/[^\p{ASCII}]/u,c=/[\u2012\u2013\u2014\u2212](?=\d)/g,f=/\u00A0/g,d=/^-?(?:\d{1,3}(?:,\d{3})*|\d+)(?:\.\d+)?$/,m=/^-?(?:\d{1,3}(?:\.\d{3})*|\d+)(?:,\d+)?$/,p=new Set(["PT_PT","AR"]),w=(e,r="EN_US")=>{let t;if(t=a.test(e)?e.replace(c,"-").replace(f," ").trim():e.trim(),""===t)return null;if(t.length>100)return t;if(p.has(r)){if(m.test(t)){const e=t.replace(/\./g,"").replace(",","."),r=Number(e);if(Number.isFinite(r))return r}}else if(d.test(t)){const e=t.replace(/,/g,""),r=Number(e);if(Number.isFinite(r))return r}return t},h=(e,r,t)=>e.map(e=>{const o={};for(let n=0;n<r.length;n++){const s=r[n];if(!s)continue;const i=e[n];o[s.key]=null==i||""===i?null:"number"==typeof i?i:w(String(i),t)}return o}),v=(e,r,t)=>{var n,s,i,l,a;const c=1024*(null!==(n=null==t?void 0:t.maxFileSize)&&void 0!==n?n:5)*1024;if(e.length>c)throw new Error(`Input size (${e.length} bytes) exceeds the maximum allowed size of ${c} bytes (${null!==(s=null==t?void 0:t.maxFileSize)&&void 0!==s?s:5} MB).`);const f=!1!==(null==t?void 0:t.hasHeader),d=null!==(i=null==t?void 0:t.locale)&&void 0!==i?i:"EN_US",m=o.parse(e,{header:!1,delimiter:r,skipEmptyLines:!0}),p=m.errors.filter(e=>"Quotes"===e.type);if(p.length>0){const e=p[0];throw new Error(`Parse error at row ${null!==(l=null==e?void 0:e.row)&&void 0!==l?l:"?"}: ${null!==(a=null==e?void 0:e.message)&&void 0!==a?a:"Unknown error"}`)}const w=m.data;if(0===w.length)return{columns:[],rows:[]};const v=f?w[0]:void 0,y=f?w.slice(1):w,b=w.reduce((e,r)=>Math.max(e,r.length),0),g=u(v,b);return{columns:g,rows:h(y,g,d)}},y=e=>"object"==typeof e&&null!==e&&!Array.isArray(e),b=e=>null==e?null:"number"==typeof e?Number.isFinite(e)?e:null:"string"==typeof e?e:"boolean"==typeof e?String(e):JSON.stringify(e),g=(e,r)=>{const t="string"==typeof e?((e,r)=>{var t;const o=null!==(t=null==r?void 0:r.maxFileSize)&&void 0!==t?t:5,n=1024*o*1024,s=(new TextEncoder).encode(e).byteLength;if(s>n)throw new Error(`Input size (${s} bytes) exceeds the maximum allowed size of ${n} bytes (${o} MB).`);try{return JSON.parse(e)}catch(e){throw new Error(`Invalid JSON: ${e instanceof Error?e.message:"could not parse"}`)}})(e,r):e;if(Array.isArray(t))return(e=>{const r=[],t=new Set;for(const o of e){if(!y(o))throw new Error("Each JSON row must be an object mapping column names to values.");for(const e of Object.keys(o))t.has(e)||(t.add(e),r.push(e))}return{columns:r.map(e=>({key:e})),rows:e.map(e=>{const t={};for(const o of r)t[o]=b(e[o]);return t})}})(t);if((e=>y(e)&&Array.isArray(e.columns)&&Array.isArray(e.rows))(t))return(e=>{const r=e.columns.map(e=>{if(!y(e)||"string"!=typeof e.key||0===e.key.length)throw new Error('Each JSON column must be an object with a non-empty string "key".');return void 0!==e.label?{key:e.key,label:String(e.label)}:{key:e.key}}),t=e.rows.map(e=>{if(!y(e))throw new Error("Each JSON row must be an object mapping column keys to values.");const t={};for(const o of r)t[o.key]=b(e[o.key]);return t});return{columns:r,rows:t}})(t);throw new Error("Unsupported JSON dataset: expected an array of row objects or a { columns, rows } object.")},x=e=>{const{value:r}=e;if(null==r)return null;if("number"==typeof r)return r;if("string"==typeof r)return""===r?null:r;if("boolean"==typeof r)return r?1:0;if(r instanceof Date)return r.toISOString();if((e=>"object"==typeof e&&null!==e&&"formula"in e)(r)){if("number"==typeof r.result)return r.result;if("string"==typeof r.result)return""===r.result?null:r.result;if("boolean"==typeof r.result)return r.result?1:0;if(r.result instanceof Date)return r.result.toISOString()}const t=e.text;return""===t?null:t},S=["dataValidations","conditionalFormatting","sheetProtection"];const $=(r,t)=>e(void 0,void 0,void 0,function*(){var o,n,i,l,a;const c=1024*(null!==(o=null==t?void 0:t.maxFileSize)&&void 0!==o?o:5)*1024;if(r.byteLength>c)throw new Error(`Input size (${r.byteLength} bytes) exceeds the maximum allowed size of ${c} bytes (${null!==(n=null==t?void 0:t.maxFileSize)&&void 0!==n?n:5} MB).`);const f=null!==(i=null==t?void 0:t.locale)&&void 0!==i?i:"EN_US",d=yield function(r){return e(this,void 0,void 0,function*(){const e=new s.Workbook;return yield e.xlsx.load(r,{ignoreNodes:S}),e})}(r),m=((e,r)=>{if(void 0===r)return e.worksheets[0];if("number"==typeof r){const t=e.worksheets[r];if(!t)throw new Error(`Sheet index ${r} is out of range. Workbook has ${e.worksheets.length} sheet(s).`);return t}const t=e.getWorksheet(r);if(!t){const t=e.worksheets.map(e=>`"${e.name}"`).join(", ");throw new Error(`Sheet "${r}" not found. Available sheets: ${t}`)}return t})(d,null==t?void 0:t.sheet);if(!m||0===m.rowCount)return{columns:[],rows:[]};const p=m.columnCount;if(0===p)return{columns:[],rows:[]};const w=m.getRow(1),v=[];for(let e=1;e<=p;e++){const r=w.getCell(e).value;v.push(String(null!=r?r:""))}const y=u(v,p),b=null!==(l=null==t?void 0:t.maxRows)&&void 0!==l?l:1e5,g=null!==(a=null==t?void 0:t.maxCells)&&void 0!==a?a:5e6,$=[];let E=0,k=0;for(let e=2;e<=m.rowCount;e++){if(E++,E>b)throw new Error(`Row limit exceeded: processed ${E} rows (maximum: ${b}). Use the maxRows option to increase the limit.`);if(k+=p,k>g)throw new Error(`Cell limit exceeded: processed ${k} cells (maximum: ${g}). Use the maxCells option to increase the limit.`);const r=m.getRow(e),t=[];for(let e=1;e<=p;e++)t.push(x(r.getCell(e)));$.push(t)}return{columns:y,rows:h($,y,f)}}),E=(e,r,t)=>{switch(r){case"csv":return((e,r)=>v(e,void 0,r))(e,t);case"tsv":return((e,r)=>v(e,"\t",r))(e,t);case"json":return g(e,t);default:throw new Error(`Unsupported text format "${r}". Supported: csv, tsv, json`)}},k=(r,t,o)=>e(void 0,void 0,void 0,function*(){switch(t){case"xlsx":case"xls":case"ods":return((e,r)=>$(e,r))(r,o);default:throw new Error(`Unsupported binary format "${t}". Supported: xlsx, xls, ods`)}}),j=(o,n)=>e(void 0,void 0,void 0,function*(){if("undefined"!=typeof window&&"undefined"==typeof process)throw new Error("fromFile is only available in Node.js environments. In the browser, read the file using the File API and pass the result to fromCSV (for text) or fromXLSX (for binary formats).");const s=t.extname(o).toLowerCase(),u=(e=>l[e.toLowerCase()])(s);if(!u){const e=Object.keys(l).join(", ");throw new Error(`Unsupported file extension "${s||"(none)"}". Supported: ${e}`)}const a=yield r(o);return((r,t,o)=>e(void 0,void 0,void 0,function*(){switch(t){case"csv":case"tsv":case"json":if("string"!=typeof r)throw new TypeError(`${t.toUpperCase()} parsing requires a string input, but received an ArrayBuffer.`);return E(r,t,o);case"xlsx":case"xls":case"ods":if("string"==typeof r)throw new TypeError(`${t.toUpperCase()} parsing requires an ArrayBuffer input, but received a string.`);return k(r,t,o);default:throw new Error(`Unsupported format "${t}". Supported formats: csv, tsv, json, xlsx, xls, ods`)}}))(i.has(u)?"string"==typeof a?a:a.toString("utf-8"):a instanceof Buffer?a.buffer.slice(a.byteOffset,a.byteOffset+a.byteLength):a,u,n)});export{j as fromFile};
+import { n as s, r as i, t as a } from "./format-detection-MwlOpP6Y.js";
+import { n as m } from "./parse-string-VVlSsL2Y.js";
+import { readFile as p } from "node:fs/promises";
+import d from "node:path";
+var c = async (o, n) => {
+  if (typeof window < "u" && typeof process > "u") throw new Error("fromFile is only available in Node.js environments. In the browser, read the file using the File API and pass the result to fromCSV (for text) or fromXLSX (for binary formats).");
+  const t = d.extname(o).toLowerCase(), r = i(t);
+  if (!r) {
+    const f = Object.keys(a).join(", ");
+    throw new Error(`Unsupported file extension "${t || "(none)"}". Supported: ${f}`);
+  }
+  const e = await p(o);
+  return m(s.has(r) ? typeof e == "string" ? e : e.toString("utf-8") : e instanceof Buffer ? e.buffer.slice(e.byteOffset, e.byteOffset + e.byteLength) : e, r, n);
+};
+export {
+  c as fromFile
+};

package/dist/format-detection-1kqWtVpP.cjs

@@ -0,0 +1 @@
+var r=new Set(["csv","tsv","json"]),e={".csv":"csv",".tsv":"tsv",".tab":"tsv",".json":"json",".xlsx":"xlsx",".xls":"xls",".ods":"ods"},n=t=>e[t.toLowerCase()];Object.defineProperty(exports,"EXTENSION_MAP",{enumerable:!0,get:function(){return e}});Object.defineProperty(exports,"TEXT_FORMATS",{enumerable:!0,get:function(){return r}});Object.defineProperty(exports,"formatFromExtension",{enumerable:!0,get:function(){return n}});

package/dist/format-detection-MwlOpP6Y.js

@@ -0,0 +1,18 @@
+var t = /* @__PURE__ */ new Set([
+  "csv",
+  "tsv",
+  "json"
+]), o = {
+  ".csv": "csv",
+  ".tsv": "tsv",
+  ".tab": "tsv",
+  ".json": "json",
+  ".xlsx": "xlsx",
+  ".xls": "xls",
+  ".ods": "ods"
+}, v = (s) => o[s.toLowerCase()];
+export {
+  t as n,
+  v as r,
+  o as t
+};

package/dist/from-csv-Ccr_5k9u.cjs

@@ -0,0 +1 @@
+const t=require("./parse-delimited-BSoFIVFq.cjs");var i=(e,r)=>t.parseDelimited(e,void 0,r);Object.defineProperty(exports,"fromCSV",{enumerable:!0,get:function(){return i}});

package/dist/from-csv-CrQ_H-s5.js

@@ -0,0 +1,5 @@
+import { t as e } from "./parse-delimited-qsjX5KAa.js";
+var a = (r, t) => e(r, void 0, t);
+export {
+  a as t
+};

package/dist/from-csv.d.ts

@@ -0,0 +1,13 @@
+import { Data, DelimitedParseOptions } from './types';
+/**
+ * Parses a CSV string into the `Data` shape expected by `generateGraph()`.
+ * The delimiter is auto-detected by PapaParse (comma, semicolon, pipe, tab, etc.).
+ *
+ * @example
+ * ```ts
+ * const data = fromCSV('Name,Revenue\nAcme,1000\nGlobex,2000');
+ * const data = fromCSV('Name;Revenue\nAcme;1000\nGlobex;2000'); // semicolon-delimited
+ * sdk.generateGraph({ config: { data }, userPrompt: 'bar chart' });
+ * ```
+ */
+export declare const fromCSV: (input: string, options?: DelimitedParseOptions) => Data;

package/dist/from-json-DC712HdK.js

@@ -0,0 +1,48 @@
+var w = (r, n) => {
+  const e = typeof r == "string" ? y(r, n) : r;
+  if (Array.isArray(e)) return c(e);
+  if (f(e)) return m(e);
+  throw new Error("Unsupported JSON dataset: expected an array of row objects or a { columns, rows } object.");
+}, a = (r) => typeof r == "object" && r !== null && !Array.isArray(r), i = (r) => r == null ? null : typeof r == "number" ? Number.isFinite(r) ? r : null : typeof r == "string" ? r : typeof r == "boolean" ? String(r) : JSON.stringify(r), y = (r, n) => {
+  const e = n?.maxFileSize ?? 5, o = e * 1024 * 1024, t = new TextEncoder().encode(r).byteLength;
+  if (t > o) throw new Error(`Input size (${t} bytes) exceeds the maximum allowed size of ${o} bytes (${e} MB).`);
+  try {
+    return JSON.parse(r);
+  } catch (s) {
+    throw new Error(`Invalid JSON: ${s instanceof Error ? s.message : "could not parse"}`);
+  }
+}, c = (r) => {
+  const n = [], e = /* @__PURE__ */ new Set();
+  for (const o of r) {
+    if (!a(o)) throw new Error("Each JSON row must be an object mapping column names to values.");
+    for (const t of Object.keys(o)) e.has(t) || (e.add(t), n.push(t));
+  }
+  return {
+    columns: n.map((o) => ({ key: o })),
+    rows: r.map((o) => {
+      const t = {};
+      for (const s of n) t[s] = i(o[s]);
+      return t;
+    })
+  };
+}, f = (r) => a(r) && Array.isArray(r.columns) && Array.isArray(r.rows), m = (r) => {
+  const n = r.columns.map((e) => {
+    if (!a(e) || typeof e.key != "string" || e.key.length === 0) throw new Error('Each JSON column must be an object with a non-empty string "key".');
+    return e.label !== void 0 ? {
+      key: e.key,
+      label: String(e.label)
+    } : { key: e.key };
+  });
+  return {
+    columns: n,
+    rows: r.rows.map((e) => {
+      if (!a(e)) throw new Error("Each JSON row must be an object mapping column keys to values.");
+      const o = {};
+      for (const t of n) o[t.key] = i(e[t.key]);
+      return o;
+    })
+  };
+};
+export {
+  w as t
+};

package/dist/from-json-lzRNXlod.cjs

@@ -0,0 +1 @@
+var c=(r,n)=>{const e=typeof r=="string"?y(r,n):r;if(Array.isArray(e))return f(e);if(m(e))return w(e);throw new Error("Unsupported JSON dataset: expected an array of row objects or a { columns, rows } object.")},a=r=>typeof r=="object"&&r!==null&&!Array.isArray(r),i=r=>r==null?null:typeof r=="number"?Number.isFinite(r)?r:null:typeof r=="string"?r:typeof r=="boolean"?String(r):JSON.stringify(r),y=(r,n)=>{const e=n?.maxFileSize??5,o=e*1024*1024,t=new TextEncoder().encode(r).byteLength;if(t>o)throw new Error(`Input size (${t} bytes) exceeds the maximum allowed size of ${o} bytes (${e} MB).`);try{return JSON.parse(r)}catch(s){throw new Error(`Invalid JSON: ${s instanceof Error?s.message:"could not parse"}`)}},f=r=>{const n=[],e=new Set;for(const o of r){if(!a(o))throw new Error("Each JSON row must be an object mapping column names to values.");for(const t of Object.keys(o))e.has(t)||(e.add(t),n.push(t))}return{columns:n.map(o=>({key:o})),rows:r.map(o=>{const t={};for(const s of n)t[s]=i(o[s]);return t})}},m=r=>a(r)&&Array.isArray(r.columns)&&Array.isArray(r.rows),w=r=>{const n=r.columns.map(e=>{if(!a(e)||typeof e.key!="string"||e.key.length===0)throw new Error('Each JSON column must be an object with a non-empty string "key".');return e.label!==void 0?{key:e.key,label:String(e.label)}:{key:e.key}});return{columns:n,rows:r.rows.map(e=>{if(!a(e))throw new Error("Each JSON row must be an object mapping column keys to values.");const o={};for(const t of n)o[t.key]=i(e[t.key]);return o})}};Object.defineProperty(exports,"fromJSON",{enumerable:!0,get:function(){return c}});

package/dist/{json.d.ts → from-json.d.ts}

@@ -1,17 +1,6 @@
-import { VizLocale, GraphConfig } from '@graphysdk/core/node';
-
-/** The `data` shape returned by all parsers — same as `GraphConfig['data']`. */
-type Data = GraphConfig['data'];
-/** Shared base options for all parsers. */
-interface BaseParseOptions {
-    /** Locale for number parsing. Determines thousand/decimal separator conventions. @default 'EN_US' */
-    locale?: VizLocale;
-    /** Maximum allowed input size in megabytes. @default 5 */
-    maxFileSize?: number;
-}
-
+import { BaseParseOptions, Data } from './types';
 /** A JSON dataset given explicitly as `{ columns, rows }`; the declared column keys drive which fields each row contributes. */
-interface JsonTable {
+export interface JsonTable {
     columns: ReadonlyArray<{
         key: string;
         label?: string;
@@ -19,7 +8,7 @@ interface JsonTable {
     rows: ReadonlyArray<Record<string, unknown>>;
 }
 /** Accepted JSON dataset inputs: a raw JSON string, an array of row objects, or a `{ columns, rows }` table. */
-type JsonInput = string | ReadonlyArray<Record<string, unknown>> | JsonTable;
+export type JsonInput = string | ReadonlyArray<Record<string, unknown>> | JsonTable;
 /**
  * Parses a JSON dataset into the `Data` shape expected by `generateGraph()`. Accepts a raw JSON string, an
  * array of row objects (columns are inferred as the union of keys, in first-seen order), or an explicit
@@ -33,7 +22,4 @@ type JsonInput = string | ReadonlyArray<Record<string, unknown>> | JsonTable;
  * const data = fromJSON({ columns: [{ key: 'category' }], rows: [{ category: 'Q1' }] });
  * ```
  */
-declare const fromJSON: (input: JsonInput, options?: BaseParseOptions) => Data;
-
-export { fromJSON };
-export type { BaseParseOptions, JsonInput, JsonTable };
+export declare const fromJSON: (input: JsonInput, options?: BaseParseOptions) => Data;

package/dist/from-spreadsheet-D2kWRyr3.js

@@ -0,0 +1,79 @@
+import { n as y, t as C } from "./map-rows-GOmUltJ3.js";
+import "./constants-PA0Uh9bi.js";
+import b from "exceljs";
+var v = (t) => {
+  const { value: e } = t;
+  if (e == null) return null;
+  if (typeof e == "number") return e;
+  if (typeof e == "string") return e === "" ? null : e;
+  if (typeof e == "boolean") return e ? 1 : 0;
+  if (e instanceof Date) return e.toISOString();
+  if (E(e)) {
+    if (typeof e.result == "number") return e.result;
+    if (typeof e.result == "string") return e.result === "" ? null : e.result;
+    if (typeof e.result == "boolean") return e.result ? 1 : 0;
+    if (e.result instanceof Date) return e.result.toISOString();
+  }
+  const r = t.text;
+  return r === "" ? null : r;
+}, E = (t) => typeof t == "object" && t !== null && "formula" in t, R = [
+  "dataValidations",
+  "conditionalFormatting",
+  "sheetProtection"
+];
+async function $(t) {
+  const e = new b.Workbook();
+  return await e.xlsx.load(t, { ignoreNodes: R }), e;
+}
+var _ = (t, e) => f(t, e), A = (t, e) => f(t, e), I = (t, e) => f(t, e), k = (t, e) => {
+  if (e === void 0) return t.worksheets[0];
+  if (typeof e == "number") {
+    const n = t.worksheets[e];
+    if (!n) throw new Error(`Sheet index ${e} is out of range. Workbook has ${t.worksheets.length} sheet(s).`);
+    return n;
+  }
+  const r = t.getWorksheet(e);
+  if (!r) {
+    const n = t.worksheets.map((a) => `"${a.name}"`).join(", ");
+    throw new Error(`Sheet "${e}" not found. Available sheets: ${n}`);
+  }
+  return r;
+}, f = async (t, e) => {
+  const r = (e?.maxFileSize ?? 5) * 1024 * 1024;
+  if (t.byteLength > r) throw new Error(`Input size (${t.byteLength} bytes) exceeds the maximum allowed size of ${r} bytes (${e?.maxFileSize ?? 5} MB).`);
+  const n = e?.locale ?? "EN_US", a = await $(t), s = k(a, e?.sheet);
+  if (!s || s.rowCount === 0) return {
+    columns: [],
+    rows: []
+  };
+  const l = s.columnCount;
+  if (l === 0) return {
+    columns: [],
+    rows: []
+  };
+  const g = s.getRow(1), w = [];
+  for (let o = 1; o <= l; o++) {
+    const m = g.getCell(o).value;
+    w.push(String(m ?? ""));
+  }
+  const h = y(w, l), x = e?.maxRows ?? 1e5, d = e?.maxCells ?? 5e6, S = [];
+  let i = 0, u = 0;
+  for (let o = 2; o <= s.rowCount; o++) {
+    if (i++, i > x) throw new Error(`Row limit exceeded: processed ${i} rows (maximum: ${x}). Use the maxRows option to increase the limit.`);
+    if (u += l, u > d) throw new Error(`Cell limit exceeded: processed ${u} cells (maximum: ${d}). Use the maxCells option to increase the limit.`);
+    const m = s.getRow(o), p = [];
+    for (let c = 1; c <= l; c++) p.push(v(m.getCell(c)));
+    S.push(p);
+  }
+  return {
+    columns: h,
+    rows: C(S, h, n)
+  };
+};
+export {
+  v as a,
+  $ as i,
+  A as n,
+  _ as r,
+  I as t
+};

package/dist/from-spreadsheet-EfBhqj2z.cjs

@@ -0,0 +1 @@
+const m=require("./map-rows-1hzHO_rN.cjs"),P=require("./constants-BSk6SyUk.cjs");let w=require("exceljs");w=m.__toESM(w,1);var p=t=>{const{value:e}=t;if(e==null)return null;if(typeof e=="number")return e;if(typeof e=="string")return e===""?null:e;if(typeof e=="boolean")return e?1:0;if(e instanceof Date)return e.toISOString();if($(e)){if(typeof e.result=="number")return e.result;if(typeof e.result=="string")return e.result===""?null:e.result;if(typeof e.result=="boolean")return e.result?1:0;if(e.result instanceof Date)return e.result.toISOString()}const r=t.text;return r===""?null:r},$=t=>typeof t=="object"&&t!==null&&"formula"in t,k=["dataValidations","conditionalFormatting","sheetProtection"];async function C(t){const e=new w.default.Workbook;return await e.xlsx.load(t,{ignoreNodes:k}),e}var O=(t,e)=>d(t,e),R=(t,e)=>d(t,e),E=(t,e)=>d(t,e),j=(t,e)=>{if(e===void 0)return t.worksheets[0];if(typeof e=="number"){const n=t.worksheets[e];if(!n)throw new Error(`Sheet index ${e} is out of range. Workbook has ${t.worksheets.length} sheet(s).`);return n}const r=t.getWorksheet(e);if(!r){const n=t.worksheets.map(u=>`"${u.name}"`).join(", ");throw new Error(`Sheet "${e}" not found. Available sheets: ${n}`)}return r},d=async(t,e)=>{const r=(e?.maxFileSize??5)*1024*1024;if(t.byteLength>r)throw new Error(`Input size (${t.byteLength} bytes) exceeds the maximum allowed size of ${r} bytes (${e?.maxFileSize??5} MB).`);const n=e?.locale??"EN_US",u=await C(t),s=j(u,e?.sheet);if(!s||s.rowCount===0)return{columns:[],rows:[]};const l=s.columnCount;if(l===0)return{columns:[],rows:[]};const v=s.getRow(1),h=[];for(let o=1;o<=l;o++){const c=v.getCell(o).value;h.push(String(c??""))}const x=m.buildColumns(h,l),b=e?.maxRows??1e5,g=e?.maxCells??5e6,y=[];let i=0,a=0;for(let o=2;o<=s.rowCount;o++){if(i++,i>b)throw new Error(`Row limit exceeded: processed ${i} rows (maximum: ${b}). Use the maxRows option to increase the limit.`);if(a+=l,a>g)throw new Error(`Cell limit exceeded: processed ${a} cells (maximum: ${g}). Use the maxCells option to increase the limit.`);const c=s.getRow(o),S=[];for(let f=1;f<=l;f++)S.push(p(c.getCell(f)));y.push(S)}return{columns:x,rows:m.mapRows(y,x,n)}};Object.defineProperty(exports,"extractCellPrimitive",{enumerable:!0,get:function(){return p}});Object.defineProperty(exports,"fromODS",{enumerable:!0,get:function(){return E}});Object.defineProperty(exports,"fromXLS",{enumerable:!0,get:function(){return R}});Object.defineProperty(exports,"fromXLSX",{enumerable:!0,get:function(){return O}});Object.defineProperty(exports,"loadWorkbookFromXlsxBuffer",{enumerable:!0,get:function(){return C}});

package/dist/from-spreadsheet.d.ts

@@ -0,0 +1,20 @@
+import { Data, SpreadsheetParseOptions } from './types';
+/**
+ * Parses an XLSX file into the `Data` shape expected by `generateGraph()`.
+ */
+export declare const fromXLSX: (input: ArrayBuffer, options?: SpreadsheetParseOptions) => Promise<Data>;
+/**
+ * Parses an XLS file into the `Data` shape expected by `generateGraph()`.
+ *
+ * **Note:** Uses ExcelJS which natively supports XLSX format. Modern `.xls` files
+ * (produced by Excel 2007+) that are actually XLSX will parse correctly.
+ * Genuine legacy binary XLS (BIFF) files are not supported.
+ */
+export declare const fromXLS: (input: ArrayBuffer, options?: SpreadsheetParseOptions) => Promise<Data>;
+/**
+ * Parses an ODS (OpenDocument Spreadsheet) file into the `Data` shape expected by `generateGraph()`.
+ *
+ * **Note:** Uses ExcelJS which natively supports XLSX format. ODS files that are
+ * saved in XLSX-compatible format will parse correctly. Native ODS format is not supported.
+ */
+export declare const fromODS: (input: ArrayBuffer, options?: SpreadsheetParseOptions) => Promise<Data>;

package/dist/from-tsv-B02B59Ey.cjs

@@ -0,0 +1 @@
+const t=require("./parse-delimited-BSoFIVFq.cjs");var i=(e,r)=>t.parseDelimited(e,"	",r);Object.defineProperty(exports,"fromTSV",{enumerable:!0,get:function(){return i}});

package/dist/from-tsv-CPj6UzXC.js

@@ -0,0 +1,5 @@
+import { t as e } from "./parse-delimited-qsjX5KAa.js";
+var m = (r, t) => e(r, "	", t);
+export {
+  m as t
+};

package/dist/from-tsv.d.ts

@@ -0,0 +1,11 @@
+import { Data, DelimitedParseOptions } from './types';
+/**
+ * Parses a TSV string into the `Data` shape expected by `generateGraph()`.
+ *
+ * @example
+ * ```ts
+ * const data = fromTSV('Name\tRevenue\nAcme\t1000');
+ * sdk.generateGraph({ config: { data }, userPrompt: 'bar chart' });
+ * ```
+ */
+export declare const fromTSV: (input: string, options?: DelimitedParseOptions) => Data;

package/dist/index-buffer.d.ts

@@ -0,0 +1,2 @@
+export { fromBuffer } from './parse-string';
+export type { BaseParseOptions, BinaryFileFormat, Data, SpreadsheetParseOptions } from './types';

package/dist/index-csv.d.ts

@@ -0,0 +1,2 @@
+export { fromCSV } from './from-csv';
+export type { BaseParseOptions, DelimitedParseOptions } from './types';

package/dist/index-file.d.ts

@@ -0,0 +1,2 @@
+export { fromFile } from './parse-file';
+export type { BaseParseOptions, Data, FileParseOptions, SpreadsheetParseOptions } from './types';

package/dist/index-json.d.ts

@@ -0,0 +1,3 @@
+export type { JsonInput, JsonTable } from './from-json';
+export { fromJSON } from './from-json';
+export type { BaseParseOptions } from './types';

package/dist/index-ods.d.ts

@@ -0,0 +1,2 @@
+export { fromODS } from './from-spreadsheet';
+export type { BaseParseOptions, SpreadsheetParseOptions } from './types';

package/dist/index-text.d.ts

@@ -0,0 +1,2 @@
+export { fromText } from './parse-string';
+export type { BaseParseOptions, Data, DelimitedParseOptions, TextFileFormat } from './types';

package/dist/index-tsv.d.ts

@@ -0,0 +1,2 @@
+export { fromTSV } from './from-tsv';
+export type { BaseParseOptions, DelimitedParseOptions } from './types';

package/dist/index-url.d.ts

@@ -0,0 +1,2 @@
+export { fromURL } from './parse-url';
+export type { Data, URLParseOptions } from './types';

package/dist/index-xls.d.ts

@@ -0,0 +1,2 @@
+export { fromXLS } from './from-spreadsheet';
+export type { BaseParseOptions, SpreadsheetParseOptions } from './types';

package/dist/index-xlsx.d.ts

@@ -0,0 +1,8 @@
+export { fromXLSX } from './from-spreadsheet';
+export { extractCellPrimitive } from './spreadsheet/cell-primitive';
+export { loadWorkbookFromXlsxBuffer } from './spreadsheet/load-workbook';
+export type { ReadSheetRegionOptions, ReadSheetRegionResult } from './spreadsheet/read-region';
+export { DEFAULT_READ_REGION_MAX_CELLS, readIslandRegion, readSheetRegion } from './spreadsheet/read-region';
+export type { BuildWorkbookIndexOptions, IslandEntry, SheetIndexEntry, WorkbookIndex, } from './spreadsheet/workbook-index';
+export { buildWorkbookIndex, buildWorkbookIndexFromXlsxBuffer, DEFAULT_MAX_WORKBOOK_INDEX_NON_EMPTY_CELLS, WORKBOOK_INDEX_SCHEMA_VERSION, } from './spreadsheet/workbook-index';
+export type { BaseParseOptions, SpreadsheetParseOptions } from './types';

package/dist/index.cjs

@@ -1 +0,0 @@
-"use strict";

package/dist/index.d.ts

@@ -1,44 +1,8 @@
-import { VizLocale, GraphConfig } from '@graphysdk/core/node';
-
-/** The `data` shape returned by all parsers — same as `GraphConfig['data']`. */
-type Data = GraphConfig['data'];
-/** Supported file formats. */
-type FileFormat = 'csv' | 'tsv' | 'json' | 'xlsx' | 'xls' | 'ods';
-/** Text-based formats that accept string input. */
-type TextFileFormat = 'csv' | 'tsv' | 'json';
-/** Binary formats that accept ArrayBuffer input. */
-type BinaryFileFormat = 'xlsx' | 'xls' | 'ods';
-/** Shared base options for all parsers. */
-interface BaseParseOptions {
-    /** Locale for number parsing. Determines thousand/decimal separator conventions. @default 'EN_US' */
-    locale?: VizLocale;
-    /** Maximum allowed input size in megabytes. @default 5 */
-    maxFileSize?: number;
-}
-/** Options for CSV / TSV parsing. */
-interface DelimitedParseOptions extends BaseParseOptions {
-    /** Whether the first row contains column headers. @default true */
-    hasHeader?: boolean;
-}
-/** Options for XLSX / XLS / ODS parsing. */
-interface SpreadsheetParseOptions extends BaseParseOptions {
-    /** Sheet to parse — name (string) or 0-based index (number). @default 0 (first sheet) */
-    sheet?: string | number;
-    /** Maximum number of data rows to process. @default 100_000 */
-    maxRows?: number;
-    /** Maximum total cells to process. @default 5_000_000 */
-    maxCells?: number;
-}
-/** Options specific to URL fetching. */
-interface URLParseOptions extends SpreadsheetParseOptions {
-    /** Custom headers to include in the fetch request. */
-    headers?: Record<string, string>;
-    /** Whether the first row contains column headers. @default true */
-    hasHeader?: boolean;
-    /** Fetch timeout in milliseconds. @default 30_000 */
-    timeout?: number;
-    /** Optional external abort signal for cancellation. */
-    signal?: AbortSignal;
-}
-
-export type { BaseParseOptions, BinaryFileFormat, Data, DelimitedParseOptions, FileFormat, SpreadsheetParseOptions, TextFileFormat, URLParseOptions };
+/**
+ * Root entrypoint exports lightweight CSV/TSV parsers.
+ * For spreadsheet formats (XLSX, XLS, ODS), use format-specific sub-path imports:
+ * - `@graphysdk/data-import-utils/xlsx`
+ * - `@graphysdk/data-import-utils/file`
+ * - `@graphysdk/data-import-utils/url`
+ */
+export type { BaseParseOptions, BinaryFileFormat, Data, DelimitedParseOptions, FileFormat, SpreadsheetParseOptions, TextFileFormat, URLParseOptions, } from './types';

package/dist/index.mjs

@@ -1 +0,0 @@
-

package/dist/json.cjs

@@ -1 +1 @@
-"use strict";const r=r=>"object"==typeof r&&null!==r&&!Array.isArray(r),e=r=>null==r?null:"number"==typeof r?Number.isFinite(r)?r:null:"string"==typeof r?r:"boolean"==typeof r?String(r):JSON.stringify(r);exports.fromJSON=(o,t)=>{const n="string"==typeof o?((r,e)=>{var o;const t=null!==(o=null==e?void 0:e.maxFileSize)&&void 0!==o?o:5,n=1024*t*1024,s=(new TextEncoder).encode(r).byteLength;if(s>n)throw new Error(`Input size (${s} bytes) exceeds the maximum allowed size of ${n} bytes (${t} MB).`);try{return JSON.parse(r)}catch(r){throw new Error(`Invalid JSON: ${r instanceof Error?r.message:"could not parse"}`)}})(o,t):o;if(Array.isArray(n))return(o=>{const t=[],n=new Set;for(const e of o){if(!r(e))throw new Error("Each JSON row must be an object mapping column names to values.");for(const r of Object.keys(e))n.has(r)||(n.add(r),t.push(r))}return{columns:t.map(r=>({key:r})),rows:o.map(r=>{const o={};for(const n of t)o[n]=e(r[n]);return o})}})(n);if((e=>r(e)&&Array.isArray(e.columns)&&Array.isArray(e.rows))(n))return(o=>{const t=o.columns.map(e=>{if(!r(e)||"string"!=typeof e.key||0===e.key.length)throw new Error('Each JSON column must be an object with a non-empty string "key".');return void 0!==e.label?{key:e.key,label:String(e.label)}:{key:e.key}}),n=o.rows.map(o=>{if(!r(o))throw new Error("Each JSON row must be an object mapping column keys to values.");const n={};for(const r of t)n[r.key]=e(o[r.key]);return n});return{columns:t,rows:n}})(n);throw new Error("Unsupported JSON dataset: expected an array of row objects or a { columns, rows } object.")};
+Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./from-json-lzRNXlod.cjs");exports.fromJSON=e.fromJSON;

package/dist/json.mjs

@@ -1 +1,4 @@
-const r=r=>"object"==typeof r&&null!==r&&!Array.isArray(r),e=r=>null==r?null:"number"==typeof r?Number.isFinite(r)?r:null:"string"==typeof r?r:"boolean"==typeof r?String(r):JSON.stringify(r),o=(o,t)=>{const n="string"==typeof o?((r,e)=>{var o;const t=null!==(o=null==e?void 0:e.maxFileSize)&&void 0!==o?o:5,n=1024*t*1024,s=(new TextEncoder).encode(r).byteLength;if(s>n)throw new Error(`Input size (${s} bytes) exceeds the maximum allowed size of ${n} bytes (${t} MB).`);try{return JSON.parse(r)}catch(r){throw new Error(`Invalid JSON: ${r instanceof Error?r.message:"could not parse"}`)}})(o,t):o;if(Array.isArray(n))return(o=>{const t=[],n=new Set;for(const e of o){if(!r(e))throw new Error("Each JSON row must be an object mapping column names to values.");for(const r of Object.keys(e))n.has(r)||(n.add(r),t.push(r))}return{columns:t.map(r=>({key:r})),rows:o.map(r=>{const o={};for(const n of t)o[n]=e(r[n]);return o})}})(n);if((e=>r(e)&&Array.isArray(e.columns)&&Array.isArray(e.rows))(n))return(o=>{const t=o.columns.map(e=>{if(!r(e)||"string"!=typeof e.key||0===e.key.length)throw new Error('Each JSON column must be an object with a non-empty string "key".');return void 0!==e.label?{key:e.key,label:String(e.label)}:{key:e.key}}),n=o.rows.map(o=>{if(!r(o))throw new Error("Each JSON row must be an object mapping column keys to values.");const n={};for(const r of t)n[r.key]=e(o[r.key]);return n});return{columns:t,rows:n}})(n);throw new Error("Unsupported JSON dataset: expected an array of row objects or a { columns, rows } object.")};export{o as fromJSON};
+import { t as r } from "./from-json-DC712HdK.js";
+export {
+  r as fromJSON
+};

package/dist/map-rows-1hzHO_rN.cjs

@@ -0,0 +1 @@
+var s=Object.create,i=Object.defineProperty,p=Object.getOwnPropertyDescriptor,b=Object.getOwnPropertyNames,f=Object.getPrototypeOf,_=Object.prototype.hasOwnProperty,v=(r,n,e,u)=>{if(n&&typeof n=="object"||typeof n=="function")for(var t=b(n),a=0,o=t.length,l;a<o;a++)l=t[a],!_.call(r,l)&&l!==e&&i(r,l,{get:(c=>n[c]).bind(null,l),enumerable:!(u=p(n,l))||u.enumerable});return r},g=(r,n,e)=>(e=r!=null?s(f(r)):{},v(n||!r||!r.__esModule?i(e,"default",{value:r,enumerable:!0}):e,r)),d=r=>`c${r+1}`,O=(r,n)=>{const e=[];for(let u=0;u<n;u++){const t=r?.[u]?.trim(),a={key:d(u)};t&&(a.label=t),e.push(a)}return e},m=100,P=/[^\p{ASCII}]/u,y=/[\u2012\u2013\u2014\u2212](?=\d)/g,N=/\u00A0/g,j=/^-?(?:\d{1,3}(?:,\d{3})*|\d+)(?:\.\d+)?$/,R=/^-?(?:\d{1,3}(?:\.\d{3})*|\d+)(?:,\d+)?$/,E=new Set(["PT_PT","AR"]),h=(r,n="EN_US")=>{let e;if(P.test(r)?e=r.replace(y,"-").replace(N," ").trim():e=r.trim(),e==="")return null;if(e.length>m)return e;if(E.has(n)){if(R.test(e)){const u=e.replace(/\./g,"").replace(",","."),t=Number(u);if(Number.isFinite(t))return t}}else if(j.test(e)){const u=e.replace(/,/g,""),t=Number(u);if(Number.isFinite(t))return t}return e},w=(r,n,e)=>r.map(u=>{const t={};for(let a=0;a<n.length;a++){const o=n[a];if(!o)continue;const l=u[a];l==null||l===""?t[o.key]=null:typeof l=="number"?t[o.key]=l:t[o.key]=h(String(l),e)}return t});Object.defineProperty(exports,"__toESM",{enumerable:!0,get:function(){return g}});Object.defineProperty(exports,"buildColumns",{enumerable:!0,get:function(){return O}});Object.defineProperty(exports,"mapRows",{enumerable:!0,get:function(){return w}});