juxscript 1.1.236 → 1.1.238

package/index.d.ts

@@ -8,7 +8,7 @@ import { checkbox } from './lib/components/checkbox.js';
 import { code } from './lib/components/code.js';
 import { container } from './lib/components/container.js';
 import { data } from './lib/components/data.js';
-import { data as pipeline } from './lib/data/DataPipeline.js';
+import { gather } from './lib/data/DataPipeline.js';
 import { datepicker } from './lib/components/datepicker.js';
 import { dialog } from './lib/components/dialog.js';
 import { divider } from './lib/components/divider.js';
@@ -58,8 +58,8 @@ export { DataFrameSource, dataFrameSource } from './lib/storage/DataFrameSource.
 export type { SourceOptions, APIOptions, StreamOptions, MultiSheetResult } from './lib/storage/DataFrameSource.js';
 export { indexedDBDriver } from './lib/storage/IndexedDBDriver.js';
 export { fileStorage } from './lib/storage/FileStorage.js';
-export { data as pipeline, DataPipeline } from './lib/data/DataPipeline.js';
-export type { PipelineOptions, FetchOptions, IntoOptions } from './lib/data/DataPipeline.js';
+export { gather, DataPipeline } from './lib/data/DataPipeline.js';
+export type { PipelineOptions, FetchOptions, GatherOptions, IntoOptions } from './lib/data/DataPipeline.js';
 export { dataframe } from './lib/components/dataframe.js';
 import { VStack, vstack } from './lib/components/stack/VStack.js';
 import { HStack, hstack } from './lib/components/stack/HStack.js';
@@ -89,6 +89,7 @@ export declare const jux: {
     dropdownMenu: typeof dropdownMenu;
     element: typeof element;
     fileupload: typeof fileupload;
+    gather: typeof gather;
     grid: typeof grid;
     heading: typeof heading;
     hero: typeof hero;
@@ -106,7 +107,6 @@ export declare const jux: {
     nav: typeof nav;
     paragraph: typeof paragraph;
     pen: typeof pen;
-    pipeline: typeof pipeline;
     progress: typeof progress;
     radio: typeof radio;
     req: import("./lib/components/req.js").Req;

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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"}

package/index.js

@@ -8,7 +8,7 @@ import { checkbox } from './lib/components/checkbox.js';
 import { code } from './lib/components/code.js';
 import { container } from './lib/components/container.js';
 import { data } from './lib/components/data.js';
-import { data as pipeline } from './lib/data/DataPipeline.js';
+import { gather } from './lib/data/DataPipeline.js';
 import { datepicker } from './lib/components/datepicker.js';
 import { dialog } from './lib/components/dialog.js';
 import { divider } from './lib/components/divider.js';
@@ -60,7 +60,7 @@ export { DataFrameSource, dataFrameSource } from './lib/storage/DataFrameSource.
 export { indexedDBDriver } from './lib/storage/IndexedDBDriver.js';
 export { fileStorage } from './lib/storage/FileStorage.js';
 // Data Pipeline
-export { data as pipeline, DataPipeline } from './lib/data/DataPipeline.js';
+export { gather, DataPipeline } from './lib/data/DataPipeline.js';
 // DataFrame UI Component (separate from data layer)
 export { dataframe } from './lib/components/dataframe.js';
 // Import Stack components (already added earlier)
@@ -94,6 +94,7 @@ export const jux = {
     dropdownMenu,
     element,
     fileupload,
+    gather,
     grid,
     heading,
     hero,
@@ -111,7 +112,6 @@ export const jux = {
     nav,
     paragraph,
     pen,
-    pipeline,
     progress,
     radio,
     req,

package/lib/data/DataPipeline.d.ts

@@ -9,157 +9,105 @@ export interface FetchOptions {
     headerRow?: number;
     mimeType?: 'csv' | 'tsv' | 'json' | 'auto';
 }
+export interface GatherOptions extends FetchOptions {
+    /** Authorization bearer token */
+    bearer?: string;
+    /** API key (sent as x-api-key header) */
+    apiKey?: string;
+    /** Custom headers for URL fetches */
+    headers?: Record<string, string>;
+    /** IndexedDB database name override */
+    dbName?: string;
+    /** IndexedDB store name override */
+    storeName?: string;
+}
+export interface IntoOptions {
+    /** Override which columns to use (for Table targets) */
+    columns?: string[];
+    /** Column name → display label mapping */
+    columnLabels?: Record<string, string>;
+    /** Key for option labels (Dropdown/Select/List targets) */
+    labelKey?: string;
+    /** Key for option values (Dropdown/Select targets) */
+    valueKey?: string;
+}
 /**
  * DataPipeline — Headless, promise-based data loading and transformation.
  *
  * Usage:
- *   const df = await data.fromUrl('https://example.com/report.csv').result();
- *   const df = await data.fromStorage('patients').result();
- *   const df = await data.fromJson(apiResponse).result();
- *
- *   // Transform and distribute:
- *   await data.fromUrl(url)
- *       .transform(df => df.select('name', 'age').filter(r => r.age > 30))
- *       .into(myTable);
- *
- *   await data.fromStorage('encounters')
- *       .transform(df => df.distinct('provider'))
- *       .into(myDropdown, { labelKey: 'provider', valueKey: 'provider' });
+ *   const df = await jux.gather('raw/myfile.xlsx').result();
+ *   const df = await jux.gather('https://api.com/data', { bearer: 'xxx' }).result();
+ *   const df = await jux.gather(myUpload).select('name').result();
+ *   const df = await jux.gather([{a:1}, {b:2}]).result();
+ *   await jux.gather(key).filter(r => r.active).intoTable(myTable);
  */
 export declare class DataPipeline {
     private _driver;
     private _pending;
     private _transforms;
+    private _gatherOptions;
     constructor(options?: PipelineOptions);
     /**
-     * Load from IndexedDB by key
-     */
+     * Auto-detect source type and load accordingly.
+     *
+     * - string starting with http/https → URL fetch
+     * - string → IndexedDB storage key
+     * - File → parse file
+     * - Array → row objects
+     * - DataFrame → clone
+     * - object with .storageKey → FileUpload cached key
+     * - object with string keys + array values → column-oriented data
+     */
+    from(source: any, options?: GatherOptions): this;
     fromStorage(key: string): this;
-    /**
-     * Load from a URL (CSV, TSV, or JSON)
-     */
-    fromUrl(url: string, options?: FetchOptions): this;
-    /**
-     * Load from a File object directly
-     */
+    fromUrl(url: string, options?: GatherOptions): this;
     fromFile(file: File, options?: FetchOptions): this;
-    /**
-     * Load from an array of row objects
-     */
     fromRows(rows: Record<string, any>[], columns?: string[]): this;
-    /**
-     * Load from column-oriented data
-     */
     fromColumns(columns: Record<string, any[]>): this;
-    /**
-     * Load from a JSON response (array of objects or column-oriented)
-     */
     fromJson(json: Record<string, any>[] | Record<string, any[]> | string): this;
-    /**
-     * Load from a FileUpload component's cached storage key.
-     * Requires .cache() enabled on the FileUpload and a file already uploaded.
-     *
-     * Usage:
-     *   await data().fromUpload(myUpload).select('name').into(myTable);
-     */
     fromUpload(upload: any): this;
-    /**
-     * Start from an existing DataFrame
-     */
-    from(df: DataFrame): this;
-    /**
-     * Apply an arbitrary transform
-     */
     transform(fn: (df: DataFrame) => DataFrame): this;
-    /**
-     * Select columns
-     */
     select(...cols: string[]): this;
-    /**
-     * Filter rows
-     */
     filter(predicate: (row: Record<string, any>, index: number) => boolean): this;
-    /**
-     * Sort by column
-     */
     sort(column: string, descending?: boolean): this;
-    /**
-     * Take first N rows
-     */
     head(n?: number): this;
-    /**
-     * Take last N rows
-     */
     tail(n?: number): this;
-    /**
-     * Rename columns
-     */
     rename(mapping: Record<string, string>): this;
-    /**
-     * Add a computed column
-     */
     withColumn(name: string, fn: (row: Record<string, any>, index: number) => any): this;
-    /**
-     * Drop nulls
-     */
     dropna(columns?: string[]): this;
-    /**
-     * Drop duplicates
-     */
     dropDuplicates(columns?: string[]): this;
-    /**
-     * Execute the pipeline and return the DataFrame
-     */
     result(): Promise<DataFrame>;
-    /**
-     * Execute and return rows as plain objects
-     */
     toRows(): Promise<Record<string, any>[]>;
-    /**
-     * Execute and return a single column as an array
-     */
     toArray(column: string): Promise<any[]>;
-    /**
-     * Execute and return distinct values from a column
-     */
     toDistinct(column: string): Promise<any[]>;
-    /**
-     * Execute and push results into a jux component.
-     *
-     * Supported targets:
-     * - Table: sets columns + rows
-     * - Dropdown/Select: sets options from labelKey/valueKey
-     * - List: sets items
-     * - DataFrameComponent: loads data
-     * - Any object with a .rows() or .options() or .items() method
-     */
+    toOptions(labelKey: string, valueKey?: string): Promise<{
+        label: string;
+        value: any;
+    }[]>;
+    toList(column: string): Promise<string[]>;
+    intoTable(table: any, columnLabels?: Record<string, string>): Promise<DataFrame>;
+    intoDropdown(dropdown: any, labelKey: string, valueKey?: string): Promise<DataFrame>;
+    intoList(list: any, column: string): Promise<DataFrame>;
     into(target: any, options?: IntoOptions): Promise<DataFrame>;
-    /**
-     * Execute and persist to IndexedDB
-     */
     store(key: string, metadata?: Record<string, any>): Promise<DataFrame>;
+    private _loadFromStorage;
     private _loadFromUrl;
     private _loadFromFile;
     private _detectMimeType;
 }
-export interface IntoOptions {
-    /** Override which columns to use (for Table targets) */
-    columns?: string[];
-    /** Column name → display label mapping */
-    columnLabels?: Record<string, string>;
-    /** Key for option labels (Dropdown/Select/List targets) */
-    labelKey?: string;
-    /** Key for option values (Dropdown/Select targets) */
-    valueKey?: string;
-}
 /**
- * Factory function — the primary entry point
+ * Factory function — primary entry point via jux.gather()
  *
- * Usage:
- *   import { data } from 'juxscript';
+ * Smart single-arg:
+ *   jux.gather('raw/myfile.xlsx')                              // storage key
+ *   jux.gather('https://api.com/data', { bearer: 'xxx' })     // URL with auth
+ *   jux.gather(myUpload)                                       // FileUpload
+ *   jux.gather([{a:1}, {b:2}])                                 // inline rows
+ *   jux.gather(existingDf)                                     // clone DataFrame
  *
- *   const df = await data().fromStorage('patients').select('name', 'dob').result();
- *   await data().fromUrl(presignedUrl).filter(r => r.status === 'active').into(myTable);
+ * Explicit source:
+ *   jux.gather().fromStorage(key)
+ *   jux.gather().fromUrl(url, opts)
  */
-export declare function data(options?: PipelineOptions): DataPipeline;
+export declare function gather(source?: any, options?: GatherOptions): DataPipeline;
 //# sourceMappingURL=DataPipeline.d.ts.map

package/lib/data/DataPipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DataPipeline.d.ts","sourceRoot":"","sources":["DataPipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAGpD,MAAM,WAAW,eAAe;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;CAC9C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,WAAW,CAAwC;gBAE/C,OAAO,GAAE,eAAoB;IAWzC;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAS9B;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,IAAI;IAMtD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,YAAiB,GAAG,IAAI;IAMtD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IAM/D;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,IAAI;IAMjD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,MAAM,GAAG,IAAI;IAO5E;;;;;;OAMG;IACH,UAAU,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI;IAgB7B;;OAEG;IACH,IAAI,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI;IAUzB;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,SAAS,KAAK,SAAS,GAAG,IAAI;IAKjD;;OAEG;IACH,MAAM,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAI/B;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI;IAI7E;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI;IAIhD;;OAEG;IACH,IAAI,CAAC,CAAC,GAAE,MAAU,GAAG,IAAI;IAIzB;;OAEG;IACH,IAAI,CAAC,CAAC,GAAE,MAAU,GAAG,IAAI;IAIzB;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAI7C;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,GAAG,GAAG,IAAI;IAIpF;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IAIhC;;OAEG;IACH,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IAQxC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,SAAS,CAAC;IAUlC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;IAI9C;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAI7C;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAIhD;;;;;;;;;OASG;IACG,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,SAAS,CAAC;IA0CtE;;OAEG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;YAU9D,YAAY;YAmBZ,aAAa;IAqB3B,OAAO,CAAC,eAAe;CAO1B;AAED,MAAM,WAAW,WAAW;IACxB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,OAAO,GAAE,eAAoB,GAAG,YAAY,CAEhE"}
+{"version":3,"file":"DataPipeline.d.ts","sourceRoot":"","sources":["DataPipeline.ts"],"names":[],"mappings":"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"}

package/lib/data/DataPipeline.js

@@ -4,88 +4,111 @@ import { TabularDriver } from '../storage/TabularDriver.js';
  * DataPipeline — Headless, promise-based data loading and transformation.
  *
  * Usage:
- *   const df = await data.fromUrl('https://example.com/report.csv').result();
- *   const df = await data.fromStorage('patients').result();
- *   const df = await data.fromJson(apiResponse).result();
- *
- *   // Transform and distribute:
- *   await data.fromUrl(url)
- *       .transform(df => df.select('name', 'age').filter(r => r.age > 30))
- *       .into(myTable);
- *
- *   await data.fromStorage('encounters')
- *       .transform(df => df.distinct('provider'))
- *       .into(myDropdown, { labelKey: 'provider', valueKey: 'provider' });
+ *   const df = await jux.gather('raw/myfile.xlsx').result();
+ *   const df = await jux.gather('https://api.com/data', { bearer: 'xxx' }).result();
+ *   const df = await jux.gather(myUpload).select('name').result();
+ *   const df = await jux.gather([{a:1}, {b:2}]).result();
+ *   await jux.gather(key).filter(r => r.active).intoTable(myTable);
  */
 export class DataPipeline {
     constructor(options = {}) {
         this._pending = null;
         this._transforms = [];
         this._driver = new TabularDriver(options.dbName ?? 'jux-dataframes', options.storeName ?? 'frames');
+        this._gatherOptions = {};
     }
     /* ═══════════════════════════════════════════════════
-     * SOURCES
+     * SMART SOURCE DETECTION
      * ═══════════════════════════════════════════════════ */
     /**
-     * Load from IndexedDB by key
+     * Auto-detect source type and load accordingly.
+     *
+     * - string starting with http/https → URL fetch
+     * - string → IndexedDB storage key
+     * - File → parse file
+     * - Array → row objects
+     * - DataFrame → clone
+     * - object with .storageKey → FileUpload cached key
+     * - object with string keys + array values → column-oriented data
      */
+    from(source, options = {}) {
+        this._transforms = [];
+        this._gatherOptions = options;
+        // Update driver if custom db/store
+        if (options.dbName || options.storeName) {
+            this._driver = new TabularDriver(options.dbName ?? 'jux-dataframes', options.storeName ?? 'frames');
+        }
+        if (source instanceof DataFrame) {
+            this._pending = Promise.resolve(source.clone());
+        }
+        else if (Array.isArray(source)) {
+            this._pending = Promise.resolve(new DataFrame(source));
+        }
+        else if (typeof source === 'string') {
+            if (/^https?:\/\//i.test(source)) {
+                this._pending = this._loadFromUrl(source, options);
+            }
+            else {
+                this._pending = this._loadFromStorage(source);
+            }
+        }
+        else if (source instanceof File) {
+            this._pending = this._loadFromFile(source, options);
+        }
+        else if (source && typeof source === 'object' && 'storageKey' in source) {
+            // FileUpload component with .cache() enabled
+            const key = source.storageKey;
+            if (!key) {
+                this._pending = Promise.reject(new Error('FileUpload has no cached storage key. Ensure .cache() is enabled and a file has been uploaded.'));
+            }
+            else {
+                this._pending = this._loadFromStorage(key);
+            }
+        }
+        else if (source && typeof source === 'object' && !Array.isArray(source)) {
+            // Column-oriented: { col1: [...], col2: [...] }
+            this._pending = Promise.resolve(new DataFrame(source));
+        }
+        else {
+            this._pending = Promise.reject(new Error('Unrecognized source type passed to gather()'));
+        }
+        return this;
+    }
+    /* ═══════════════════════════════════════════════════
+     * EXPLICIT SOURCES (still available)
+     * ═══════════════════════════════════════════════════ */
     fromStorage(key) {
         this._transforms = [];
-        this._pending = this._driver.loadByName(key).then(df => {
-            if (!df)
-                throw new Error(`No data found in storage with key: "${key}"`);
-            return df;
-        });
+        this._pending = this._loadFromStorage(key);
         return this;
     }
-    /**
-     * Load from a URL (CSV, TSV, or JSON)
-     */
     fromUrl(url, options = {}) {
         this._transforms = [];
+        this._gatherOptions = options;
         this._pending = this._loadFromUrl(url, options);
         return this;
     }
-    /**
-     * Load from a File object directly
-     */
     fromFile(file, options = {}) {
         this._transforms = [];
         this._pending = this._loadFromFile(file, options);
         return this;
     }
-    /**
-     * Load from an array of row objects
-     */
     fromRows(rows, columns) {
         this._transforms = [];
         this._pending = Promise.resolve(new DataFrame(rows, { columns }));
         return this;
     }
-    /**
-     * Load from column-oriented data
-     */
     fromColumns(columns) {
         this._transforms = [];
         this._pending = Promise.resolve(new DataFrame(columns));
         return this;
     }
-    /**
-     * Load from a JSON response (array of objects or column-oriented)
-     */
     fromJson(json) {
         this._transforms = [];
         const parsed = typeof json === 'string' ? JSON.parse(json) : json;
         this._pending = Promise.resolve(new DataFrame(parsed));
         return this;
     }
-    /**
-     * Load from a FileUpload component's cached storage key.
-     * Requires .cache() enabled on the FileUpload and a file already uploaded.
-     *
-     * Usage:
-     *   await data().fromUpload(myUpload).select('name').into(myTable);
-     */
     fromUpload(upload) {
         this._transforms = [];
         const key = upload.storageKey;
@@ -93,168 +116,139 @@ export class DataPipeline {
             this._pending = Promise.reject(new Error('FileUpload has no cached storage key. Ensure .cache() is enabled and a file has been uploaded.'));
         }
         else {
-            this._pending = this._driver.loadByName(key).then((df) => {
-                if (!df)
-                    throw new Error(`No cached data found for key: "${key}"`);
-                return df;
-            });
+            this._pending = this._loadFromStorage(key);
         }
         return this;
     }
-    /**
-     * Start from an existing DataFrame
-     */
-    from(df) {
-        this._transforms = [];
-        this._pending = Promise.resolve(df.clone());
-        return this;
-    }
     /* ═══════════════════════════════════════════════════
-     * TRANSFORMS (chained, lazy — applied on .result())
+     * TRANSFORMS (chained, lazy — applied on terminal)
      * ═══════════════════════════════════════════════════ */
-    /**
-     * Apply an arbitrary transform
-     */
     transform(fn) {
         this._transforms.push(fn);
         return this;
     }
-    /**
-     * Select columns
-     */
     select(...cols) {
         return this.transform(df => df.select(...cols));
     }
-    /**
-     * Filter rows
-     */
     filter(predicate) {
         return this.transform(df => df.filter(predicate));
     }
-    /**
-     * Sort by column
-     */
     sort(column, descending) {
         return this.transform(df => df.sort(column, descending));
     }
-    /**
-     * Take first N rows
-     */
     head(n = 5) {
         return this.transform(df => df.head(n));
     }
-    /**
-     * Take last N rows
-     */
     tail(n = 5) {
         return this.transform(df => df.tail(n));
     }
-    /**
-     * Rename columns
-     */
     rename(mapping) {
         return this.transform(df => df.rename(mapping));
     }
-    /**
-     * Add a computed column
-     */
     withColumn(name, fn) {
         return this.transform(df => df.withColumn(name, fn));
     }
-    /**
-     * Drop nulls
-     */
     dropna(columns) {
         return this.transform(df => df.dropna(columns));
     }
-    /**
-     * Drop duplicates
-     */
     dropDuplicates(columns) {
         return this.transform(df => df.dropDuplicates(columns));
     }
     /* ═══════════════════════════════════════════════════
      * TERMINAL OPERATIONS
      * ═══════════════════════════════════════════════════ */
-    /**
-     * Execute the pipeline and return the DataFrame
-     */
     async result() {
         if (!this._pending)
-            throw new Error('No data source specified. Call fromStorage(), fromUrl(), etc. first.');
+            throw new Error('No data source specified. Call gather(source) or from*(source) first.');
         let df = await this._pending;
         for (const fn of this._transforms) {
             df = fn(df);
         }
         return df;
     }
-    /**
-     * Execute and return rows as plain objects
-     */
     async toRows() {
         return (await this.result()).toRows();
     }
-    /**
-     * Execute and return a single column as an array
-     */
     async toArray(column) {
         return (await this.result()).col(column);
     }
-    /**
-     * Execute and return distinct values from a column
-     */
     async toDistinct(column) {
         return (await this.result()).distinct(column);
     }
-    /**
-     * Execute and push results into a jux component.
-     *
-     * Supported targets:
-     * - Table: sets columns + rows
-     * - Dropdown/Select: sets options from labelKey/valueKey
-     * - List: sets items
-     * - DataFrameComponent: loads data
-     * - Any object with a .rows() or .options() or .items() method
-     */
+    async toOptions(labelKey, valueKey) {
+        const df = await this.result();
+        const vKey = valueKey ?? labelKey;
+        return df.toRows().map(row => ({
+            label: String(row[labelKey] ?? ''),
+            value: row[vKey]
+        }));
+    }
+    async toList(column) {
+        const df = await this.result();
+        return df.col(column).map(v => String(v ?? ''));
+    }
+    async intoTable(table, columnLabels) {
+        const df = await this.result();
+        const columnDefs = df.columns.map(col => ({
+            key: col,
+            label: columnLabels?.[col] ?? col
+        }));
+        table.columns(columnDefs).rows(df.toRows());
+        return df;
+    }
+    async intoDropdown(dropdown, labelKey, valueKey) {
+        const df = await this.result();
+        const vKey = valueKey ?? labelKey;
+        const opts = df.toRows().map(row => ({
+            label: String(row[labelKey] ?? ''),
+            value: row[vKey]
+        }));
+        dropdown.options(opts);
+        return df;
+    }
+    async intoList(list, column) {
+        const df = await this.result();
+        list.items(df.col(column).map((v) => String(v ?? '')));
+        return df;
+    }
     async into(target, options = {}) {
         const df = await this.result();
         const rows = df.toRows();
-        // Table-like: has .columns() and .rows()
         if (typeof target.columns === 'function' && typeof target.rows === 'function') {
-            const columnDefs = (options.columns ?? df.columns).map((col) => {
-                const label = options.columnLabels?.[col] ?? col;
-                return { key: col, label };
-            });
+            const cols = options.columns ?? df.columns;
+            const columnDefs = cols.map((col) => ({
+                key: col,
+                label: options.columnLabels?.[col] ?? col
+            }));
             target.columns(columnDefs).rows(rows);
             return df;
         }
-        // DataFrameComponent: has .fromData()
         if (typeof target.fromData === 'function') {
             target.fromData(rows);
             return df;
         }
-        // Dropdown/Select-like: has .options()
         if (typeof target.options === 'function') {
-            const labelKey = options.labelKey ?? df.columns[0];
-            const valueKey = options.valueKey ?? (df.columns[1] ?? df.columns[0]);
+            if (!options.labelKey) {
+                throw new Error('Cannot push into dropdown/select without labelKey. ' +
+                    'Use .intoDropdown(target, labelKey, valueKey) or pass { labelKey, valueKey } to .into()');
+            }
             const opts = rows.map(row => ({
-                label: String(row[labelKey] ?? ''),
-                value: row[valueKey]
+                label: String(row[options.labelKey] ?? ''),
+                value: row[options.valueKey ?? options.labelKey]
             }));
             target.options(opts);
             return df;
         }
-        // List-like: has .items()
         if (typeof target.items === 'function') {
-            const key = options.labelKey ?? df.columns[0];
-            target.items(rows.map(row => String(row[key] ?? '')));
+            if (!options.labelKey) {
+                throw new Error('Cannot push into list without labelKey. ' +
+                    'Use .intoList(target, column) or pass { labelKey } to .into()');
+            }
+            target.items(rows.map(row => String(row[options.labelKey] ?? '')));
             return df;
         }
-        throw new Error(`Target does not have a recognized API (.columns/.rows, .fromData, .options, or .items)`);
+        throw new Error('Target does not have a recognized API (.columns/.rows, .fromData, .options, or .items)');
     }
-    /**
-     * Execute and persist to IndexedDB
-     */
     async store(key, metadata) {
         const df = await this.result();
         await this._driver.store(key, df, metadata);
@@ -263,16 +257,46 @@ export class DataPipeline {
     /* ═══════════════════════════════════════════════════
      * PRIVATE
      * ═══════════════════════════════════════════════════ */
+    async _loadFromStorage(key) {
+        // Try by name first, then by id
+        let df = await this._driver.loadByName(key);
+        if (df)
+            return df;
+        df = await this._driver.load(key);
+        if (df)
+            return df;
+        throw new Error(`No data found in storage with key: "${key}"`);
+    }
     async _loadFromUrl(url, options) {
         const mimeType = options.mimeType ?? this._detectMimeType(url);
+        // Build headers from auth options
+        const headers = { ...options.headers };
+        if (options.bearer) {
+            headers['Authorization'] = `Bearer ${options.bearer}`;
+        }
+        if (options.apiKey) {
+            headers['x-api-key'] = options.apiKey;
+        }
         if (mimeType === 'json') {
-            const response = await fetch(url);
+            const response = await fetch(url, { headers });
             if (!response.ok)
                 throw new Error(`Fetch failed: ${response.status} ${response.statusText}`);
             const json = await response.json();
             return new DataFrame(json);
         }
-        // CSV/TSV — delegate to driver
+        // CSV/TSV — fetch with headers, then parse
+        if (Object.keys(headers).length > 0) {
+            const response = await fetch(url, { headers });
+            if (!response.ok)
+                throw new Error(`Fetch failed: ${response.status} ${response.statusText}`);
+            const text = await response.text();
+            return this._driver.parseCSV(text, {
+                autoDetectDelimiter: !options.delimiter,
+                delimiter: options.delimiter,
+                hasHeader: options.hasHeader ?? true,
+                headerRow: options.headerRow
+            });
+        }
         return this._driver.fetch(url, {
             autoDetectDelimiter: !options.delimiter,
             delimiter: options.delimiter,
@@ -311,14 +335,25 @@ export class DataPipeline {
     }
 }
 /**
- * Factory function — the primary entry point
+ * Factory function — primary entry point via jux.gather()
  *
- * Usage:
- *   import { data } from 'juxscript';
+ * Smart single-arg:
+ *   jux.gather('raw/myfile.xlsx')                              // storage key
+ *   jux.gather('https://api.com/data', { bearer: 'xxx' })     // URL with auth
+ *   jux.gather(myUpload)                                       // FileUpload
+ *   jux.gather([{a:1}, {b:2}])                                 // inline rows
+ *   jux.gather(existingDf)                                     // clone DataFrame
  *
- *   const df = await data().fromStorage('patients').select('name', 'dob').result();
- *   await data().fromUrl(presignedUrl).filter(r => r.status === 'active').into(myTable);
+ * Explicit source:
+ *   jux.gather().fromStorage(key)
+ *   jux.gather().fromUrl(url, opts)
  */
-export function data(options = {}) {
-    return new DataPipeline(options);
+export function gather(source, options) {
+    const pipe = new DataPipeline(options?.dbName || options?.storeName
+        ? { dbName: options.dbName, storeName: options.storeName }
+        : {});
+    if (source !== undefined) {
+        pipe.from(source, options ?? {});
+    }
+    return pipe;
 }

package/lib/data/DataPipeline.ts

@@ -13,90 +13,148 @@ export interface FetchOptions {
     mimeType?: 'csv' | 'tsv' | 'json' | 'auto';
 }
 
+export interface GatherOptions extends FetchOptions {
+    /** Authorization bearer token */
+    bearer?: string;
+    /** API key (sent as x-api-key header) */
+    apiKey?: string;
+    /** Custom headers for URL fetches */
+    headers?: Record<string, string>;
+    /** IndexedDB database name override */
+    dbName?: string;
+    /** IndexedDB store name override */
+    storeName?: string;
+}
+
+export interface IntoOptions {
+    /** Override which columns to use (for Table targets) */
+    columns?: string[];
+    /** Column name → display label mapping */
+    columnLabels?: Record<string, string>;
+    /** Key for option labels (Dropdown/Select/List targets) */
+    labelKey?: string;
+    /** Key for option values (Dropdown/Select targets) */
+    valueKey?: string;
+}
+
 /**
  * DataPipeline — Headless, promise-based data loading and transformation.
  *
  * Usage:
- *   const df = await data.fromUrl('https://example.com/report.csv').result();
- *   const df = await data.fromStorage('patients').result();
- *   const df = await data.fromJson(apiResponse).result();
- *
- *   // Transform and distribute:
- *   await data.fromUrl(url)
- *       .transform(df => df.select('name', 'age').filter(r => r.age > 30))
- *       .into(myTable);
- *
- *   await data.fromStorage('encounters')
- *       .transform(df => df.distinct('provider'))
- *       .into(myDropdown, { labelKey: 'provider', valueKey: 'provider' });
+ *   const df = await jux.gather('raw/myfile.xlsx').result();
+ *   const df = await jux.gather('https://api.com/data', { bearer: 'xxx' }).result();
+ *   const df = await jux.gather(myUpload).select('name').result();
+ *   const df = await jux.gather([{a:1}, {b:2}]).result();
+ *   await jux.gather(key).filter(r => r.active).intoTable(myTable);
  */
 export class DataPipeline {
     private _driver: TabularDriver;
     private _pending: Promise<DataFrame> | null = null;
     private _transforms: ((df: DataFrame) => DataFrame)[] = [];
+    private _gatherOptions: GatherOptions;
 
     constructor(options: PipelineOptions = {}) {
         this._driver = new TabularDriver(
             options.dbName ?? 'jux-dataframes',
             options.storeName ?? 'frames'
         );
+        this._gatherOptions = {};
     }
 
     /* ═══════════════════════════════════════════════════
-     * SOURCES
+     * SMART SOURCE DETECTION
      * ═══════════════════════════════════════════════════ */
 
     /**
-     * Load from IndexedDB by key
+     * Auto-detect source type and load accordingly.
+     *
+     * - string starting with http/https → URL fetch
+     * - string → IndexedDB storage key
+     * - File → parse file
+     * - Array → row objects
+     * - DataFrame → clone
+     * - object with .storageKey → FileUpload cached key
+     * - object with string keys + array values → column-oriented data
      */
+    from(source: any, options: GatherOptions = {}): this {
+        this._transforms = [];
+        this._gatherOptions = options;
+
+        // Update driver if custom db/store
+        if (options.dbName || options.storeName) {
+            this._driver = new TabularDriver(
+                options.dbName ?? 'jux-dataframes',
+                options.storeName ?? 'frames'
+            );
+        }
+
+        if (source instanceof DataFrame) {
+            this._pending = Promise.resolve(source.clone());
+        } else if (Array.isArray(source)) {
+            this._pending = Promise.resolve(new DataFrame(source));
+        } else if (typeof source === 'string') {
+            if (/^https?:\/\//i.test(source)) {
+                this._pending = this._loadFromUrl(source, options);
+            } else {
+                this._pending = this._loadFromStorage(source);
+            }
+        } else if (source instanceof File) {
+            this._pending = this._loadFromFile(source, options);
+        } else if (source && typeof source === 'object' && 'storageKey' in source) {
+            // FileUpload component with .cache() enabled
+            const key = source.storageKey;
+            if (!key) {
+                this._pending = Promise.reject(
+                    new Error('FileUpload has no cached storage key. Ensure .cache() is enabled and a file has been uploaded.')
+                );
+            } else {
+                this._pending = this._loadFromStorage(key);
+            }
+        } else if (source && typeof source === 'object' && !Array.isArray(source)) {
+            // Column-oriented: { col1: [...], col2: [...] }
+            this._pending = Promise.resolve(new DataFrame(source));
+        } else {
+            this._pending = Promise.reject(new Error('Unrecognized source type passed to gather()'));
+        }
+
+        return this;
+    }
+
+    /* ═══════════════════════════════════════════════════
+     * EXPLICIT SOURCES (still available)
+     * ═══════════════════════════════════════════════════ */
+
     fromStorage(key: string): this {
         this._transforms = [];
-        this._pending = this._driver.loadByName(key).then(df => {
-            if (!df) throw new Error(`No data found in storage with key: "${key}"`);
-            return df;
-        });
+        this._pending = this._loadFromStorage(key);
         return this;
     }
 
-    /**
-     * Load from a URL (CSV, TSV, or JSON)
-     */
-    fromUrl(url: string, options: FetchOptions = {}): this {
+    fromUrl(url: string, options: GatherOptions = {}): this {
         this._transforms = [];
+        this._gatherOptions = options;
         this._pending = this._loadFromUrl(url, options);
         return this;
     }
 
-    /**
-     * Load from a File object directly
-     */
     fromFile(file: File, options: FetchOptions = {}): this {
         this._transforms = [];
         this._pending = this._loadFromFile(file, options);
         return this;
     }
 
-    /**
-     * Load from an array of row objects
-     */
     fromRows(rows: Record<string, any>[], columns?: string[]): this {
         this._transforms = [];
         this._pending = Promise.resolve(new DataFrame(rows, { columns }));
         return this;
     }
 
-    /**
-     * Load from column-oriented data
-     */
     fromColumns(columns: Record<string, any[]>): this {
         this._transforms = [];
         this._pending = Promise.resolve(new DataFrame(columns));
         return this;
     }
 
-    /**
-     * Load from a JSON response (array of objects or column-oriented)
-     */
     fromJson(json: Record<string, any>[] | Record<string, any[]> | string): this {
         this._transforms = [];
         const parsed = typeof json === 'string' ? JSON.parse(json) : json;
@@ -104,13 +162,6 @@ export class DataPipeline {
         return this;
     }
 
-    /**
-     * Load from a FileUpload component's cached storage key.
-     * Requires .cache() enabled on the FileUpload and a file already uploaded.
-     *
-     * Usage:
-     *   await data().fromUpload(myUpload).select('name').into(myTable);
-     */
     fromUpload(upload: any): this {
         this._transforms = [];
         const key = upload.storageKey;
@@ -119,94 +170,52 @@ export class DataPipeline {
                 new Error('FileUpload has no cached storage key. Ensure .cache() is enabled and a file has been uploaded.')
             );
         } else {
-            this._pending = this._driver.loadByName(key).then((df: any) => {
-                if (!df) throw new Error(`No cached data found for key: "${key}"`);
-                return df;
-            });
+            this._pending = this._loadFromStorage(key);
         }
         return this;
     }
 
-    /**
-     * Start from an existing DataFrame
-     */
-    from(df: DataFrame): this {
-        this._transforms = [];
-        this._pending = Promise.resolve(df.clone());
-        return this;
-    }
-
     /* ═══════════════════════════════════════════════════
-     * TRANSFORMS (chained, lazy — applied on .result())
+     * TRANSFORMS (chained, lazy — applied on terminal)
      * ═══════════════════════════════════════════════════ */
 
-    /**
-     * Apply an arbitrary transform
-     */
     transform(fn: (df: DataFrame) => DataFrame): this {
         this._transforms.push(fn);
         return this;
     }
 
-    /**
-     * Select columns
-     */
     select(...cols: string[]): this {
         return this.transform(df => df.select(...cols));
     }
 
-    /**
-     * Filter rows
-     */
     filter(predicate: (row: Record<string, any>, index: number) => boolean): this {
         return this.transform(df => df.filter(predicate));
     }
 
-    /**
-     * Sort by column
-     */
     sort(column: string, descending?: boolean): this {
         return this.transform(df => df.sort(column, descending));
     }
 
-    /**
-     * Take first N rows
-     */
     head(n: number = 5): this {
         return this.transform(df => df.head(n));
     }
 
-    /**
-     * Take last N rows
-     */
     tail(n: number = 5): this {
         return this.transform(df => df.tail(n));
     }
 
-    /**
-     * Rename columns
-     */
     rename(mapping: Record<string, string>): this {
         return this.transform(df => df.rename(mapping));
     }
 
-    /**
-     * Add a computed column
-     */
     withColumn(name: string, fn: (row: Record<string, any>, index: number) => any): this {
         return this.transform(df => df.withColumn(name, fn));
     }
 
-    /**
-     * Drop nulls
-     */
     dropna(columns?: string[]): this {
         return this.transform(df => df.dropna(columns));
     }
 
-    /**
-     * Drop duplicates
-     */
     dropDuplicates(columns?: string[]): this {
         return this.transform(df => df.dropDuplicates(columns));
     }
@@ -215,12 +224,8 @@ export class DataPipeline {
      * TERMINAL OPERATIONS
      * ═══════════════════════════════════════════════════ */
 
-    /**
-     * Execute the pipeline and return the DataFrame
-     */
     async result(): Promise<DataFrame> {
-        if (!this._pending) throw new Error('No data source specified. Call fromStorage(), fromUrl(), etc. first.');
-
+        if (!this._pending) throw new Error('No data source specified. Call gather(source) or from*(source) first.');
         let df = await this._pending;
         for (const fn of this._transforms) {
             df = fn(df);
@@ -228,82 +233,107 @@ export class DataPipeline {
         return df;
     }
 
-    /**
-     * Execute and return rows as plain objects
-     */
     async toRows(): Promise<Record<string, any>[]> {
         return (await this.result()).toRows();
     }
 
-    /**
-     * Execute and return a single column as an array
-     */
     async toArray(column: string): Promise<any[]> {
         return (await this.result()).col(column);
     }
 
-    /**
-     * Execute and return distinct values from a column
-     */
     async toDistinct(column: string): Promise<any[]> {
         return (await this.result()).distinct(column);
     }
 
-    /**
-     * Execute and push results into a jux component.
-     *
-     * Supported targets:
-     * - Table: sets columns + rows
-     * - Dropdown/Select: sets options from labelKey/valueKey
-     * - List: sets items
-     * - DataFrameComponent: loads data
-     * - Any object with a .rows() or .options() or .items() method
-     */
+    async toOptions(labelKey: string, valueKey?: string): Promise<{ label: string; value: any }[]> {
+        const df = await this.result();
+        const vKey = valueKey ?? labelKey;
+        return df.toRows().map(row => ({
+            label: String(row[labelKey] ?? ''),
+            value: row[vKey]
+        }));
+    }
+
+    async toList(column: string): Promise<string[]> {
+        const df = await this.result();
+        return df.col(column).map(v => String(v ?? ''));
+    }
+
+    async intoTable(table: any, columnLabels?: Record<string, string>): Promise<DataFrame> {
+        const df = await this.result();
+        const columnDefs = df.columns.map(col => ({
+            key: col,
+            label: columnLabels?.[col] ?? col
+        }));
+        table.columns(columnDefs).rows(df.toRows());
+        return df;
+    }
+
+    async intoDropdown(dropdown: any, labelKey: string, valueKey?: string): Promise<DataFrame> {
+        const df = await this.result();
+        const vKey = valueKey ?? labelKey;
+        const opts = df.toRows().map(row => ({
+            label: String(row[labelKey] ?? ''),
+            value: row[vKey]
+        }));
+        dropdown.options(opts);
+        return df;
+    }
+
+    async intoList(list: any, column: string): Promise<DataFrame> {
+        const df = await this.result();
+        list.items(df.col(column).map((v: any) => String(v ?? '')));
+        return df;
+    }
+
     async into(target: any, options: IntoOptions = {}): Promise<DataFrame> {
         const df = await this.result();
         const rows = df.toRows();
 
-        // Table-like: has .columns() and .rows()
         if (typeof target.columns === 'function' && typeof target.rows === 'function') {
-            const columnDefs = (options.columns ?? df.columns).map((col: string) => {
-                const label = options.columnLabels?.[col] ?? col;
-                return { key: col, label };
-            });
+            const cols = options.columns ?? df.columns;
+            const columnDefs = cols.map((col: string) => ({
+                key: col,
+                label: options.columnLabels?.[col] ?? col
+            }));
             target.columns(columnDefs).rows(rows);
             return df;
         }
 
-        // DataFrameComponent: has .fromData()
         if (typeof target.fromData === 'function') {
             target.fromData(rows);
             return df;
         }
 
-        // Dropdown/Select-like: has .options()
         if (typeof target.options === 'function') {
-            const labelKey = options.labelKey ?? df.columns[0];
-            const valueKey = options.valueKey ?? (df.columns[1] ?? df.columns[0]);
+            if (!options.labelKey) {
+                throw new Error(
+                    'Cannot push into dropdown/select without labelKey. ' +
+                    'Use .intoDropdown(target, labelKey, valueKey) or pass { labelKey, valueKey } to .into()'
+                );
+            }
             const opts = rows.map(row => ({
-                label: String(row[labelKey] ?? ''),
-                value: row[valueKey]
+                label: String(row[options.labelKey!] ?? ''),
+                value: row[options.valueKey ?? options.labelKey!]
             }));
             target.options(opts);
             return df;
         }
 
-        // List-like: has .items()
         if (typeof target.items === 'function') {
-            const key = options.labelKey ?? df.columns[0];
-            target.items(rows.map(row => String(row[key] ?? '')));
+            if (!options.labelKey) {
+                throw new Error(
+                    'Cannot push into list without labelKey. ' +
+                    'Use .intoList(target, column) or pass { labelKey } to .into()'
+                );
+            }
+            target.items(rows.map(row => String(row[options.labelKey!] ?? '')));
             return df;
         }
 
-        throw new Error(`Target does not have a recognized API (.columns/.rows, .fromData, .options, or .items)`);
+        throw new Error('Target does not have a recognized API (.columns/.rows, .fromData, .options, or .items)');
     }
 
-    /**
-     * Execute and persist to IndexedDB
-     */
     async store(key: string, metadata?: Record<string, any>): Promise<DataFrame> {
         const df = await this.result();
         await this._driver.store(key, df, metadata);
@@ -314,17 +344,49 @@ export class DataPipeline {
      * PRIVATE
      * ═══════════════════════════════════════════════════ */
 
-    private async _loadFromUrl(url: string, options: FetchOptions): Promise<DataFrame> {
+    private async _loadFromStorage(key: string): Promise<DataFrame> {
+        // Try by name first, then by id
+        let df = await this._driver.loadByName(key);
+        if (df) return df;
+
+        df = await this._driver.load(key);
+        if (df) return df;
+
+        throw new Error(`No data found in storage with key: "${key}"`);
+    }
+
+    private async _loadFromUrl(url: string, options: GatherOptions): Promise<DataFrame> {
         const mimeType = options.mimeType ?? this._detectMimeType(url);
 
+        // Build headers from auth options
+        const headers: Record<string, string> = { ...options.headers };
+        if (options.bearer) {
+            headers['Authorization'] = `Bearer ${options.bearer}`;
+        }
+        if (options.apiKey) {
+            headers['x-api-key'] = options.apiKey;
+        }
+
         if (mimeType === 'json') {
-            const response = await fetch(url);
+            const response = await fetch(url, { headers });
             if (!response.ok) throw new Error(`Fetch failed: ${response.status} ${response.statusText}`);
             const json = await response.json();
             return new DataFrame(json);
         }
 
-        // CSV/TSV — delegate to driver
+        // CSV/TSV — fetch with headers, then parse
+        if (Object.keys(headers).length > 0) {
+            const response = await fetch(url, { headers });
+            if (!response.ok) throw new Error(`Fetch failed: ${response.status} ${response.statusText}`);
+            const text = await response.text();
+            return this._driver.parseCSV(text, {
+                autoDetectDelimiter: !options.delimiter,
+                delimiter: options.delimiter,
+                hasHeader: options.hasHeader ?? true,
+                headerRow: options.headerRow
+            });
+        }
+
         return this._driver.fetch(url, {
             autoDetectDelimiter: !options.delimiter,
             delimiter: options.delimiter,
@@ -363,26 +425,28 @@ export class DataPipeline {
     }
 }
 
-export interface IntoOptions {
-    /** Override which columns to use (for Table targets) */
-    columns?: string[];
-    /** Column name → display label mapping */
-    columnLabels?: Record<string, string>;
-    /** Key for option labels (Dropdown/Select/List targets) */
-    labelKey?: string;
-    /** Key for option values (Dropdown/Select targets) */
-    valueKey?: string;
-}
-
 /**
- * Factory function — the primary entry point
+ * Factory function — primary entry point via jux.gather()
  *
- * Usage:
- *   import { data } from 'juxscript';
+ * Smart single-arg:
+ *   jux.gather('raw/myfile.xlsx')                              // storage key
+ *   jux.gather('https://api.com/data', { bearer: 'xxx' })     // URL with auth
+ *   jux.gather(myUpload)                                       // FileUpload
+ *   jux.gather([{a:1}, {b:2}])                                 // inline rows
+ *   jux.gather(existingDf)                                     // clone DataFrame
  *
- *   const df = await data().fromStorage('patients').select('name', 'dob').result();
- *   await data().fromUrl(presignedUrl).filter(r => r.status === 'active').into(myTable);
+ * Explicit source:
+ *   jux.gather().fromStorage(key)
+ *   jux.gather().fromUrl(url, opts)
  */
-export function data(options: PipelineOptions = {}): DataPipeline {
-    return new DataPipeline(options);
+export function gather(source?: any, options?: GatherOptions): DataPipeline {
+    const pipe = new DataPipeline(
+        options?.dbName || options?.storeName
+            ? { dbName: options.dbName, storeName: options.storeName }
+            : {}
+    );
+    if (source !== undefined) {
+        pipe.from(source, options ?? {});
+    }
+    return pipe;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "juxscript",
-  "version": "1.1.236",
+  "version": "1.1.238",
   "type": "module",
   "description": "A JavaScript UX authorship platform",
   "main": "index.js",