@blueskyproject/tiled 0.0.30 → 0.0.32

package/dist/components/Tiled/api/TiledSearchApi.d.ts

@@ -0,0 +1,171 @@
+import { TiledRequestOptions } from './TiledConfigApi';
+import { TiledSearchResult } from '../types';
+export interface TiledSearchApi {
+    getSearch(searchPath: string, config?: TiledSearchConfig, requestOptions?: TiledRequestOptions): Promise<TiledSearchResult>;
+}
+/**
+ * Serializes a `TiledSearchConfig` into a flat params object using the
+ * bracket-notation keys expected by the Tiled REST API.
+ *
+ * @param config - Search configuration including filters and pagination options.
+ * @returns A flat record suitable for use as Axios `params`.
+ *
+ * @example
+ * buildSearchParams({
+ *   searchFilters: { fulltext: { text: 'myrun' } },
+ *   searchOptions: { sort: '-', pageLimit: 10 },
+ * });
+ * // → { 'filter[fulltext][condition][text]': 'myrun', sort: '-', 'page[limit]': '10' }
+ */
+export declare function buildSearchParams(config?: TiledSearchConfig): Record<string, string | string[]>;
+/**
+ * Configuration object for comprehensive Tiled search functionality
+ */
+export interface TiledSearchConfig {
+    searchFilters?: TiledSearchFilters;
+    searchOptions?: TiledSearchOptions;
+}
+/**
+ * Options for search requests (pagination, sorting, field selection, etc.)
+ */
+export interface TiledSearchOptions {
+    /** Fields to include in response */
+    fields?: string[];
+    /** Metadata selection pattern */
+    selectMetadata?: string;
+    /** Page offset for pagination */
+    pageOffset?: number;
+    /** Page limit for pagination */
+    pageLimit?: number;
+    /** Sort field */
+    sort?: string;
+    /** Whether to omit links in response */
+    omitLinks?: boolean;
+    /** Whether to include data sources */
+    includeDataSources?: boolean;
+}
+/**
+ * All available search filters for Tiled API
+ */
+export interface TiledSearchFilters {
+    /** Full-text search filter */
+    fulltext?: TiledFulltextFilter;
+    /** Lookup filter for metadata keys */
+    lookup?: TiledLookupFilter;
+    /** Keys filter */
+    keysFilter?: TiledKeysFilter;
+    /** Regular expression filter */
+    regex?: TiledRegexFilter;
+    /** Equality filter */
+    eq?: TiledEqualityFilter;
+    /** Not equal filter */
+    noteq?: TiledEqualityFilter;
+    /** Comparison filter */
+    comparison?: TiledComparisonFilter;
+    /** Contains filter */
+    contains?: TiledContainsFilter;
+    /** In filter */
+    in?: TiledInFilter;
+    /** Not in filter */
+    notin?: TiledInFilter;
+    /** Key present filter */
+    keyPresent?: TiledKeyPresentFilter;
+    /** Like filter */
+    like?: TiledLikeFilter;
+    /** Specs filter */
+    specs?: TiledSpecsFilter;
+    /** Access blob filter */
+    accessBlob?: TiledAccessBlobFilter;
+    /** Structure family filter */
+    structureFamily?: TiledStructureFamilyFilter;
+}
+/**
+ * Full-text search filter
+ */
+export interface TiledFulltextFilter {
+    text: string;
+}
+/**
+ * Lookup filter for metadata keys
+ */
+export interface TiledLookupFilter {
+    key: string;
+}
+/**
+ * Keys filter
+ */
+export interface TiledKeysFilter {
+    keys: string[];
+}
+/**
+ * Regular expression filter
+ */
+export interface TiledRegexFilter {
+    key: string;
+    pattern: string;
+    caseSensitive?: boolean;
+}
+/**
+ * Equality filter (eq/noteq)
+ */
+export interface TiledEqualityFilter {
+    key: string;
+    value: string;
+}
+/**
+ * Comparison filter (gt, gte, lt, lte)
+ */
+export interface TiledComparisonFilter {
+    operator: 'gt' | 'gte' | 'lt' | 'lte';
+    key: string;
+    value: string;
+}
+/**
+ * Contains filter
+ */
+export interface TiledContainsFilter {
+    key: string;
+    value: string;
+}
+/**
+ * In/not in filter
+ */
+export interface TiledInFilter {
+    key: string;
+    value: string[];
+}
+/**
+ * Key present filter
+ */
+export interface TiledKeyPresentFilter {
+    key: string;
+    exists: boolean;
+}
+/**
+ * Like filter
+ */
+export interface TiledLikeFilter {
+    key: string;
+    pattern: string;
+}
+/**
+ * Specs filter with include/exclude arrays
+ */
+export interface TiledSpecsFilter {
+    include: string[];
+    exclude: string[];
+}
+/**
+ * Access blob filter
+ */
+export interface TiledAccessBlobFilter {
+    userId?: string;
+    tags?: string[];
+}
+/**
+ * Structure family filter
+ */
+export interface TiledStructureFamilyFilter {
+    value: 'container' | 'array' | 'table' | 'awkward' | 'sparse';
+}
+//# sourceMappingURL=TiledSearchApi.d.ts.map

package/dist/components/Tiled/api/TiledSearchApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TiledSearchApi.d.ts","sourceRoot":"","sources":["../../../../src/components/Tiled/api/TiledSearchApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD,MAAM,WAAW,cAAc;IAC7B,SAAS,CACP,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,iBAAiB,EAC1B,cAAc,CAAC,EAAE,mBAAmB,GACnC,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC/B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,GAAE,iBAAsB,GAC7B,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CA4FnC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,aAAa,CAAC,EAAE,kBAAkB,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,iCAAiC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sCAAsC;IACtC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,sCAAsC;IACtC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,kBAAkB;IAClB,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,gCAAgC;IAChC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,sBAAsB;IACtB,EAAE,CAAC,EAAE,mBAAmB,CAAC;IACzB,uBAAuB;IACvB,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,wBAAwB;IACxB,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,sBAAsB;IACtB,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,gBAAgB;IAChB,EAAE,CAAC,EAAE,aAAa,CAAC;IACnB,oBAAoB;IACpB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,yBAAyB;IACzB,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,kBAAkB;IAClB,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,mBAAmB;IACnB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,yBAAyB;IACzB,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,8BAA8B;IAC9B,eAAe,CAAC,EAAE,0BAA0B,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,GAAG,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,QAAQ,EAAE,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACvC,KAAK,EAAE,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC;CACjE"}

package/dist/components/Tiled/api/TiledTableApi.d.ts

@@ -0,0 +1,89 @@
+import { TiledRequestOptions } from './TiledConfigApi';
+import { TiledSearchItem, TiledTableRow, TableStructure } from '../types';
+/**
+ * Tiled's application/json table format is usually column-oriented.
+ *
+ * Example:
+ * {
+ *   A: [0.5699, 0.1234],
+ *   B: [1.1398, 0.2468],
+ *   C: [1.7098, 0.3702]
+ * }
+ */
+export type TiledTableJSONResponse = Record<string, unknown[]>;
+/**
+ * A Tiled search item whose structure is specifically a TableStructure.
+ */
+export type TiledTableItem = TiledSearchItem<TableStructure>;
+export type TiledTableReturnType = 'JSON' | 'JSON_SEQ';
+export type TiledTableEndpoint = 'partition' | 'full';
+export type TiledTableReturnMap = {
+    /**
+     * Column-oriented JSON response.
+     */
+    JSON: TiledTableJSONResponse;
+    /**
+     * Row-oriented JSON sequence response.
+     */
+    JSON_SEQ: TiledTableRow[];
+};
+export interface TiledTableRequestOptions extends TiledRequestOptions {
+    /**
+     * The table partition to retrieve.
+     *
+     * Tiled partitions are 0-based.
+     */
+    partition?: number;
+    /**
+     * Table structure information from Tiled.
+     *
+     * Passing this can avoid a secondary structure request later.
+     */
+    structure?: TableStructure;
+    /**
+     * Full Tiled item for a table.
+     */
+    tableItem?: TiledTableItem;
+}
+export type GetTableAsOptionsMap = {
+    JSON: TiledTableRequestOptions & {
+        format?: 'application/json';
+    };
+    JSON_SEQ: TiledTableRequestOptions & {
+        format?: 'application/json-seq';
+    };
+};
+export interface TiledTableApi {
+    getTableAs<T extends TiledTableReturnType>(tablePath: string, type: T, endpoint: TiledTableEndpoint, options?: GetTableAsOptionsMap[T]): Promise<TiledTableReturnMap[T]>;
+    getTablePartitionAsJSON(tablePath: string, options?: GetTableAsOptionsMap['JSON']): Promise<TiledTableJSONResponse>;
+    getTablePartitionAsJSONSequence(tablePath: string, options?: GetTableAsOptionsMap['JSON_SEQ']): Promise<TiledTableRow[]>;
+    getTableFullAsJSON(tablePath: string, options?: GetTableAsOptionsMap['JSON']): Promise<TiledTableJSONResponse>;
+    getTableFullAsJSONSequence(tablePath: string, options?: GetTableAsOptionsMap['JSON_SEQ']): Promise<TiledTableRow[]>;
+}
+/**
+ * Returns the `TableStructure` from either `options.structure` or
+ * `options.tableItem.attributes.structure`, whichever is present.
+ *
+ * @param options - Table request options that may contain structure info.
+ * @returns The resolved `TableStructure`, or `undefined` if neither is present.
+ */
+export declare function resolveTableStructure(options?: TiledTableRequestOptions): TableStructure | undefined;
+/**
+ * Returns `true` when the caller has already provided enough table structure
+ * information (via `options.structure` or `options.tableItem`) to skip a
+ * secondary metadata request.
+ *
+ * @param options - Table request options.
+ * @returns `true` if structure info is available, `false` otherwise.
+ */
+export declare function hasTableStructure(options?: TiledTableRequestOptions): boolean;
+/**
+ * Parses Tiled's application/json-seq response.
+ *
+ * Depending on the server/client behavior, Axios may give you:
+ * - a string containing newline-separated JSON objects
+ * - a single object for one-row results
+ * - an array, if something upstream already parsed it
+ */
+export declare function parseJsonSequenceTableResponse(data: unknown): TiledTableRow[];
+//# sourceMappingURL=TiledTableApi.d.ts.map

package/dist/components/Tiled/api/TiledTableApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TiledTableApi.d.ts","sourceRoot":"","sources":["../../../../src/components/Tiled/api/TiledTableApi.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG9D;;;;;;;;;GASG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,eAAe,CAAC,cAAc,CAAC,CAAC;AAE7D,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,UAAU,CAAC;AAEvD,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,MAAM,CAAC;AAEtD,MAAM,MAAM,mBAAmB,GAAG;IAChC;;OAEG;IACH,IAAI,EAAE,sBAAsB,CAAC;IAE7B;;OAEG;IACH,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B,CAAC;AAEF,MAAM,WAAW,wBAAyB,SAAQ,mBAAmB;IACnE;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,SAAS,CAAC,EAAE,cAAc,CAAC;IAE3B;;OAEG;IACH,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,wBAAwB,GAAG;QAC/B,MAAM,CAAC,EAAE,kBAAkB,CAAC;KAC7B,CAAC;IAEF,QAAQ,EAAE,wBAAwB,GAAG;QACnC,MAAM,CAAC,EAAE,sBAAsB,CAAC;KACjC,CAAC;CACH,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,CAAC,SAAS,oBAAoB,EACvC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAChC,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;IAEnC,uBAAuB,CACrB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,oBAAoB,CAAC,MAAM,CAAC,GACrC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAEnC,+BAA+B,CAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,oBAAoB,CAAC,UAAU,CAAC,GACzC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAE5B,kBAAkB,CAChB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,oBAAoB,CAAC,MAAM,CAAC,GACrC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAEnC,0BAA0B,CACxB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,oBAAoB,CAAC,UAAU,CAAC,GACzC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,wBAA6B,GACrC,cAAc,GAAG,SAAS,CAE5B;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAET;AAED;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,OAAO,GACZ,aAAa,EAAE,CAuBjB"}

package/dist/components/Tiled/api/defaultTiledApiClient.d.ts

@@ -0,0 +1,315 @@
+import { TiledApiClient } from './TiledApiClient';
+import { TiledTableRow, TiledSearchItem, TiledStructures, TiledSearchResult, TiledInfoResponse, TiledAuthProvider } from '../types';
+import { TiledArrayReturnType, TiledArrayReturnMap, GetArrayAsOptionsMap } from './TiledArrayApi';
+import { GetTableAsOptionsMap, TiledTableJSONResponse, TiledTableReturnMap, TiledTableReturnType, TiledTableEndpoint } from './TiledTableApi';
+import { TiledRequestOptions } from './TiledConfigApi';
+import { TiledSearchConfig, TiledSearchOptions } from './TiledSearchApi';
+export type { TiledAuthProvider };
+/** Callback invoked when a token-refresh attempt fails (e.g. to show a login prompt). */
+export type AuthErrorCallback = (error: unknown) => void;
+/**
+ * Returns the active module-level `TiledApiClient` singleton used by all
+ * `getTiled*` / `setDefault*` functions in this module.
+ *
+ * @returns The current `TiledApiClient` instance.
+ */
+export declare function getDefaultTiledApiClient(): TiledApiClient;
+/**
+ * Replaces the active singleton with a custom `TiledApiClient` instance.
+ *
+ * Useful when you need fine-grained control over the Axios client (e.g.
+ * injecting a mock in tests or pre-configuring auth).
+ *
+ * @param client - The `TiledApiClient` instance to use from this point on.
+ */
+export declare function setDefaultTiledApiClient(client: TiledApiClient): void;
+/**
+ * Resets the singleton to a fresh `TiledApiClient` with the default base URL
+ * derived from `window.location` (port 8000, `/api/v1`).
+ *
+ * Call this in test `beforeEach` / `afterEach` to prevent state leaking between
+ * test cases.
+ *
+ * @example
+ * beforeEach(() => { resetDefaultTiledApiClient(); });
+ */
+export declare function resetDefaultTiledApiClient(): void;
+/**
+ * Sets the Tiled server base URL on the singleton.
+ *
+ * Must include the API version path, e.g. `"https://myserver.example.com/api/v1"`.
+ *
+ * @param baseUrl - Full base URL of the Tiled server.
+ */
+export declare function setDefaultTiledUrl(baseUrl: string): void;
+/**
+ * Sets the global `initialPath` prefix on the singleton.
+ *
+ * All subsequent relative-path requests are automatically prefixed with this
+ * value. Pass `pathMode: 'absolute'` in request options to bypass it for a
+ * single call.
+ *
+ * @param initialPath - Path prefix, e.g. `"data/project"`.
+ */
+export declare function setDefaultInitialPath(initialPath: string): void;
+/**
+ * Reads the current `initialPath` prefix from the singleton.
+ *
+ * @returns The current initial path string (may be empty).
+ */
+export declare function getDefaultTiledInitialPath(): string;
+/**
+ * Sets the API key on the singleton.
+ *
+ * The request interceptor automatically attaches it as
+ * `Authorization: ApiKey <key>` to every request that does not already have an
+ * `Authorization` header.
+ *
+ * @param apiKey - The API key string, or `null` to clear it.
+ */
+export declare function setGlobalApiKey(apiKey: string | null): void;
+/**
+ * Sets a global maximum payload size for array requests on the singleton.
+ *
+ * When set, the client auto-computes a downsample step ratio so that the
+ * returned array data stays under this byte limit.
+ *
+ * @param maxBytes - Maximum bytes for array payloads, or `undefined` to disable
+ *   the global limit (per-request `maxBytesAllowed` still applies).
+ */
+export declare function setGlobalMaxArrayBytes(maxBytes: number | undefined): void;
+/**
+ * Fetches a Tiled array in the specified format.
+ *
+ * This is the generic dispatcher; prefer the typed convenience helpers
+ * (`getTiledArrayAsJSON`, `getTiledArrayAsPng`, etc.) for cleaner call sites.
+ *
+ * @param arrayPath - Tiled path to the array.
+ * @param type - Return format: `'JSON'`, `'PNG'`, `'BUFFER'`, or `'IMAGE_PATH'`. Defaults to `'BUFFER'`.
+ * @param options - Format-specific array request options.
+ * @returns A promise resolving to the array data in the requested format.
+ *
+ * @example
+ * const buf = await getTiledArrayAs('scans/run1/detector');
+ * const img = await getTiledArrayAs('scans/run1/detector', 'PNG', { stack: [0] });
+ */
+export declare function getTiledArrayAs<T extends TiledArrayReturnType = 'BUFFER'>(arrayPath: string, type?: T, options?: GetArrayAsOptionsMap[T]): Promise<TiledArrayReturnMap[T]>;
+/**
+ * Fetches a Tiled array as JSON data.
+ *
+ * @param arrayPath - Tiled path to the array.
+ * @param options - Array request options (stack, downsampling, format, etc.).
+ * @returns A promise resolving to the array data. Defaults to `number[][]`.
+ *
+ * @example
+ * const frame = await getTiledArrayAsJSON<number[][]>('scans/run1/detector', { stack: [0] });
+ */
+export declare function getTiledArrayAsJSON<T = number[][]>(arrayPath: string, options?: GetArrayAsOptionsMap['JSON']): Promise<T>;
+/**
+ * Fetches a Tiled array as a PNG `Blob`.
+ *
+ * @param arrayPath - Tiled path to the array.
+ * @param options - Array request options (stack, downsampling, format, etc.).
+ * @returns A promise resolving to a PNG `Blob`.
+ */
+export declare function getTiledArrayAsPng(arrayPath: string, options?: GetArrayAsOptionsMap['PNG']): Promise<Blob>;
+/**
+ * Builds and returns the full URL for a Tiled array image without making a
+ * network request. Use the returned string as an `<img src>` attribute.
+ *
+ * This function is synchronous — it uses any structure already present in
+ * `options`; it does not fetch metadata from the server.
+ *
+ * @param arrayPath - Tiled path to the array.
+ * @param options - Array request options (stack, format, downsampling, etc.).
+ * @returns A URL string pointing to the array image endpoint.
+ *
+ * @example
+ * const src = getTiledArrayAsImagePath('scans/run1/detector', { stack: [0] });
+ * return <img src={src} />;
+ */
+export declare function getTiledArrayAsImagePath(arrayPath: string, options?: GetArrayAsOptionsMap['IMAGE_PATH']): string;
+/**
+ * Fetches a Tiled array as a raw `ArrayBuffer`.
+ *
+ * @param arrayPath - Tiled path to the array.
+ * @param options - Array request options (stack, downsampling, format, etc.).
+ * @returns A promise resolving to an `ArrayBuffer` of the raw bytes.
+ */
+export declare function getTiledArrayAsBuffer(arrayPath: string, options?: GetArrayAsOptionsMap['BUFFER']): Promise<ArrayBuffer>;
+/**
+ * Fetches a Tiled table in the specified format and endpoint variant.
+ *
+ * This is the generic dispatcher; prefer the typed convenience helpers
+ * (`getTiledTablePartitionAsJSON`, etc.) for cleaner call sites.
+ *
+ * @param tablePath - Tiled path to the table.
+ * @param type - Return format: `'JSON'` (column-oriented) or `'JSON_SEQ'` (row-oriented).
+ * @param endpoint - `'partition'` (single partition) or `'full'` (entire table).
+ * @param options - Table request options (partition index, format, etc.).
+ * @returns A promise resolving to the table data in the requested format.
+ */
+export declare function getTiledTableAs<T extends TiledTableReturnType>(tablePath: string, type?: T, endpoint?: TiledTableEndpoint, options?: GetTableAsOptionsMap[T]): Promise<TiledTableReturnMap[T]>;
+/**
+ * Fetches a single partition of a Tiled table as column-oriented JSON.
+ *
+ * The response is a `Record<string, unknown[]>` where each key is a column name
+ * and each value is an array of column values.
+ *
+ * @param tablePath - Tiled path to the table.
+ * @param options - Table request options (partition index defaults to `0`).
+ * @returns A promise resolving to the column-oriented JSON response.
+ */
+export declare function getTiledTablePartitionAsJSON(tablePath: string, options?: GetTableAsOptionsMap['JSON']): Promise<TiledTableJSONResponse>;
+/**
+ * Fetches a single partition of a Tiled table as a row-oriented JSON sequence.
+ *
+ * Each element in the returned array is one row represented as a plain object.
+ *
+ * @param tablePath - Tiled path to the table.
+ * @param options - Table request options (partition index defaults to `0`).
+ * @returns A promise resolving to an array of row objects.
+ */
+export declare function getTiledTablePartitionAsJSONSequence(tablePath: string, options?: GetTableAsOptionsMap['JSON_SEQ']): Promise<TiledTableRow[]>;
+/**
+ * Fetches the full (all partitions) Tiled table as column-oriented JSON.
+ *
+ * @param tablePath - Tiled path to the table.
+ * @param options - Table request options.
+ * @returns A promise resolving to the column-oriented JSON response.
+ */
+export declare function getTiledTableFullAsJSON(tablePath: string, options?: GetTableAsOptionsMap['JSON']): Promise<TiledTableJSONResponse>;
+/**
+ * Fetches the full (all partitions) Tiled table as a row-oriented JSON sequence.
+ *
+ * @param tablePath - Tiled path to the table.
+ * @param options - Table request options.
+ * @returns A promise resolving to an array of row objects.
+ */
+export declare function getTiledTableFullAsJSONSequence(tablePath: string, options?: GetTableAsOptionsMap['JSON_SEQ']): Promise<TiledTableRow[]>;
+/**
+ * Fetches Tiled server information (authentication providers, version, etc.).
+ *
+ * Returns `null` if the server is unreachable or the response is malformed.
+ *
+ * @param options - Request options (e.g. `baseUrl` override).
+ * @returns A promise resolving to `TiledInfoResponse` or `null`.
+ */
+export declare function getTiledServerInfo(options?: TiledRequestOptions): Promise<TiledInfoResponse | null>;
+/**
+ * Fetches Tiled item metadata for the given path.
+ *
+ * Returns the `TiledSearchItem` directly (not a `{ data, error }` wrapper).
+ * Access the item path via `item.id` and its structure via
+ * `item.attributes.structure`.
+ *
+ * @param path - Tiled path to the item.
+ * @param options - Request options (e.g. `baseUrl` override).
+ * @returns A promise resolving to the typed `TiledSearchItem`.
+ *
+ * @example
+ * const item = await getTiledMetadata<ArrayStructure>('scans/run1/detector');
+ * console.log(item.attributes.structure.shape);
+ */
+export declare function getTiledMetadata<S extends TiledStructures = TiledStructures>(path: string, options?: TiledRequestOptions): Promise<TiledSearchItem<S>>;
+/**
+ * Performs a Tiled search at the given path with optional filters and options.
+ *
+ * @param searchPath - Container path to search within (empty string for root).
+ * @param config - Search configuration including `searchFilters` and `searchOptions`.
+ * @param requestOptions - Per-request HTTP options (baseUrl, initialPath, etc.).
+ * @returns A promise resolving to a `TiledSearchResult` with paginated items.
+ *
+ * @example
+ * const results = await getTiledSearch('experiments', {
+ *   searchFilters: { specs: { include: ['BlueskyRun'], exclude: [] } },
+ *   searchOptions: { sort: '-', pageLimit: 25 },
+ * });
+ */
+export declare function getTiledSearch(searchPath: string, config?: TiledSearchConfig, requestOptions?: TiledRequestOptions): Promise<TiledSearchResult>;
+/**
+ * Searches a Tiled container, filtering by item specs (tags).
+ *
+ * @param searchPath - Container path to search within.
+ * @param include - Spec strings that items must match (e.g. `['BlueskyRun']`).
+ * @param exclude - Spec strings that items must not have. Defaults to `[]`.
+ * @param searchOptions - Pagination and sorting options.
+ * @param requestOptions - Per-request HTTP options.
+ * @returns A promise resolving to a `TiledSearchResult`.
+ */
+export declare function getTiledSearchBySpecs(searchPath: string, include: string[], exclude?: string[], searchOptions?: TiledSearchOptions, requestOptions?: TiledRequestOptions): Promise<TiledSearchResult>;
+/**
+ * Searches a Tiled container using full-text search across item metadata.
+ *
+ * @param searchPath - Container path to search within.
+ * @param text - Text to search for.
+ * @param searchOptions - Pagination and sorting options.
+ * @param requestOptions - Per-request HTTP options.
+ * @returns A promise resolving to a `TiledSearchResult`.
+ */
+export declare function getTiledSearchByFullText(searchPath: string, text: string, searchOptions?: TiledSearchOptions, requestOptions?: TiledRequestOptions): Promise<TiledSearchResult>;
+/**
+ * Searches a Tiled container for items where a metadata key equals a value.
+ *
+ * @param searchPath - Container path to search within.
+ * @param key - Metadata key to match against.
+ * @param value - Expected value for the metadata key.
+ * @param searchOptions - Pagination and sorting options.
+ * @param requestOptions - Per-request HTTP options.
+ * @returns A promise resolving to a `TiledSearchResult`.
+ */
+export declare function getTiledSearchByMetadataEquals(searchPath: string, key: string, value: string, searchOptions?: TiledSearchOptions, requestOptions?: TiledRequestOptions): Promise<TiledSearchResult>;
+/**
+ * Searches a Tiled container, filtering by structure family.
+ *
+ * @param searchPath - Container path to search within.
+ * @param family - Structure family to filter by: `'container'`, `'array'`,
+ *   `'table'`, `'awkward'`, or `'sparse'`.
+ * @param searchOptions - Pagination and sorting options.
+ * @param requestOptions - Per-request HTTP options.
+ * @returns A promise resolving to a `TiledSearchResult`.
+ */
+export declare function getTiledSearchByStructureFamily(searchPath: string, family: 'container' | 'array' | 'table' | 'awkward' | 'sparse', searchOptions?: TiledSearchOptions, requestOptions?: TiledRequestOptions): Promise<TiledSearchResult>;
+/**
+ * Sets or clears the bearer token on the singleton.
+ *
+ * Once set, every request includes `Authorization: Bearer <token>`. The token
+ * is also automatically refreshed on 401 responses using the refresh token
+ * stored in localStorage.
+ *
+ * @param token - Bearer token string, or `null` to clear it.
+ */
+export declare function setDefaultBearerToken(token: string | null): void;
+/**
+ * Registers a callback that is invoked when a token-refresh attempt fails.
+ *
+ * Use this to show a login prompt or redirect the user. Called with the error
+ * that caused the refresh to fail (or `null` if no stored tokens were found).
+ *
+ * @param callback - Function to call on auth failure, or `undefined` to clear it.
+ */
+export declare function setDefaultAuthErrorCallback(callback: AuthErrorCallback | undefined): void;
+/**
+ * Authenticates with the Tiled server using a username and password.
+ *
+ * Fetches the server's auth endpoint (via `getServerInfo`), POSTs credentials
+ * as `multipart/form-data`, saves the returned tokens to localStorage, and
+ * sets the bearer token on the singleton.
+ *
+ * @param username - The user's login name.
+ * @param password - The user's password.
+ * @param url - Optional server URL override (defaults to the singleton's base URL).
+ * @param provider - Optional pre-fetched auth provider. If omitted, the first
+ *   password/internal provider from server info is used.
+ * @returns A promise resolving to `{ access_token, refresh_token }` on success,
+ *   or `null` on failure.
+ *
+ * @example
+ * const tokens = await loginWithDefaultTiledClient('alice', 'secret');
+ * if (!tokens) console.error('Login failed');
+ */
+export declare function loginWithDefaultTiledClient(username: string, password: string, url?: string, provider?: TiledAuthProvider): Promise<{
+    access_token: string;
+    refresh_token: string;
+} | null>;
+//# sourceMappingURL=defaultTiledApiClient.d.ts.map

package/dist/components/Tiled/api/defaultTiledApiClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultTiledApiClient.d.ts","sourceRoot":"","sources":["../../../../src/components/Tiled/api/defaultTiledApiClient.ts"],"names":[],"mappings":"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"}

package/dist/components/Tiled/{apiClient.d.ts → archived_apiClient.d.ts}

@@ -1,5 +1,11 @@
 import { TiledInfoResponse, TiledSearchResult, TiledAuthProvider, TiledTableRow, TiledStructuredArrayData, TiledTableJSONResponse, TiledBlueskyPlanMetadataResponse, TiledSearchMetadataResult } from './types';
 import { TiledSearchConfig, TiledSearchOptions } from './apiTypes';
+/**
+ *  Sets the global Tiled server URL that will be used for all subsequent API requests
+ * @param url - The Tiled server URL to set, or null to clear it
+ * @returns The Tiled server URL that was set
+ */
+export declare const setGlobalUrl: (url: string | null) => string | null;
 /**
  * Sets the global initial path that will be prepended to all search paths
  * Automatically removes leading slash to ensure proper path formatting
@@ -63,15 +69,8 @@ type AuthErrorCallback = (error: any) => void;
  */
 export declare const setAuthErrorCallback: (callback: AuthErrorCallback) => void;
 /**
- * Determines the default Tiled server URL based on environment variables or current location
- * First checks for VITE_API_TILED_URL environment variable, otherwise constructs URL from current hostname
- * @returns The default Tiled server URL string
- * @example
- * ```typescript
- * const url = getDefaultTiledUrl();
- * // If VITE_API_TILED_URL is set: returns that value
- * // Otherwise: returns "http://localhost:8000/api/v1" (or current hostname)
- * ```
+ * Returns the active Tiled server URL: globalUrl if set, otherwise constructs one from current hostname
+ * @returns The Tiled server URL string
  */
 export declare const getDefaultTiledUrl: () => string;
 /**
@@ -375,4 +374,4 @@ export declare const searchByStructureFamily: (baseUrl: string, structureFamily:
  */
 export declare const searchById: (config: TiledSearchConfig, cb?: (res: TiledSearchResult) => void) => Promise<TiledSearchResult | null>;
 export {};
-//# sourceMappingURL=apiClient.d.ts.map
+//# sourceMappingURL=archived_apiClient.d.ts.map

package/dist/components/Tiled/archived_apiClient.d.ts.map

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

package/dist/components/Tiled/useTiled.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useTiled.d.ts","sourceRoot":"","sources":["../../../src/components/Tiled/useTiled.ts"],"names":[],"mappings":"AAIA,OAAO,EACH,iBAAiB,EACjB,eAAe,EAEf,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,WAAW,EAMX,eAAe,EACjB,MAAM,SAAS,CAAC;AAGlB,MAAM,MAAM,aAAa,GAAG;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACrC,CAAA;AACD,KAAK,GAAG,GAAG,MAAM,CAAC;AA8BlB,eAAO,MAAM,QAAQ,iHAA+G,aAAa;;;;;;;;kCA8G7F,eAAe,CAAC,eAAe,CAAC;+BAOlC,eAAe,CAAC,eAAe,CAAC,SAAS,MAAM;gCArG7D,IAAI;iCACH,IAAI;;;+BA6TJ,GAAG,eAAc,MAAM,kBAAiB,MAAM;yBAlGlC,MAAM;qCA2BM,MAAM;6BAgBd,MAAM;CAuI1D,CAAA"}
+{"version":3,"file":"useTiled.d.ts","sourceRoot":"","sources":["../../../src/components/Tiled/useTiled.ts"],"names":[],"mappings":"AAIA,OAAO,EACH,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,WAAW,EAMX,eAAe,EACjB,MAAM,SAAS,CAAC;AAGlB,MAAM,MAAM,aAAa,GAAG;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACrC,CAAA;AACD,KAAK,GAAG,GAAG,MAAM,CAAC;AA8BlB,eAAO,MAAM,QAAQ,iHAA+G,aAAa;;;;;;;;kCA8G7F,eAAe,CAAC,eAAe,CAAC;+BAOlC,eAAe,CAAC,eAAe,CAAC,SAAS,MAAM;gCArG7D,IAAI;iCACH,IAAI;;;+BA8TJ,GAAG,eAAc,MAAM,kBAAiB,MAAM;yBAjGlC,MAAM;qCA2BM,MAAM;6BAgBd,MAAM;CAsI1D,CAAA"}

package/dist/components/Tiled/utils.d.ts

@@ -180,4 +180,11 @@ export declare const generateStepsForImagePath: (arrayItem: TiledSearchItem<Arra
  * ```
  */
 export declare const isItemBlueskyRun: (item: TiledSearchItem<TiledStructures>) => boolean;
+/**
+ * Normalizes and validates a URL
+ * @param url - Raw URL that might be malformed
+ * @param label - Human-readable name for error messages
+ * @returns Cleaned URL or undefined if invalid
+ */
+export declare function cleanUrl(url: string | undefined, label: string): string | null;
 //# sourceMappingURL=utils.d.ts.map