@vielzeug/sourcerer 2.3.0 → 3.0.0

package/dist/errors.js

@@ -1,10 +1,18 @@
 //#region src/errors.ts
 var e = class extends Error {
+	static errorName = "SourcererError";
 	constructor(e, t) {
-		super(e, t), this.name = new.target.name, Object.setPrototypeOf(this, new.target.prototype);
+		super(e, t), this.name = new.target.errorName, Object.setPrototypeOf(this, new.target.prototype);
 	}
-}, t = class extends e {};
+}, t = class extends e {
+	static errorName = "SourcererConfigurationError";
+}, n = class extends e {
+	static errorName = "SourcererDisposedError";
+	constructor(e = "Sourcerer source disposed") {
+		super(e);
+	}
+};
 //#endregion
-export { t as SourcererConfigurationError, e as SourcererError };
+export { t as SourcererConfigurationError, n as SourcererDisposedError, e as SourcererError };
 
 //# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all sourcerer errors. Use `instanceof SourcererError` to catch any sourcerer-originated error. */\nexport class SourcererError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/** Thrown when a source is configured or queried with invalid arguments. */\nexport class SourcererConfigurationError extends SourcererError {}\n"],"mappings":";AACA,IAAa,IAAb,cAAoC,MAAM;CACxC,YAAY,GAAiB,GAAqB;EAGhD,AAFA,MAAM,GAAS,CAAI,GACnB,KAAK,OAAO,WAAW,MACvB,OAAO,eAAe,MAAM,WAAW,SAAS;CAClD;AACF,GAGa,IAAb,cAAiD,EAAe,CAAC"}
+{"version":3,"file":"errors.js","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/** Base class for all sourcerer errors. Use `instanceof SourcererError` to catch any sourcerer-originated error. */\nexport class SourcererError extends Error {\n  protected static readonly errorName: string = 'SourcererError';\n\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = (new.target as typeof SourcererError).errorName;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/** Thrown when a source is configured or queried with invalid arguments. */\nexport class SourcererConfigurationError extends SourcererError {\n  protected static override readonly errorName = 'SourcererConfigurationError';\n}\n\nexport class SourcererDisposedError extends SourcererError {\n  protected static override readonly errorName = 'SourcererDisposedError';\n\n  constructor(message = 'Sourcerer source disposed') {\n    super(message);\n  }\n}\n"],"mappings":";AACA,IAAa,IAAb,cAAoC,MAAM;CACxC,OAA0B,YAAoB;CAE9C,YAAY,GAAiB,GAAqB;EAGhD,AAFA,MAAM,GAAS,CAAI,GACnB,KAAK,OAAQ,WAAqC,WAClD,OAAO,eAAe,MAAM,WAAW,SAAS;CAClD;AACF,GAGa,IAAb,cAAiD,EAAe;CAC9D,OAAmC,YAAY;AACjD,GAEa,IAAb,cAA4C,EAAe;CACzD,OAAmC,YAAY;CAE/C,YAAY,IAAU,6BAA6B;EACjD,MAAM,CAAO;CACf;AACF"}

package/dist/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./errors.cjs"),t=require("./cursorSource.cjs"),n=require("./infiniteSource.cjs"),r=require("./localSource.cjs"),i=require("./pageSource.cjs");exports.SourcererConfigurationError=e.SourcererConfigurationError,exports.SourcererError=e.SourcererError,exports.createCursorSource=t.createCursorSource,exports.createInfiniteSource=n.createInfiniteSource,exports.createLocalSource=r.createLocalSource,exports.createPageSource=i.createPageSource;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./errors.cjs"),t=require("./cursorSource.cjs"),n=require("./infiniteSource.cjs"),r=require("./localSource.cjs"),i=require("./pageSource.cjs");exports.SourcererConfigurationError=e.SourcererConfigurationError,exports.SourcererDisposedError=e.SourcererDisposedError,exports.SourcererError=e.SourcererError,exports.createCursorSource=t.createCursorSource,exports.createInfiniteSource=n.createInfiniteSource,exports.createLocalSource=r.createLocalSource,exports.createPageSource=i.createPageSource;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { createCursorSource } from './cursorSource';
-export { SourcererConfigurationError, SourcererError } from './errors';
+export { SourcererConfigurationError, SourcererDisposedError, SourcererError } from './errors';
 export { createInfiniteSource } from './infiniteSource';
 export { createLocalSource } from './localSource';
 export { createPageSource } from './pageSource';
-export type { AnyPagination, CursorPagination, CursorQuery, CursorQueryPatch, CursorResult, CursorSource, CursorSourceConfig, InfiniteLoadQuery, InfinitePagination, InfiniteQuery, InfiniteQueryPatch, InfiniteSource, InfiniteSourceConfig, LoadContext, LocalQuery, LocalQueryPatch, LocalSource, LocalSourceConfig, PagePagination, PageQuery, PageQueryPatch, PageResult, PageSource, PageSourceConfig, Source, SourceSnapshot, } from './types';
+export type { CursorLoadContext, CursorPagination, CursorResult, CursorSource, CursorSourceConfig, CursorSourceState, InfiniteLoadContext, InfinitePagination, InfiniteSource, InfiniteSourceConfig, InfiniteSourceState, LocalSource, LocalSourceConfig, LocalSourceState, PageLoadContext, PagePagination, PageResult, PageSource, PageSourceConfig, PageSourceState, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,2BAA2B,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,WAAW,EACX,UAAU,EACV,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,SAAS,EACT,cAAc,EACd,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,MAAM,EACN,cAAc,GACf,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/F,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,eAAe,GAChB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
-import { SourcererConfigurationError as e, SourcererError as t } from "./errors.js";
-import { createCursorSource as n } from "./cursorSource.js";
-import { createInfiniteSource as r } from "./infiniteSource.js";
-import { createLocalSource as i } from "./localSource.js";
-import { createPageSource as a } from "./pageSource.js";
-export { e as SourcererConfigurationError, t as SourcererError, n as createCursorSource, r as createInfiniteSource, i as createLocalSource, a as createPageSource };
+import { SourcererConfigurationError as e, SourcererDisposedError as t, SourcererError as n } from "./errors.js";
+import { createCursorSource as r } from "./cursorSource.js";
+import { createInfiniteSource as i } from "./infiniteSource.js";
+import { createLocalSource as a } from "./localSource.js";
+import { createPageSource as o } from "./pageSource.js";
+export { e as SourcererConfigurationError, t as SourcererDisposedError, n as SourcererError, r as createCursorSource, i as createInfiniteSource, a as createLocalSource, o as createPageSource };

package/dist/infiniteSource.cjs

@@ -1,2 +1,2 @@
-const e=require("./_dev.cjs"),t=require("./asyncSource.cjs"),n=require("./pagination.cjs");var r=(e,t)=>({hasMore:e<t,kind:`infinite`,loaded:e,total:t}),i=(e,t={})=>({pageSize:n.positiveInteger(t.pageSize??e.pageSize,`pageSize`),search:t.search??e.search});function a(a){let o=i({pageSize:20,search:``},a.initialQuery),s=1,c=t.createAsyncSource({data:[],error:null,isFetching:!1,pagination:r(0,0),query:o}),l=(e,t,i)=>{let o=c.snapshot.data;return c.fetch({load:n=>a.load({query:{page:t,pageSize:e.pageSize,search:e.search},signal:n}),pending:t=>({...t,error:null,isFetching:!0,pagination:r(t.data.length,t.pagination.total),...i?{}:{pendingQuery:e}}),query:e,success:a=>{let c=n.totalItems(a.total),l=i?[...o,...a.data]:a.data;return s=t+1,{data:l,error:null,isFetching:!1,pagination:r(l.length,c),query:e}}})},u=()=>(s=1,l(o,1,!1)),d={get disposalSignal(){return c.disposalSignal},dispose:c.dispose,get disposed(){return c.disposed},loadMore(){let{isFetching:e,pagination:t}=c.snapshot;return e||c.snapshot.data.length>0&&!t.hasMore?Promise.resolve():l(o,s,!0)},reload:u,setQuery:async e=>{let t=i(c.snapshot.pendingQuery??c.snapshot.query,e);n.sameQuery(t,o)||(o=t,s=1,await l(t,1,!1))},get snapshot(){return c.snapshot},subscribe:c.subscribe,[Symbol.dispose](){d.dispose()}};return a.autoStart!==!1&&u().catch(()=>e.warn(`Initial load failed. Inspect source.snapshot.error.`)),d}exports.createInfiniteSource=a;
+const e=require("./errors.cjs"),t=require("./asyncSource.cjs"),n=require("./pagination.cjs");var r=(e,t,n)=>({hasMore:e<n,loadedItems:e,pageSize:t,totalItems:n});function i(i){let a={pageSize:n.positiveInteger(i.pageSize??20,`pageSize`),params:i.params},o=1,s=!1,c=t.createAsyncSource({error:null,items:[],loading:!1,pagination:r(0,a.pageSize,0),params:a.params}),l=()=>{if(c.disposed)throw new e.SourcererDisposedError},u=(e,t,l)=>{let u=c.state.items;return c.fetch({commit:()=>{s=!0,o=t+1,a=e},failure:(e,t)=>({...e,error:t,loading:!1,pendingParams:void 0}),load:n=>i.load({page:t,pageSize:e.pageSize,params:e.params,signal:n}),pending:t=>({...t,error:null,loading:!0,...l||Object.is(e.params,t.params)?{}:{pendingParams:e.params}}),success:t=>{let i=l?[...u,...t.items]:[...t.items];return{error:null,items:i,loading:!1,pagination:r(i.length,e.pageSize,n.totalItems(t.totalItems)),params:e.params}}})},d=()=>u(a,1,!1),f={get disposalSignal(){return c.disposalSignal},dispose:c.dispose,get disposed(){return c.disposed},async loadMore(){if(l(),!c.state.loading){if(!s||!Object.is(a.params,c.state.params)){await d();return}c.state.pagination.hasMore&&await u(a,o,!0)}},reload:d,async setPageSize(e){l();let t=n.positiveInteger(e,`pageSize`);if(t===a.pageSize){if(c.state.loading||c.state.pagination.pageSize===t)return;await d();return}a={...a,pageSize:t},o=1,await d()},async setParams(e){if(l(),Object.is(e,a.params)){!c.state.loading&&!Object.is(e,c.state.params)&&await d();return}a={...a,params:e},o=1,await d()},get state(){return c.state},subscribe:c.subscribe,[Symbol.dispose](){f.dispose()}};return f}exports.createInfiniteSource=i;
 //# sourceMappingURL=infiniteSource.cjs.map

package/dist/infiniteSource.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"infiniteSource.cjs","names":[],"sources":["../src/infiniteSource.ts"],"sourcesContent":["import { warn } from './_dev';\nimport { createAsyncSource } from './asyncSource';\nimport { positiveInteger, sameQuery, totalItems } from './pagination';\nimport type {\n  InfinitePagination,\n  InfiniteQuery,\n  InfiniteQueryPatch,\n  InfiniteSource,\n  InfiniteSourceConfig,\n} from './types';\n\nconst createPagination = (loaded: number, total: number): InfinitePagination => ({\n  hasMore: loaded < total,\n  kind: 'infinite',\n  loaded,\n  total,\n});\n\nconst normalizeQuery = (current: InfiniteQuery, patch: InfiniteQueryPatch = {}): InfiniteQuery => ({\n  pageSize: positiveInteger(patch.pageSize ?? current.pageSize, 'pageSize'),\n  search: patch.search ?? current.search,\n});\n\n/** Infinite sources preserve loaded collection state while a pending query replaces it. */\nexport function createInfiniteSource<T>(config: InfiniteSourceConfig<T>): InfiniteSource<T> {\n  const initialQuery: InfiniteQuery = { pageSize: 20, search: '' };\n  let requestedQuery = normalizeQuery(initialQuery, config.initialQuery);\n  let nextPage = 1;\n  const asyncSource = createAsyncSource<T, InfiniteQuery, InfinitePagination>({\n    data: [],\n    error: null,\n    isFetching: false,\n    pagination: createPagination(0, 0),\n    query: requestedQuery,\n  });\n\n  const fetch = (query: InfiniteQuery, page: number, append: boolean): Promise<void> => {\n    const loadedData = asyncSource.snapshot.data;\n\n    return asyncSource.fetch({\n      load: (signal) => config.load({ query: { page, pageSize: query.pageSize, search: query.search }, signal }),\n      pending: (previous) => ({\n        ...previous,\n        error: null,\n        isFetching: true,\n        pagination: createPagination(previous.data.length, previous.pagination.total),\n        ...(append ? {} : { pendingQuery: query }),\n      }),\n      query,\n      success: (result) => {\n        const total = totalItems(result.total);\n        const data = append ? [...loadedData, ...result.data] : result.data;\n\n        nextPage = page + 1;\n\n        return {\n          data,\n          error: null,\n          isFetching: false,\n          pagination: createPagination(data.length, total),\n          query,\n        };\n      },\n    });\n  };\n\n  const reload = (): Promise<void> => {\n    nextPage = 1;\n\n    return fetch(requestedQuery, 1, false);\n  };\n\n  const setQuery = async (patch: InfiniteQueryPatch): Promise<void> => {\n    const current = asyncSource.snapshot.pendingQuery ?? asyncSource.snapshot.query;\n    const next = normalizeQuery(current, patch);\n\n    if (sameQuery(next, requestedQuery)) return;\n\n    requestedQuery = next;\n    nextPage = 1;\n    await fetch(next, 1, false);\n  };\n\n  const source: InfiniteSource<T> = {\n    get disposalSignal() {\n      return asyncSource.disposalSignal;\n    },\n\n    dispose: asyncSource.dispose,\n\n    get disposed() {\n      return asyncSource.disposed;\n    },\n\n    loadMore() {\n      const { isFetching, pagination } = asyncSource.snapshot;\n\n      return isFetching || (asyncSource.snapshot.data.length > 0 && !pagination.hasMore)\n        ? Promise.resolve()\n        : fetch(requestedQuery, nextPage, true);\n    },\n\n    reload,\n    setQuery,\n\n    get snapshot() {\n      return asyncSource.snapshot;\n    },\n\n    subscribe: asyncSource.subscribe,\n\n    [Symbol.dispose]() {\n      source.dispose();\n    },\n  };\n\n  if (config.autoStart !== false)\n    void reload().catch(() => warn('Initial load failed. Inspect source.snapshot.error.'));\n\n  return source;\n}\n"],"mappings":"2FAWA,IAAM,GAAoB,EAAgB,KAAuC,CAC/E,QAAS,EAAS,EAClB,KAAM,WACN,SACA,OACF,GAEM,GAAkB,EAAwB,EAA4B,CAAC,KAAsB,CACjG,SAAU,EAAA,gBAAgB,EAAM,UAAY,EAAQ,SAAU,UAAU,EACxE,OAAQ,EAAM,QAAU,EAAQ,MAClC,GAGA,SAAgB,EAAwB,EAAoD,CAE1F,IAAI,EAAiB,EAAe,CADE,SAAU,GAAI,OAAQ,EACxB,EAAc,EAAO,YAAY,EACjE,EAAW,EACT,EAAc,EAAA,kBAAwD,CAC1E,KAAM,CAAC,EACP,MAAO,KACP,WAAY,GACZ,WAAY,EAAiB,EAAG,CAAC,EACjC,MAAO,CACT,CAAC,EAEK,GAAS,EAAsB,EAAc,IAAmC,CACpF,IAAM,EAAa,EAAY,SAAS,KAExC,OAAO,EAAY,MAAM,CACvB,KAAO,GAAW,EAAO,KAAK,CAAE,MAAO,CAAE,OAAM,SAAU,EAAM,SAAU,OAAQ,EAAM,MAAO,EAAG,QAAO,CAAC,EACzG,QAAU,IAAc,CACtB,GAAG,EACH,MAAO,KACP,WAAY,GACZ,WAAY,EAAiB,EAAS,KAAK,OAAQ,EAAS,WAAW,KAAK,EAC5E,GAAI,EAAS,CAAC,EAAI,CAAE,aAAc,CAAM,CAC1C,GACA,QACA,QAAU,GAAW,CACnB,IAAM,EAAQ,EAAA,WAAW,EAAO,KAAK,EAC/B,EAAO,EAAS,CAAC,GAAG,EAAY,GAAG,EAAO,IAAI,EAAI,EAAO,KAI/D,MAFA,GAAW,EAAO,EAEX,CACL,OACA,MAAO,KACP,WAAY,GACZ,WAAY,EAAiB,EAAK,OAAQ,CAAK,EAC/C,OACF,CACF,CACF,CAAC,CACH,EAEM,OACJ,EAAW,EAEJ,EAAM,EAAgB,EAAG,EAAK,GAcjC,EAA4B,CAChC,IAAI,gBAAiB,CACnB,OAAO,EAAY,cACrB,EAEA,QAAS,EAAY,QAErB,IAAI,UAAW,CACb,OAAO,EAAY,QACrB,EAEA,UAAW,CACT,GAAM,CAAE,aAAY,cAAe,EAAY,SAE/C,OAAO,GAAe,EAAY,SAAS,KAAK,OAAS,GAAK,CAAC,EAAW,QACtE,QAAQ,QAAQ,EAChB,EAAM,EAAgB,EAAU,EAAI,CAC1C,EAEA,SACA,cA/BsB,IAA6C,CAEnE,IAAM,EAAO,EADG,EAAY,SAAS,cAAgB,EAAY,SAAS,MACrC,CAAK,EAEtC,EAAA,UAAU,EAAM,CAAc,IAElC,EAAiB,EACjB,EAAW,EACX,MAAM,EAAM,EAAM,EAAG,EAAK,EAC5B,EAwBE,IAAI,UAAW,CACb,OAAO,EAAY,QACrB,EAEA,UAAW,EAAY,UAEvB,CAAC,OAAO,UAAW,CACjB,EAAO,QAAQ,CACjB,CACF,EAKA,OAHI,EAAO,YAAc,IACvB,EAAY,CAAC,CAAC,UAAY,EAAA,KAAK,qDAAqD,CAAC,EAEhF,CACT"}
+{"version":3,"file":"infiniteSource.cjs","names":[],"sources":["../src/infiniteSource.ts"],"sourcesContent":["import { createAsyncSource } from './asyncSource';\nimport { SourcererDisposedError } from './errors';\nimport { positiveInteger, totalItems } from './pagination';\nimport type { InfinitePagination, InfiniteSource, InfiniteSourceConfig, InfiniteSourceState } from './types';\n\ntype Request<TParams> = Readonly<{ pageSize: number; params: TParams }>;\n\nconst createPagination = (loadedItems: number, pageSize: number, total: number): InfinitePagination => ({\n  hasMore: loadedItems < total,\n  loadedItems,\n  pageSize,\n  totalItems: total,\n});\n\n/** Infinite sources retain committed items while replacement work is pending. */\nexport function createInfiniteSource<T, TParams = undefined>(\n  config: InfiniteSourceConfig<T, TParams>,\n): InfiniteSource<T, TParams> {\n  let requested: Request<TParams> = {\n    pageSize: positiveInteger(config.pageSize ?? 20, 'pageSize'),\n    params: config.params as TParams,\n  };\n  let nextPage = 1;\n  let hasLoaded = false;\n  const asyncSource = createAsyncSource<InfiniteSourceState<T, TParams>>({\n    error: null,\n    items: [],\n    loading: false,\n    pagination: createPagination(0, requested.pageSize, 0),\n    params: requested.params,\n  });\n  const assertLive = (): void => {\n    if (asyncSource.disposed) throw new SourcererDisposedError();\n  };\n\n  const fetch = (request: Request<TParams>, page: number, append: boolean): Promise<void> => {\n    const loadedItems = asyncSource.state.items;\n\n    return asyncSource.fetch({\n      commit: () => {\n        hasLoaded = true;\n        nextPage = page + 1;\n        requested = request;\n      },\n      failure: (previous, error) => ({ ...previous, error, loading: false, pendingParams: undefined }),\n      load: (signal) => config.load({ page, pageSize: request.pageSize, params: request.params, signal }),\n      pending: (previous) => ({\n        ...previous,\n        error: null,\n        loading: true,\n        ...(append || Object.is(request.params, previous.params) ? {} : { pendingParams: request.params }),\n      }),\n      success: (result) => {\n        const items = append ? [...loadedItems, ...result.items] : [...result.items];\n        return {\n          error: null,\n          items,\n          loading: false,\n          pagination: createPagination(items.length, request.pageSize, totalItems(result.totalItems)),\n          params: request.params,\n        };\n      },\n    });\n  };\n\n  const reload = (): Promise<void> => fetch(requested, 1, false);\n\n  const source: InfiniteSource<T, TParams> = {\n    get disposalSignal() {\n      return asyncSource.disposalSignal;\n    },\n\n    dispose: asyncSource.dispose,\n\n    get disposed() {\n      return asyncSource.disposed;\n    },\n\n    async loadMore() {\n      assertLive();\n      if (asyncSource.state.loading) return;\n      if (!hasLoaded || !Object.is(requested.params, asyncSource.state.params)) {\n        await reload();\n        return;\n      }\n      if (asyncSource.state.pagination.hasMore) await fetch(requested, nextPage, true);\n    },\n\n    reload,\n\n    async setPageSize(pageSize) {\n      assertLive();\n      const normalized = positiveInteger(pageSize, 'pageSize');\n      if (normalized === requested.pageSize) {\n        if (asyncSource.state.loading || asyncSource.state.pagination.pageSize === normalized) return;\n        await reload();\n        return;\n      }\n      requested = { ...requested, pageSize: normalized };\n      nextPage = 1;\n      await reload();\n    },\n\n    async setParams(params) {\n      assertLive();\n      if (Object.is(params, requested.params)) {\n        if (!asyncSource.state.loading && !Object.is(params, asyncSource.state.params)) await reload();\n        return;\n      }\n      requested = { ...requested, params };\n      nextPage = 1;\n      await reload();\n    },\n\n    get state() {\n      return asyncSource.state;\n    },\n\n    subscribe: asyncSource.subscribe,\n\n    [Symbol.dispose]() {\n      source.dispose();\n    },\n  };\n\n  return source;\n}\n"],"mappings":"6FAOA,IAAM,GAAoB,EAAqB,EAAkB,KAAuC,CACtG,QAAS,EAAc,EACvB,cACA,WACA,WAAY,CACd,GAGA,SAAgB,EACd,EAC4B,CAC5B,IAAI,EAA8B,CAChC,SAAU,EAAA,gBAAgB,EAAO,UAAY,GAAI,UAAU,EAC3D,OAAQ,EAAO,MACjB,EACI,EAAW,EACX,EAAY,GACV,EAAc,EAAA,kBAAmD,CACrE,MAAO,KACP,MAAO,CAAC,EACR,QAAS,GACT,WAAY,EAAiB,EAAG,EAAU,SAAU,CAAC,EACrD,OAAQ,EAAU,MACpB,CAAC,EACK,MAAyB,CAC7B,GAAI,EAAY,SAAU,MAAM,IAAI,EAAA,sBACtC,EAEM,GAAS,EAA2B,EAAc,IAAmC,CACzF,IAAM,EAAc,EAAY,MAAM,MAEtC,OAAO,EAAY,MAAM,CACvB,WAAc,CACZ,EAAY,GACZ,EAAW,EAAO,EAClB,EAAY,CACd,EACA,SAAU,EAAU,KAAW,CAAE,GAAG,EAAU,QAAO,QAAS,GAAO,cAAe,IAAA,EAAU,GAC9F,KAAO,GAAW,EAAO,KAAK,CAAE,OAAM,SAAU,EAAQ,SAAU,OAAQ,EAAQ,OAAQ,QAAO,CAAC,EAClG,QAAU,IAAc,CACtB,GAAG,EACH,MAAO,KACP,QAAS,GACT,GAAI,GAAU,OAAO,GAAG,EAAQ,OAAQ,EAAS,MAAM,EAAI,CAAC,EAAI,CAAE,cAAe,EAAQ,MAAO,CAClG,GACA,QAAU,GAAW,CACnB,IAAM,EAAQ,EAAS,CAAC,GAAG,EAAa,GAAG,EAAO,KAAK,EAAI,CAAC,GAAG,EAAO,KAAK,EAC3E,MAAO,CACL,MAAO,KACP,QACA,QAAS,GACT,WAAY,EAAiB,EAAM,OAAQ,EAAQ,SAAU,EAAA,WAAW,EAAO,UAAU,CAAC,EAC1F,OAAQ,EAAQ,MAClB,CACF,CACF,CAAC,CACH,EAEM,MAA8B,EAAM,EAAW,EAAG,EAAK,EAEvD,EAAqC,CACzC,IAAI,gBAAiB,CACnB,OAAO,EAAY,cACrB,EAEA,QAAS,EAAY,QAErB,IAAI,UAAW,CACb,OAAO,EAAY,QACrB,EAEA,MAAM,UAAW,CACf,KAAW,EACP,GAAY,MAAM,QACtB,IAAI,CAAC,GAAa,CAAC,OAAO,GAAG,EAAU,OAAQ,EAAY,MAAM,MAAM,EAAG,CACxE,MAAM,EAAO,EACb,MACF,CACI,EAAY,MAAM,WAAW,SAAS,MAAM,EAAM,EAAW,EAAU,EAAI,CAD/E,CAEF,EAEA,SAEA,MAAM,YAAY,EAAU,CAC1B,EAAW,EACX,IAAM,EAAa,EAAA,gBAAgB,EAAU,UAAU,EACvD,GAAI,IAAe,EAAU,SAAU,CACrC,GAAI,EAAY,MAAM,SAAW,EAAY,MAAM,WAAW,WAAa,EAAY,OACvF,MAAM,EAAO,EACb,MACF,CACA,EAAY,CAAE,GAAG,EAAW,SAAU,CAAW,EACjD,EAAW,EACX,MAAM,EAAO,CACf,EAEA,MAAM,UAAU,EAAQ,CAEtB,GADA,EAAW,EACP,OAAO,GAAG,EAAQ,EAAU,MAAM,EAAG,CACnC,CAAC,EAAY,MAAM,SAAW,CAAC,OAAO,GAAG,EAAQ,EAAY,MAAM,MAAM,GAAG,MAAM,EAAO,EAC7F,MACF,CACA,EAAY,CAAE,GAAG,EAAW,QAAO,EACnC,EAAW,EACX,MAAM,EAAO,CACf,EAEA,IAAI,OAAQ,CACV,OAAO,EAAY,KACrB,EAEA,UAAW,EAAY,UAEvB,CAAC,OAAO,UAAW,CACjB,EAAO,QAAQ,CACjB,CACF,EAEA,OAAO,CACT"}

package/dist/infiniteSource.d.ts

@@ -1,4 +1,4 @@
 import type { InfiniteSource, InfiniteSourceConfig } from './types';
-/** Infinite sources preserve loaded collection state while a pending query replaces it. */
-export declare function createInfiniteSource<T>(config: InfiniteSourceConfig<T>): InfiniteSource<T>;
+/** Infinite sources retain committed items while replacement work is pending. */
+export declare function createInfiniteSource<T, TParams = undefined>(config: InfiniteSourceConfig<T, TParams>): InfiniteSource<T, TParams>;
 //# sourceMappingURL=infiniteSource.d.ts.map

package/dist/infiniteSource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"infiniteSource.d.ts","sourceRoot":"","sources":["../src/infiniteSource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAIV,cAAc,EACd,oBAAoB,EACrB,MAAM,SAAS,CAAC;AAcjB,2FAA2F;AAC3F,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAgG1F"}
+{"version":3,"file":"infiniteSource.d.ts","sourceRoot":"","sources":["../src/infiniteSource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAsB,cAAc,EAAE,oBAAoB,EAAuB,MAAM,SAAS,CAAC;AAW7G,iFAAiF;AACjF,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,GAAG,SAAS,EACzD,MAAM,EAAE,oBAAoB,CAAC,CAAC,EAAE,OAAO,CAAC,GACvC,cAAc,CAAC,CAAC,EAAE,OAAO,CAAC,CA6G5B"}

package/dist/infiniteSource.js

@@ -1,57 +1,61 @@
-import { warn as e } from "./_dev.js";
+import { SourcererDisposedError as e } from "./errors.js";
 import { createAsyncSource as t } from "./asyncSource.js";
-import { positiveInteger as n, sameQuery as r, totalItems as i } from "./pagination.js";
+import { positiveInteger as n, totalItems as r } from "./pagination.js";
 //#region src/infiniteSource.ts
-var a = (e, t) => ({
-	hasMore: e < t,
-	kind: "infinite",
-	loaded: e,
-	total: t
-}), o = (e, t = {}) => ({
-	pageSize: n(t.pageSize ?? e.pageSize, "pageSize"),
-	search: t.search ?? e.search
+var i = (e, t, n) => ({
+	hasMore: e < n,
+	loadedItems: e,
+	pageSize: t,
+	totalItems: n
 });
-function s(n) {
-	let s = o({
-		pageSize: 20,
-		search: ""
-	}, n.initialQuery), c = 1, l = t({
-		data: [],
+function a(a) {
+	let o = {
+		pageSize: n(a.pageSize ?? 20, "pageSize"),
+		params: a.params
+	}, s = 1, c = !1, l = t({
 		error: null,
-		isFetching: !1,
-		pagination: a(0, 0),
-		query: s
-	}), u = (e, t, r) => {
-		let o = l.snapshot.data;
+		items: [],
+		loading: !1,
+		pagination: i(0, o.pageSize, 0),
+		params: o.params
+	}), u = () => {
+		if (l.disposed) throw new e();
+	}, d = (e, t, n) => {
+		let u = l.state.items;
 		return l.fetch({
-			load: (r) => n.load({
-				query: {
-					page: t,
-					pageSize: e.pageSize,
-					search: e.search
-				},
-				signal: r
+			commit: () => {
+				c = !0, s = t + 1, o = e;
+			},
+			failure: (e, t) => ({
+				...e,
+				error: t,
+				loading: !1,
+				pendingParams: void 0
+			}),
+			load: (n) => a.load({
+				page: t,
+				pageSize: e.pageSize,
+				params: e.params,
+				signal: n
 			}),
 			pending: (t) => ({
 				...t,
 				error: null,
-				isFetching: !0,
-				pagination: a(t.data.length, t.pagination.total),
-				...r ? {} : { pendingQuery: e }
+				loading: !0,
+				...n || Object.is(e.params, t.params) ? {} : { pendingParams: e.params }
 			}),
-			query: e,
-			success: (n) => {
-				let s = i(n.total), l = r ? [...o, ...n.data] : n.data;
-				return c = t + 1, {
-					data: l,
+			success: (t) => {
+				let a = n ? [...u, ...t.items] : [...t.items];
+				return {
 					error: null,
-					isFetching: !1,
-					pagination: a(l.length, s),
-					query: e
+					items: a,
+					loading: !1,
+					pagination: i(a.length, e.pageSize, r(t.totalItems)),
+					params: e.params
 				};
 			}
 		});
-	}, d = () => (c = 1, u(s, 1, !1)), f = {
+	}, f = () => d(o, 1, !1), p = {
 		get disposalSignal() {
 			return l.disposalSignal;
 		},
@@ -59,26 +63,50 @@ function s(n) {
 		get disposed() {
 			return l.disposed;
 		},
-		loadMore() {
-			let { isFetching: e, pagination: t } = l.snapshot;
-			return e || l.snapshot.data.length > 0 && !t.hasMore ? Promise.resolve() : u(s, c, !0);
+		async loadMore() {
+			if (u(), !l.state.loading) {
+				if (!c || !Object.is(o.params, l.state.params)) {
+					await f();
+					return;
+				}
+				l.state.pagination.hasMore && await d(o, s, !0);
+			}
 		},
-		reload: d,
-		setQuery: async (e) => {
-			let t = o(l.snapshot.pendingQuery ?? l.snapshot.query, e);
-			r(t, s) || (s = t, c = 1, await u(t, 1, !1));
+		reload: f,
+		async setPageSize(e) {
+			u();
+			let t = n(e, "pageSize");
+			if (t === o.pageSize) {
+				if (l.state.loading || l.state.pagination.pageSize === t) return;
+				await f();
+				return;
+			}
+			o = {
+				...o,
+				pageSize: t
+			}, s = 1, await f();
+		},
+		async setParams(e) {
+			if (u(), Object.is(e, o.params)) {
+				!l.state.loading && !Object.is(e, l.state.params) && await f();
+				return;
+			}
+			o = {
+				...o,
+				params: e
+			}, s = 1, await f();
 		},
-		get snapshot() {
-			return l.snapshot;
+		get state() {
+			return l.state;
 		},
 		subscribe: l.subscribe,
 		[Symbol.dispose]() {
-			f.dispose();
+			p.dispose();
 		}
 	};
-	return n.autoStart !== !1 && d().catch(() => /* @__PURE__ */ e("Initial load failed. Inspect source.snapshot.error.")), f;
+	return p;
 }
 //#endregion
-export { s as createInfiniteSource };
+export { a as createInfiniteSource };
 
 //# sourceMappingURL=infiniteSource.js.map

package/dist/infiniteSource.js.map

@@ -1 +1 @@
-{"version":3,"file":"infiniteSource.js","names":[],"sources":["../src/infiniteSource.ts"],"sourcesContent":["import { warn } from './_dev';\nimport { createAsyncSource } from './asyncSource';\nimport { positiveInteger, sameQuery, totalItems } from './pagination';\nimport type {\n  InfinitePagination,\n  InfiniteQuery,\n  InfiniteQueryPatch,\n  InfiniteSource,\n  InfiniteSourceConfig,\n} from './types';\n\nconst createPagination = (loaded: number, total: number): InfinitePagination => ({\n  hasMore: loaded < total,\n  kind: 'infinite',\n  loaded,\n  total,\n});\n\nconst normalizeQuery = (current: InfiniteQuery, patch: InfiniteQueryPatch = {}): InfiniteQuery => ({\n  pageSize: positiveInteger(patch.pageSize ?? current.pageSize, 'pageSize'),\n  search: patch.search ?? current.search,\n});\n\n/** Infinite sources preserve loaded collection state while a pending query replaces it. */\nexport function createInfiniteSource<T>(config: InfiniteSourceConfig<T>): InfiniteSource<T> {\n  const initialQuery: InfiniteQuery = { pageSize: 20, search: '' };\n  let requestedQuery = normalizeQuery(initialQuery, config.initialQuery);\n  let nextPage = 1;\n  const asyncSource = createAsyncSource<T, InfiniteQuery, InfinitePagination>({\n    data: [],\n    error: null,\n    isFetching: false,\n    pagination: createPagination(0, 0),\n    query: requestedQuery,\n  });\n\n  const fetch = (query: InfiniteQuery, page: number, append: boolean): Promise<void> => {\n    const loadedData = asyncSource.snapshot.data;\n\n    return asyncSource.fetch({\n      load: (signal) => config.load({ query: { page, pageSize: query.pageSize, search: query.search }, signal }),\n      pending: (previous) => ({\n        ...previous,\n        error: null,\n        isFetching: true,\n        pagination: createPagination(previous.data.length, previous.pagination.total),\n        ...(append ? {} : { pendingQuery: query }),\n      }),\n      query,\n      success: (result) => {\n        const total = totalItems(result.total);\n        const data = append ? [...loadedData, ...result.data] : result.data;\n\n        nextPage = page + 1;\n\n        return {\n          data,\n          error: null,\n          isFetching: false,\n          pagination: createPagination(data.length, total),\n          query,\n        };\n      },\n    });\n  };\n\n  const reload = (): Promise<void> => {\n    nextPage = 1;\n\n    return fetch(requestedQuery, 1, false);\n  };\n\n  const setQuery = async (patch: InfiniteQueryPatch): Promise<void> => {\n    const current = asyncSource.snapshot.pendingQuery ?? asyncSource.snapshot.query;\n    const next = normalizeQuery(current, patch);\n\n    if (sameQuery(next, requestedQuery)) return;\n\n    requestedQuery = next;\n    nextPage = 1;\n    await fetch(next, 1, false);\n  };\n\n  const source: InfiniteSource<T> = {\n    get disposalSignal() {\n      return asyncSource.disposalSignal;\n    },\n\n    dispose: asyncSource.dispose,\n\n    get disposed() {\n      return asyncSource.disposed;\n    },\n\n    loadMore() {\n      const { isFetching, pagination } = asyncSource.snapshot;\n\n      return isFetching || (asyncSource.snapshot.data.length > 0 && !pagination.hasMore)\n        ? Promise.resolve()\n        : fetch(requestedQuery, nextPage, true);\n    },\n\n    reload,\n    setQuery,\n\n    get snapshot() {\n      return asyncSource.snapshot;\n    },\n\n    subscribe: asyncSource.subscribe,\n\n    [Symbol.dispose]() {\n      source.dispose();\n    },\n  };\n\n  if (config.autoStart !== false)\n    void reload().catch(() => warn('Initial load failed. Inspect source.snapshot.error.'));\n\n  return source;\n}\n"],"mappings":";;;;AAWA,IAAM,KAAoB,GAAgB,OAAuC;CAC/E,SAAS,IAAS;CAClB,MAAM;CACN;CACA;AACF,IAEM,KAAkB,GAAwB,IAA4B,CAAC,OAAsB;CACjG,UAAU,EAAgB,EAAM,YAAY,EAAQ,UAAU,UAAU;CACxE,QAAQ,EAAM,UAAU,EAAQ;AAClC;AAGA,SAAgB,EAAwB,GAAoD;CAE1F,IAAI,IAAiB,EAAe;EADE,UAAU;EAAI,QAAQ;CACxB,GAAc,EAAO,YAAY,GACjE,IAAW,GACT,IAAc,EAAwD;EAC1E,MAAM,CAAC;EACP,OAAO;EACP,YAAY;EACZ,YAAY,EAAiB,GAAG,CAAC;EACjC,OAAO;CACT,CAAC,GAEK,KAAS,GAAsB,GAAc,MAAmC;EACpF,IAAM,IAAa,EAAY,SAAS;EAExC,OAAO,EAAY,MAAM;GACvB,OAAO,MAAW,EAAO,KAAK;IAAE,OAAO;KAAE;KAAM,UAAU,EAAM;KAAU,QAAQ,EAAM;IAAO;IAAG;GAAO,CAAC;GACzG,UAAU,OAAc;IACtB,GAAG;IACH,OAAO;IACP,YAAY;IACZ,YAAY,EAAiB,EAAS,KAAK,QAAQ,EAAS,WAAW,KAAK;IAC5E,GAAI,IAAS,CAAC,IAAI,EAAE,cAAc,EAAM;GAC1C;GACA;GACA,UAAU,MAAW;IACnB,IAAM,IAAQ,EAAW,EAAO,KAAK,GAC/B,IAAO,IAAS,CAAC,GAAG,GAAY,GAAG,EAAO,IAAI,IAAI,EAAO;IAI/D,OAFA,IAAW,IAAO,GAEX;KACL;KACA,OAAO;KACP,YAAY;KACZ,YAAY,EAAiB,EAAK,QAAQ,CAAK;KAC/C;IACF;GACF;EACF,CAAC;CACH,GAEM,WACJ,IAAW,GAEJ,EAAM,GAAgB,GAAG,EAAK,IAcjC,IAA4B;EAChC,IAAI,iBAAiB;GACnB,OAAO,EAAY;EACrB;EAEA,SAAS,EAAY;EAErB,IAAI,WAAW;GACb,OAAO,EAAY;EACrB;EAEA,WAAW;GACT,IAAM,EAAE,eAAY,kBAAe,EAAY;GAE/C,OAAO,KAAe,EAAY,SAAS,KAAK,SAAS,KAAK,CAAC,EAAW,UACtE,QAAQ,QAAQ,IAChB,EAAM,GAAgB,GAAU,EAAI;EAC1C;EAEA;EACA,iBA/BsB,MAA6C;GAEnE,IAAM,IAAO,EADG,EAAY,SAAS,gBAAgB,EAAY,SAAS,OACrC,CAAK;GAEtC,EAAU,GAAM,CAAc,MAElC,IAAiB,GACjB,IAAW,GACX,MAAM,EAAM,GAAM,GAAG,EAAK;EAC5B;EAwBE,IAAI,WAAW;GACb,OAAO,EAAY;EACrB;EAEA,WAAW,EAAY;EAEvB,CAAC,OAAO,WAAW;GACjB,EAAO,QAAQ;EACjB;CACF;CAKA,OAHI,EAAO,cAAc,MACvB,EAAY,CAAC,CAAC,YAAY,kBAAK,qDAAqD,CAAC,GAEhF;AACT"}
+{"version":3,"file":"infiniteSource.js","names":[],"sources":["../src/infiniteSource.ts"],"sourcesContent":["import { createAsyncSource } from './asyncSource';\nimport { SourcererDisposedError } from './errors';\nimport { positiveInteger, totalItems } from './pagination';\nimport type { InfinitePagination, InfiniteSource, InfiniteSourceConfig, InfiniteSourceState } from './types';\n\ntype Request<TParams> = Readonly<{ pageSize: number; params: TParams }>;\n\nconst createPagination = (loadedItems: number, pageSize: number, total: number): InfinitePagination => ({\n  hasMore: loadedItems < total,\n  loadedItems,\n  pageSize,\n  totalItems: total,\n});\n\n/** Infinite sources retain committed items while replacement work is pending. */\nexport function createInfiniteSource<T, TParams = undefined>(\n  config: InfiniteSourceConfig<T, TParams>,\n): InfiniteSource<T, TParams> {\n  let requested: Request<TParams> = {\n    pageSize: positiveInteger(config.pageSize ?? 20, 'pageSize'),\n    params: config.params as TParams,\n  };\n  let nextPage = 1;\n  let hasLoaded = false;\n  const asyncSource = createAsyncSource<InfiniteSourceState<T, TParams>>({\n    error: null,\n    items: [],\n    loading: false,\n    pagination: createPagination(0, requested.pageSize, 0),\n    params: requested.params,\n  });\n  const assertLive = (): void => {\n    if (asyncSource.disposed) throw new SourcererDisposedError();\n  };\n\n  const fetch = (request: Request<TParams>, page: number, append: boolean): Promise<void> => {\n    const loadedItems = asyncSource.state.items;\n\n    return asyncSource.fetch({\n      commit: () => {\n        hasLoaded = true;\n        nextPage = page + 1;\n        requested = request;\n      },\n      failure: (previous, error) => ({ ...previous, error, loading: false, pendingParams: undefined }),\n      load: (signal) => config.load({ page, pageSize: request.pageSize, params: request.params, signal }),\n      pending: (previous) => ({\n        ...previous,\n        error: null,\n        loading: true,\n        ...(append || Object.is(request.params, previous.params) ? {} : { pendingParams: request.params }),\n      }),\n      success: (result) => {\n        const items = append ? [...loadedItems, ...result.items] : [...result.items];\n        return {\n          error: null,\n          items,\n          loading: false,\n          pagination: createPagination(items.length, request.pageSize, totalItems(result.totalItems)),\n          params: request.params,\n        };\n      },\n    });\n  };\n\n  const reload = (): Promise<void> => fetch(requested, 1, false);\n\n  const source: InfiniteSource<T, TParams> = {\n    get disposalSignal() {\n      return asyncSource.disposalSignal;\n    },\n\n    dispose: asyncSource.dispose,\n\n    get disposed() {\n      return asyncSource.disposed;\n    },\n\n    async loadMore() {\n      assertLive();\n      if (asyncSource.state.loading) return;\n      if (!hasLoaded || !Object.is(requested.params, asyncSource.state.params)) {\n        await reload();\n        return;\n      }\n      if (asyncSource.state.pagination.hasMore) await fetch(requested, nextPage, true);\n    },\n\n    reload,\n\n    async setPageSize(pageSize) {\n      assertLive();\n      const normalized = positiveInteger(pageSize, 'pageSize');\n      if (normalized === requested.pageSize) {\n        if (asyncSource.state.loading || asyncSource.state.pagination.pageSize === normalized) return;\n        await reload();\n        return;\n      }\n      requested = { ...requested, pageSize: normalized };\n      nextPage = 1;\n      await reload();\n    },\n\n    async setParams(params) {\n      assertLive();\n      if (Object.is(params, requested.params)) {\n        if (!asyncSource.state.loading && !Object.is(params, asyncSource.state.params)) await reload();\n        return;\n      }\n      requested = { ...requested, params };\n      nextPage = 1;\n      await reload();\n    },\n\n    get state() {\n      return asyncSource.state;\n    },\n\n    subscribe: asyncSource.subscribe,\n\n    [Symbol.dispose]() {\n      source.dispose();\n    },\n  };\n\n  return source;\n}\n"],"mappings":";;;;AAOA,IAAM,KAAoB,GAAqB,GAAkB,OAAuC;CACtG,SAAS,IAAc;CACvB;CACA;CACA,YAAY;AACd;AAGA,SAAgB,EACd,GAC4B;CAC5B,IAAI,IAA8B;EAChC,UAAU,EAAgB,EAAO,YAAY,IAAI,UAAU;EAC3D,QAAQ,EAAO;CACjB,GACI,IAAW,GACX,IAAY,IACV,IAAc,EAAmD;EACrE,OAAO;EACP,OAAO,CAAC;EACR,SAAS;EACT,YAAY,EAAiB,GAAG,EAAU,UAAU,CAAC;EACrD,QAAQ,EAAU;CACpB,CAAC,GACK,UAAyB;EAC7B,IAAI,EAAY,UAAU,MAAM,IAAI,EAAuB;CAC7D,GAEM,KAAS,GAA2B,GAAc,MAAmC;EACzF,IAAM,IAAc,EAAY,MAAM;EAEtC,OAAO,EAAY,MAAM;GACvB,cAAc;IAGZ,AAFA,IAAY,IACZ,IAAW,IAAO,GAClB,IAAY;GACd;GACA,UAAU,GAAU,OAAW;IAAE,GAAG;IAAU;IAAO,SAAS;IAAO,eAAe,KAAA;GAAU;GAC9F,OAAO,MAAW,EAAO,KAAK;IAAE;IAAM,UAAU,EAAQ;IAAU,QAAQ,EAAQ;IAAQ;GAAO,CAAC;GAClG,UAAU,OAAc;IACtB,GAAG;IACH,OAAO;IACP,SAAS;IACT,GAAI,KAAU,OAAO,GAAG,EAAQ,QAAQ,EAAS,MAAM,IAAI,CAAC,IAAI,EAAE,eAAe,EAAQ,OAAO;GAClG;GACA,UAAU,MAAW;IACnB,IAAM,IAAQ,IAAS,CAAC,GAAG,GAAa,GAAG,EAAO,KAAK,IAAI,CAAC,GAAG,EAAO,KAAK;IAC3E,OAAO;KACL,OAAO;KACP;KACA,SAAS;KACT,YAAY,EAAiB,EAAM,QAAQ,EAAQ,UAAU,EAAW,EAAO,UAAU,CAAC;KAC1F,QAAQ,EAAQ;IAClB;GACF;EACF,CAAC;CACH,GAEM,UAA8B,EAAM,GAAW,GAAG,EAAK,GAEvD,IAAqC;EACzC,IAAI,iBAAiB;GACnB,OAAO,EAAY;EACrB;EAEA,SAAS,EAAY;EAErB,IAAI,WAAW;GACb,OAAO,EAAY;EACrB;EAEA,MAAM,WAAW;GACf,MAAW,GACP,GAAY,MAAM,SACtB;QAAI,CAAC,KAAa,CAAC,OAAO,GAAG,EAAU,QAAQ,EAAY,MAAM,MAAM,GAAG;KACxE,MAAM,EAAO;KACb;IACF;IACA,AAAI,EAAY,MAAM,WAAW,WAAS,MAAM,EAAM,GAAW,GAAU,EAAI;GAD/E;EAEF;EAEA;EAEA,MAAM,YAAY,GAAU;GAC1B,EAAW;GACX,IAAM,IAAa,EAAgB,GAAU,UAAU;GACvD,IAAI,MAAe,EAAU,UAAU;IACrC,IAAI,EAAY,MAAM,WAAW,EAAY,MAAM,WAAW,aAAa,GAAY;IACvF,MAAM,EAAO;IACb;GACF;GAGA,AAFA,IAAY;IAAE,GAAG;IAAW,UAAU;GAAW,GACjD,IAAW,GACX,MAAM,EAAO;EACf;EAEA,MAAM,UAAU,GAAQ;GAEtB,IADA,EAAW,GACP,OAAO,GAAG,GAAQ,EAAU,MAAM,GAAG;IACvC,AAAI,CAAC,EAAY,MAAM,WAAW,CAAC,OAAO,GAAG,GAAQ,EAAY,MAAM,MAAM,KAAG,MAAM,EAAO;IAC7F;GACF;GAGA,AAFA,IAAY;IAAE,GAAG;IAAW;GAAO,GACnC,IAAW,GACX,MAAM,EAAO;EACf;EAEA,IAAI,QAAQ;GACV,OAAO,EAAY;EACrB;EAEA,WAAW,EAAY;EAEvB,CAAC,OAAO,WAAW;GACjB,EAAO,QAAQ;EACjB;CACF;CAEA,OAAO;AACT"}

package/dist/localSource.cjs

@@ -1,2 +1,2 @@
-const e=require("./sourceStore.cjs"),t=require("./pagination.cjs");var n=(e,n={},r)=>{let i=n.page??e.page,a=n.pageSize??e.pageSize,o=n.search??e.search,s=n.pageSize!==void 0||n.search!==void 0,c=n.page??(s?1:i);return{page:r===void 0?t.positiveInteger(c,`page`):Math.min(t.positiveInteger(c,`page`),r),pageSize:t.positiveInteger(a,`pageSize`),search:o}};function r(r,i={}){let a=r,o=n({page:1,pageSize:20,search:``},i.initialQuery),s=()=>{let e=o.search.length>0&&i.match?a.filter(e=>i.match?.(e,o.search)):a,n=t.totalItems(e.length),r=t.createPagePagination(o.page,o.pageSize,n),s=(r.index-1)*r.size;return o={...o,page:r.index},{data:e.slice(s,s+r.size),error:null,isFetching:!1,pagination:r,query:o}},c=e.createSourceStore(s()),l=()=>{let e=s();return t.sameQuery(e.query,c.value.query)&&e.data===c.value.data&&e.pagination===c.value.pagination?!1:(c.set(e),!0)},u=e=>{let r=n(o,e,c.value.pagination.count);t.sameQuery(r,o)||(o=r,l())},d={get disposalSignal(){return c.disposalSignal},dispose:c.dispose,get disposed(){return c.disposed},page:{go(e){u({page:e})},last(){u({page:c.value.pagination.count})},next(){c.value.pagination.hasNext&&u({page:c.value.pagination.index+1})},previous(){c.value.pagination.hasPrevious&&u({page:c.value.pagination.index-1})}},setData(e){e!==a&&(a=e,l())},setQuery:u,get snapshot(){return c.value},subscribe:c.subscribe,[Symbol.dispose](){d.dispose()}};return d}exports.createLocalSource=r;
+const e=require("./errors.cjs"),t=require("./sourceStore.cjs"),n=require("./pagination.cjs");function r(r,i={}){let a=r,o=1,s=n.positiveInteger(i.pageSize??20,`pageSize`),c=i.params,l=()=>{let e=i.filter?a.filter(e=>i.filter?.(e,c)):a,t=n.createPagePagination(o,s,e.length);if(o>t.pageCount)return o=t.pageCount,l();let r=(o-1)*s;return{error:null,items:e.slice(r,r+s),loading:!1,pagination:t,params:c}},u=t.createSourceStore(l()),d=()=>{if(u.disposed)throw new e.SourcererDisposedError},f=(e,t)=>Object.keys(e).every(n=>e[n]===t[n]),p=()=>{let e=l(),t=u.value,n=e.items.length===t.items.length&&e.items.every((e,n)=>Object.is(e,t.items[n]));Object.is(e.params,t.params)&&n&&f(e.pagination,t.pagination)||u.set(e)},m=e=>{d();let t=Math.min(n.positiveInteger(e,`page`),u.value.pagination.pageCount);t!==o&&(o=t,p())},h={get disposalSignal(){return u.disposalSignal},dispose:u.dispose,get disposed(){return u.disposed},first(){m(1)},goTo:m,last(){m(u.value.pagination.pageCount)},next(){u.value.pagination.hasNext?m(o+1):d()},previous(){u.value.pagination.hasPrevious?m(o-1):d()},setItems(e){d(),e!==a&&(a=e,p())},setPageSize(e){d();let t=n.positiveInteger(e,`pageSize`);t!==s&&(o=1,s=t,p())},setParams(e){d(),!Object.is(e,c)&&(o=1,c=e,p())},get state(){return u.value},subscribe:u.subscribe,[Symbol.dispose](){h.dispose()}};return h}exports.createLocalSource=r;
 //# sourceMappingURL=localSource.cjs.map

package/dist/localSource.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"localSource.cjs","names":[],"sources":["../src/localSource.ts"],"sourcesContent":["import { createPagePagination, positiveInteger, sameQuery, totalItems } from './pagination';\nimport { createSourceStore } from './sourceStore';\nimport type {\n  LocalQuery,\n  LocalQueryPatch,\n  LocalSource,\n  LocalSourceConfig,\n  PagePagination,\n  SourceSnapshot,\n} from './types';\n\nconst normalizeQuery = (current: LocalQuery, patch: LocalQueryPatch = {}, maxPage?: number): LocalQuery => {\n  const page = patch.page ?? current.page;\n  const pageSize = patch.pageSize ?? current.pageSize;\n  const search = patch.search ?? current.search;\n  const resetsPage = patch.pageSize !== undefined || patch.search !== undefined;\n\n  const requestedPage = patch.page ?? (resetsPage ? 1 : page);\n\n  return {\n    page:\n      maxPage === undefined\n        ? positiveInteger(requestedPage, 'page')\n        : Math.min(positiveInteger(requestedPage, 'page'), maxPage),\n    pageSize: positiveInteger(pageSize, 'pageSize'),\n    search,\n  };\n};\n\n/** Local sources own only search and pagination; callers prepare filtering and ranking. */\nexport function createLocalSource<T>(data: readonly T[], config: LocalSourceConfig<T> = {}): LocalSource<T> {\n  let allData = data;\n  let query = normalizeQuery({ page: 1, pageSize: 20, search: '' }, config.initialQuery);\n\n  const buildSnapshot = (): SourceSnapshot<T, LocalQuery, PagePagination> => {\n    const matched =\n      query.search.length > 0 && config.match ? allData.filter((item) => config.match?.(item, query.search)) : allData;\n    const total = totalItems(matched.length);\n    const pagination = createPagePagination(query.page, query.pageSize, total);\n    const start = (pagination.index - 1) * pagination.size;\n\n    query = { ...query, page: pagination.index };\n\n    return {\n      data: matched.slice(start, start + pagination.size),\n      error: null,\n      isFetching: false,\n      pagination,\n      query,\n    };\n  };\n\n  const store = createSourceStore(buildSnapshot());\n\n  const commit = (): boolean => {\n    const next = buildSnapshot();\n\n    if (\n      sameQuery(next.query, store.value.query) &&\n      next.data === store.value.data &&\n      next.pagination === store.value.pagination\n    ) {\n      return false;\n    }\n\n    store.set(next);\n\n    return true;\n  };\n\n  const setQuery = (patch: LocalQueryPatch): void => {\n    const next = normalizeQuery(query, patch, store.value.pagination.count);\n\n    if (sameQuery(next, query)) return;\n\n    query = next;\n\n    commit();\n  };\n\n  const source: LocalSource<T> = {\n    get disposalSignal() {\n      return store.disposalSignal;\n    },\n\n    dispose: store.dispose,\n\n    get disposed() {\n      return store.disposed;\n    },\n\n    page: {\n      go(index) {\n        setQuery({ page: index });\n      },\n\n      last() {\n        setQuery({ page: store.value.pagination.count });\n      },\n\n      next() {\n        if (store.value.pagination.hasNext) setQuery({ page: store.value.pagination.index + 1 });\n      },\n\n      previous() {\n        if (store.value.pagination.hasPrevious) setQuery({ page: store.value.pagination.index - 1 });\n      },\n    },\n\n    setData(nextData) {\n      if (nextData === allData) return;\n\n      allData = nextData;\n\n      commit();\n    },\n\n    setQuery,\n\n    get snapshot() {\n      return store.value;\n    },\n\n    subscribe: store.subscribe,\n\n    [Symbol.dispose]() {\n      source.dispose();\n    },\n  };\n\n  return source;\n}\n"],"mappings":"mEAWA,IAAM,GAAkB,EAAqB,EAAyB,CAAC,EAAG,IAAiC,CACzG,IAAM,EAAO,EAAM,MAAQ,EAAQ,KAC7B,EAAW,EAAM,UAAY,EAAQ,SACrC,EAAS,EAAM,QAAU,EAAQ,OACjC,EAAa,EAAM,WAAa,IAAA,IAAa,EAAM,SAAW,IAAA,GAE9D,EAAgB,EAAM,OAAS,EAAa,EAAI,GAEtD,MAAO,CACL,KACE,IAAY,IAAA,GACR,EAAA,gBAAgB,EAAe,MAAM,EACrC,KAAK,IAAI,EAAA,gBAAgB,EAAe,MAAM,EAAG,CAAO,EAC9D,SAAU,EAAA,gBAAgB,EAAU,UAAU,EAC9C,QACF,CACF,EAGA,SAAgB,EAAqB,EAAoB,EAA+B,CAAC,EAAmB,CAC1G,IAAI,EAAU,EACV,EAAQ,EAAe,CAAE,KAAM,EAAG,SAAU,GAAI,OAAQ,EAAG,EAAG,EAAO,YAAY,EAE/E,MAAqE,CACzE,IAAM,EACJ,EAAM,OAAO,OAAS,GAAK,EAAO,MAAQ,EAAQ,OAAQ,GAAS,EAAO,QAAQ,EAAM,EAAM,MAAM,CAAC,EAAI,EACrG,EAAQ,EAAA,WAAW,EAAQ,MAAM,EACjC,EAAa,EAAA,qBAAqB,EAAM,KAAM,EAAM,SAAU,CAAK,EACnE,GAAS,EAAW,MAAQ,GAAK,EAAW,KAIlD,MAFA,GAAQ,CAAE,GAAG,EAAO,KAAM,EAAW,KAAM,EAEpC,CACL,KAAM,EAAQ,MAAM,EAAO,EAAQ,EAAW,IAAI,EAClD,MAAO,KACP,WAAY,GACZ,aACA,OACF,CACF,EAEM,EAAQ,EAAA,kBAAkB,EAAc,CAAC,EAEzC,MAAwB,CAC5B,IAAM,EAAO,EAAc,EAY3B,OATE,EAAA,UAAU,EAAK,MAAO,EAAM,MAAM,KAAK,GACvC,EAAK,OAAS,EAAM,MAAM,MAC1B,EAAK,aAAe,EAAM,MAAM,WAEzB,IAGT,EAAM,IAAI,CAAI,EAEP,GACT,EAEM,EAAY,GAAiC,CACjD,IAAM,EAAO,EAAe,EAAO,EAAO,EAAM,MAAM,WAAW,KAAK,EAElE,EAAA,UAAU,EAAM,CAAK,IAEzB,EAAQ,EAER,EAAO,EACT,EAEM,EAAyB,CAC7B,IAAI,gBAAiB,CACnB,OAAO,EAAM,cACf,EAEA,QAAS,EAAM,QAEf,IAAI,UAAW,CACb,OAAO,EAAM,QACf,EAEA,KAAM,CACJ,GAAG,EAAO,CACR,EAAS,CAAE,KAAM,CAAM,CAAC,CAC1B,EAEA,MAAO,CACL,EAAS,CAAE,KAAM,EAAM,MAAM,WAAW,KAAM,CAAC,CACjD,EAEA,MAAO,CACD,EAAM,MAAM,WAAW,SAAS,EAAS,CAAE,KAAM,EAAM,MAAM,WAAW,MAAQ,CAAE,CAAC,CACzF,EAEA,UAAW,CACL,EAAM,MAAM,WAAW,aAAa,EAAS,CAAE,KAAM,EAAM,MAAM,WAAW,MAAQ,CAAE,CAAC,CAC7F,CACF,EAEA,QAAQ,EAAU,CACZ,IAAa,IAEjB,EAAU,EAEV,EAAO,EACT,EAEA,WAEA,IAAI,UAAW,CACb,OAAO,EAAM,KACf,EAEA,UAAW,EAAM,UAEjB,CAAC,OAAO,UAAW,CACjB,EAAO,QAAQ,CACjB,CACF,EAEA,OAAO,CACT"}
+{"version":3,"file":"localSource.cjs","names":[],"sources":["../src/localSource.ts"],"sourcesContent":["import { SourcererDisposedError } from './errors';\nimport { createPagePagination, positiveInteger } from './pagination';\nimport { createSourceStore } from './sourceStore';\nimport type { LocalSource, LocalSourceConfig, LocalSourceState, PagePagination } from './types';\n\n/** Local sources filter and paginate an in-memory collection synchronously. */\nexport function createLocalSource<T>(items: readonly T[]): LocalSource<T>;\nexport function createLocalSource<T, TParams = undefined>(\n  items: readonly T[],\n  config: LocalSourceConfig<T, TParams>,\n): LocalSource<T, TParams>;\nexport function createLocalSource<T, TParams = undefined>(\n  items: readonly T[],\n  config: LocalSourceConfig<T, TParams> = {} as LocalSourceConfig<T, TParams>,\n): LocalSource<T, TParams> {\n  let allItems = items;\n  let page = 1;\n  let pageSize = positiveInteger(config.pageSize ?? 20, 'pageSize');\n  let params = config.params as TParams;\n\n  const buildState = (): LocalSourceState<T, TParams> => {\n    const filtered = config.filter ? allItems.filter((item) => config.filter?.(item, params)) : allItems;\n    const pagination = createPagePagination(page, pageSize, filtered.length);\n    if (page > pagination.pageCount) {\n      page = pagination.pageCount;\n      return buildState();\n    }\n    const start = (page - 1) * pageSize;\n\n    return {\n      error: null,\n      items: filtered.slice(start, start + pageSize),\n      loading: false,\n      pagination,\n      params,\n    };\n  };\n\n  const store = createSourceStore(buildState());\n  const assertLive = (): void => {\n    if (store.disposed) throw new SourcererDisposedError();\n  };\n  const samePagination = (left: PagePagination, right: PagePagination): boolean =>\n    Object.keys(left).every((key) => left[key as keyof PagePagination] === right[key as keyof PagePagination]);\n  const commit = (): void => {\n    const next = buildState();\n    const current = store.value;\n    const sameItems =\n      next.items.length === current.items.length &&\n      next.items.every((item, index) => Object.is(item, current.items[index]));\n\n    if (Object.is(next.params, current.params) && sameItems && samePagination(next.pagination, current.pagination))\n      return;\n    store.set(next);\n  };\n  const goTo = (nextPage: number): void => {\n    assertLive();\n    const normalized = Math.min(positiveInteger(nextPage, 'page'), store.value.pagination.pageCount);\n    if (normalized === page) return;\n    page = normalized;\n    commit();\n  };\n\n  const source: LocalSource<T, TParams> = {\n    get disposalSignal() {\n      return store.disposalSignal;\n    },\n\n    dispose: store.dispose,\n\n    get disposed() {\n      return store.disposed;\n    },\n\n    first() {\n      goTo(1);\n    },\n\n    goTo,\n\n    last() {\n      goTo(store.value.pagination.pageCount);\n    },\n\n    next() {\n      if (store.value.pagination.hasNext) goTo(page + 1);\n      else assertLive();\n    },\n\n    previous() {\n      if (store.value.pagination.hasPrevious) goTo(page - 1);\n      else assertLive();\n    },\n\n    setItems(nextItems) {\n      assertLive();\n      if (nextItems === allItems) return;\n      allItems = nextItems;\n      commit();\n    },\n\n    setPageSize(nextPageSize) {\n      assertLive();\n      const normalized = positiveInteger(nextPageSize, 'pageSize');\n      if (normalized === pageSize) return;\n      page = 1;\n      pageSize = normalized;\n      commit();\n    },\n\n    setParams(nextParams) {\n      assertLive();\n      if (Object.is(nextParams, params)) return;\n      page = 1;\n      params = nextParams;\n      commit();\n    },\n\n    get state() {\n      return store.value;\n    },\n\n    subscribe: store.subscribe,\n\n    [Symbol.dispose]() {\n      source.dispose();\n    },\n  };\n\n  return source;\n}\n"],"mappings":"6FAWA,SAAgB,EACd,EACA,EAAwC,CAAC,EAChB,CACzB,IAAI,EAAW,EACX,EAAO,EACP,EAAW,EAAA,gBAAgB,EAAO,UAAY,GAAI,UAAU,EAC5D,EAAS,EAAO,OAEd,MAAiD,CACrD,IAAM,EAAW,EAAO,OAAS,EAAS,OAAQ,GAAS,EAAO,SAAS,EAAM,CAAM,CAAC,EAAI,EACtF,EAAa,EAAA,qBAAqB,EAAM,EAAU,EAAS,MAAM,EACvE,GAAI,EAAO,EAAW,UAEpB,MADA,GAAO,EAAW,UACX,EAAW,EAEpB,IAAM,GAAS,EAAO,GAAK,EAE3B,MAAO,CACL,MAAO,KACP,MAAO,EAAS,MAAM,EAAO,EAAQ,CAAQ,EAC7C,QAAS,GACT,aACA,QACF,CACF,EAEM,EAAQ,EAAA,kBAAkB,EAAW,CAAC,EACtC,MAAyB,CAC7B,GAAI,EAAM,SAAU,MAAM,IAAI,EAAA,sBAChC,EACM,GAAkB,EAAsB,IAC5C,OAAO,KAAK,CAAI,CAAC,CAAC,MAAO,GAAQ,EAAK,KAAiC,EAAM,EAA4B,EACrG,MAAqB,CACzB,IAAM,EAAO,EAAW,EAClB,EAAU,EAAM,MAChB,EACJ,EAAK,MAAM,SAAW,EAAQ,MAAM,QACpC,EAAK,MAAM,OAAO,EAAM,IAAU,OAAO,GAAG,EAAM,EAAQ,MAAM,EAAM,CAAC,EAErE,OAAO,GAAG,EAAK,OAAQ,EAAQ,MAAM,GAAK,GAAa,EAAe,EAAK,WAAY,EAAQ,UAAU,GAE7G,EAAM,IAAI,CAAI,CAChB,EACM,EAAQ,GAA2B,CACvC,EAAW,EACX,IAAM,EAAa,KAAK,IAAI,EAAA,gBAAgB,EAAU,MAAM,EAAG,EAAM,MAAM,WAAW,SAAS,EAC3F,IAAe,IACnB,EAAO,EACP,EAAO,EACT,EAEM,EAAkC,CACtC,IAAI,gBAAiB,CACnB,OAAO,EAAM,cACf,EAEA,QAAS,EAAM,QAEf,IAAI,UAAW,CACb,OAAO,EAAM,QACf,EAEA,OAAQ,CACN,EAAK,CAAC,CACR,EAEA,OAEA,MAAO,CACL,EAAK,EAAM,MAAM,WAAW,SAAS,CACvC,EAEA,MAAO,CACD,EAAM,MAAM,WAAW,QAAS,EAAK,EAAO,CAAC,EAC5C,EAAW,CAClB,EAEA,UAAW,CACL,EAAM,MAAM,WAAW,YAAa,EAAK,EAAO,CAAC,EAChD,EAAW,CAClB,EAEA,SAAS,EAAW,CAClB,EAAW,EACP,IAAc,IAClB,EAAW,EACX,EAAO,EACT,EAEA,YAAY,EAAc,CACxB,EAAW,EACX,IAAM,EAAa,EAAA,gBAAgB,EAAc,UAAU,EACvD,IAAe,IACnB,EAAO,EACP,EAAW,EACX,EAAO,EACT,EAEA,UAAU,EAAY,CACpB,EAAW,EACP,QAAO,GAAG,EAAY,CAAM,IAChC,EAAO,EACP,EAAS,EACT,EAAO,EACT,EAEA,IAAI,OAAQ,CACV,OAAO,EAAM,KACf,EAEA,UAAW,EAAM,UAEjB,CAAC,OAAO,UAAW,CACjB,EAAO,QAAQ,CACjB,CACF,EAEA,OAAO,CACT"}

package/dist/localSource.d.ts

@@ -1,4 +1,5 @@
 import type { LocalSource, LocalSourceConfig } from './types';
-/** Local sources own only search and pagination; callers prepare filtering and ranking. */
-export declare function createLocalSource<T>(data: readonly T[], config?: LocalSourceConfig<T>): LocalSource<T>;
+/** Local sources filter and paginate an in-memory collection synchronously. */
+export declare function createLocalSource<T>(items: readonly T[]): LocalSource<T>;
+export declare function createLocalSource<T, TParams = undefined>(items: readonly T[], config: LocalSourceConfig<T, TParams>): LocalSource<T, TParams>;
 //# sourceMappingURL=localSource.d.ts.map

package/dist/localSource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"localSource.d.ts","sourceRoot":"","sources":["../src/localSource.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,WAAW,EACX,iBAAiB,EAGlB,MAAM,SAAS,CAAC;AAoBjB,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,MAAM,GAAE,iBAAiB,CAAC,CAAC,CAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAqG1G"}
+{"version":3,"file":"localSource.d.ts","sourceRoot":"","sources":["../src/localSource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAoC,MAAM,SAAS,CAAC;AAEhG,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;AAC1E,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,GAAG,SAAS,EACtD,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,MAAM,EAAE,iBAAiB,CAAC,CAAC,EAAE,OAAO,CAAC,GACpC,WAAW,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC"}

package/dist/localSource.js

@@ -1,74 +1,71 @@
-import { createSourceStore as e } from "./sourceStore.js";
-import { createPagePagination as t, positiveInteger as n, sameQuery as r, totalItems as i } from "./pagination.js";
+import { SourcererDisposedError as e } from "./errors.js";
+import { createSourceStore as t } from "./sourceStore.js";
+import { createPagePagination as n, positiveInteger as r } from "./pagination.js";
 //#region src/localSource.ts
-var a = (e, t = {}, r) => {
-	let i = t.page ?? e.page, a = t.pageSize ?? e.pageSize, o = t.search ?? e.search, s = t.pageSize !== void 0 || t.search !== void 0, c = t.page ?? (s ? 1 : i);
-	return {
-		page: r === void 0 ? n(c, "page") : Math.min(n(c, "page"), r),
-		pageSize: n(a, "pageSize"),
-		search: o
-	};
-};
-function o(n, o = {}) {
-	let s = n, c = a({
-		page: 1,
-		pageSize: 20,
-		search: ""
-	}, o.initialQuery), l = () => {
-		let e = c.search.length > 0 && o.match ? s.filter((e) => o.match?.(e, c.search)) : s, n = i(e.length), r = t(c.page, c.pageSize, n), a = (r.index - 1) * r.size;
-		return c = {
-			...c,
-			page: r.index
-		}, {
-			data: e.slice(a, a + r.size),
+function i(i, a = {}) {
+	let o = i, s = 1, c = r(a.pageSize ?? 20, "pageSize"), l = a.params, u = () => {
+		let e = a.filter ? o.filter((e) => a.filter?.(e, l)) : o, t = n(s, c, e.length);
+		if (s > t.pageCount) return s = t.pageCount, u();
+		let r = (s - 1) * c;
+		return {
 			error: null,
-			isFetching: !1,
-			pagination: r,
-			query: c
+			items: e.slice(r, r + c),
+			loading: !1,
+			pagination: t,
+			params: l
 		};
-	}, u = e(l()), d = () => {
-		let e = l();
-		return r(e.query, u.value.query) && e.data === u.value.data && e.pagination === u.value.pagination ? !1 : (u.set(e), !0);
-	}, f = (e) => {
-		let t = a(c, e, u.value.pagination.count);
-		r(t, c) || (c = t, d());
-	}, p = {
+	}, d = t(u()), f = () => {
+		if (d.disposed) throw new e();
+	}, p = (e, t) => Object.keys(e).every((n) => e[n] === t[n]), m = () => {
+		let e = u(), t = d.value, n = e.items.length === t.items.length && e.items.every((e, n) => Object.is(e, t.items[n]));
+		Object.is(e.params, t.params) && n && p(e.pagination, t.pagination) || d.set(e);
+	}, h = (e) => {
+		f();
+		let t = Math.min(r(e, "page"), d.value.pagination.pageCount);
+		t !== s && (s = t, m());
+	}, g = {
 		get disposalSignal() {
-			return u.disposalSignal;
+			return d.disposalSignal;
 		},
-		dispose: u.dispose,
+		dispose: d.dispose,
 		get disposed() {
-			return u.disposed;
+			return d.disposed;
+		},
+		first() {
+			h(1);
+		},
+		goTo: h,
+		last() {
+			h(d.value.pagination.pageCount);
+		},
+		next() {
+			d.value.pagination.hasNext ? h(s + 1) : f();
+		},
+		previous() {
+			d.value.pagination.hasPrevious ? h(s - 1) : f();
+		},
+		setItems(e) {
+			f(), e !== o && (o = e, m());
 		},
-		page: {
-			go(e) {
-				f({ page: e });
-			},
-			last() {
-				f({ page: u.value.pagination.count });
-			},
-			next() {
-				u.value.pagination.hasNext && f({ page: u.value.pagination.index + 1 });
-			},
-			previous() {
-				u.value.pagination.hasPrevious && f({ page: u.value.pagination.index - 1 });
-			}
+		setPageSize(e) {
+			f();
+			let t = r(e, "pageSize");
+			t !== c && (s = 1, c = t, m());
 		},
-		setData(e) {
-			e !== s && (s = e, d());
+		setParams(e) {
+			f(), !Object.is(e, l) && (s = 1, l = e, m());
 		},
-		setQuery: f,
-		get snapshot() {
-			return u.value;
+		get state() {
+			return d.value;
 		},
-		subscribe: u.subscribe,
+		subscribe: d.subscribe,
 		[Symbol.dispose]() {
-			p.dispose();
+			g.dispose();
 		}
 	};
-	return p;
+	return g;
 }
 //#endregion
-export { o as createLocalSource };
+export { i as createLocalSource };
 
 //# sourceMappingURL=localSource.js.map

package/dist/localSource.js.map

@@ -1 +1 @@
-{"version":3,"file":"localSource.js","names":[],"sources":["../src/localSource.ts"],"sourcesContent":["import { createPagePagination, positiveInteger, sameQuery, totalItems } from './pagination';\nimport { createSourceStore } from './sourceStore';\nimport type {\n  LocalQuery,\n  LocalQueryPatch,\n  LocalSource,\n  LocalSourceConfig,\n  PagePagination,\n  SourceSnapshot,\n} from './types';\n\nconst normalizeQuery = (current: LocalQuery, patch: LocalQueryPatch = {}, maxPage?: number): LocalQuery => {\n  const page = patch.page ?? current.page;\n  const pageSize = patch.pageSize ?? current.pageSize;\n  const search = patch.search ?? current.search;\n  const resetsPage = patch.pageSize !== undefined || patch.search !== undefined;\n\n  const requestedPage = patch.page ?? (resetsPage ? 1 : page);\n\n  return {\n    page:\n      maxPage === undefined\n        ? positiveInteger(requestedPage, 'page')\n        : Math.min(positiveInteger(requestedPage, 'page'), maxPage),\n    pageSize: positiveInteger(pageSize, 'pageSize'),\n    search,\n  };\n};\n\n/** Local sources own only search and pagination; callers prepare filtering and ranking. */\nexport function createLocalSource<T>(data: readonly T[], config: LocalSourceConfig<T> = {}): LocalSource<T> {\n  let allData = data;\n  let query = normalizeQuery({ page: 1, pageSize: 20, search: '' }, config.initialQuery);\n\n  const buildSnapshot = (): SourceSnapshot<T, LocalQuery, PagePagination> => {\n    const matched =\n      query.search.length > 0 && config.match ? allData.filter((item) => config.match?.(item, query.search)) : allData;\n    const total = totalItems(matched.length);\n    const pagination = createPagePagination(query.page, query.pageSize, total);\n    const start = (pagination.index - 1) * pagination.size;\n\n    query = { ...query, page: pagination.index };\n\n    return {\n      data: matched.slice(start, start + pagination.size),\n      error: null,\n      isFetching: false,\n      pagination,\n      query,\n    };\n  };\n\n  const store = createSourceStore(buildSnapshot());\n\n  const commit = (): boolean => {\n    const next = buildSnapshot();\n\n    if (\n      sameQuery(next.query, store.value.query) &&\n      next.data === store.value.data &&\n      next.pagination === store.value.pagination\n    ) {\n      return false;\n    }\n\n    store.set(next);\n\n    return true;\n  };\n\n  const setQuery = (patch: LocalQueryPatch): void => {\n    const next = normalizeQuery(query, patch, store.value.pagination.count);\n\n    if (sameQuery(next, query)) return;\n\n    query = next;\n\n    commit();\n  };\n\n  const source: LocalSource<T> = {\n    get disposalSignal() {\n      return store.disposalSignal;\n    },\n\n    dispose: store.dispose,\n\n    get disposed() {\n      return store.disposed;\n    },\n\n    page: {\n      go(index) {\n        setQuery({ page: index });\n      },\n\n      last() {\n        setQuery({ page: store.value.pagination.count });\n      },\n\n      next() {\n        if (store.value.pagination.hasNext) setQuery({ page: store.value.pagination.index + 1 });\n      },\n\n      previous() {\n        if (store.value.pagination.hasPrevious) setQuery({ page: store.value.pagination.index - 1 });\n      },\n    },\n\n    setData(nextData) {\n      if (nextData === allData) return;\n\n      allData = nextData;\n\n      commit();\n    },\n\n    setQuery,\n\n    get snapshot() {\n      return store.value;\n    },\n\n    subscribe: store.subscribe,\n\n    [Symbol.dispose]() {\n      source.dispose();\n    },\n  };\n\n  return source;\n}\n"],"mappings":";;;AAWA,IAAM,KAAkB,GAAqB,IAAyB,CAAC,GAAG,MAAiC;CACzG,IAAM,IAAO,EAAM,QAAQ,EAAQ,MAC7B,IAAW,EAAM,YAAY,EAAQ,UACrC,IAAS,EAAM,UAAU,EAAQ,QACjC,IAAa,EAAM,aAAa,KAAA,KAAa,EAAM,WAAW,KAAA,GAE9D,IAAgB,EAAM,SAAS,IAAa,IAAI;CAEtD,OAAO;EACL,MACE,MAAY,KAAA,IACR,EAAgB,GAAe,MAAM,IACrC,KAAK,IAAI,EAAgB,GAAe,MAAM,GAAG,CAAO;EAC9D,UAAU,EAAgB,GAAU,UAAU;EAC9C;CACF;AACF;AAGA,SAAgB,EAAqB,GAAoB,IAA+B,CAAC,GAAmB;CAC1G,IAAI,IAAU,GACV,IAAQ,EAAe;EAAE,MAAM;EAAG,UAAU;EAAI,QAAQ;CAAG,GAAG,EAAO,YAAY,GAE/E,UAAqE;EACzE,IAAM,IACJ,EAAM,OAAO,SAAS,KAAK,EAAO,QAAQ,EAAQ,QAAQ,MAAS,EAAO,QAAQ,GAAM,EAAM,MAAM,CAAC,IAAI,GACrG,IAAQ,EAAW,EAAQ,MAAM,GACjC,IAAa,EAAqB,EAAM,MAAM,EAAM,UAAU,CAAK,GACnE,KAAS,EAAW,QAAQ,KAAK,EAAW;EAIlD,OAFA,IAAQ;GAAE,GAAG;GAAO,MAAM,EAAW;EAAM,GAEpC;GACL,MAAM,EAAQ,MAAM,GAAO,IAAQ,EAAW,IAAI;GAClD,OAAO;GACP,YAAY;GACZ;GACA;EACF;CACF,GAEM,IAAQ,EAAkB,EAAc,CAAC,GAEzC,UAAwB;EAC5B,IAAM,IAAO,EAAc;EAY3B,OATE,EAAU,EAAK,OAAO,EAAM,MAAM,KAAK,KACvC,EAAK,SAAS,EAAM,MAAM,QAC1B,EAAK,eAAe,EAAM,MAAM,aAEzB,MAGT,EAAM,IAAI,CAAI,GAEP;CACT,GAEM,KAAY,MAAiC;EACjD,IAAM,IAAO,EAAe,GAAO,GAAO,EAAM,MAAM,WAAW,KAAK;EAElE,EAAU,GAAM,CAAK,MAEzB,IAAQ,GAER,EAAO;CACT,GAEM,IAAyB;EAC7B,IAAI,iBAAiB;GACnB,OAAO,EAAM;EACf;EAEA,SAAS,EAAM;EAEf,IAAI,WAAW;GACb,OAAO,EAAM;EACf;EAEA,MAAM;GACJ,GAAG,GAAO;IACR,EAAS,EAAE,MAAM,EAAM,CAAC;GAC1B;GAEA,OAAO;IACL,EAAS,EAAE,MAAM,EAAM,MAAM,WAAW,MAAM,CAAC;GACjD;GAEA,OAAO;IACL,AAAI,EAAM,MAAM,WAAW,WAAS,EAAS,EAAE,MAAM,EAAM,MAAM,WAAW,QAAQ,EAAE,CAAC;GACzF;GAEA,WAAW;IACT,AAAI,EAAM,MAAM,WAAW,eAAa,EAAS,EAAE,MAAM,EAAM,MAAM,WAAW,QAAQ,EAAE,CAAC;GAC7F;EACF;EAEA,QAAQ,GAAU;GACZ,MAAa,MAEjB,IAAU,GAEV,EAAO;EACT;EAEA;EAEA,IAAI,WAAW;GACb,OAAO,EAAM;EACf;EAEA,WAAW,EAAM;EAEjB,CAAC,OAAO,WAAW;GACjB,EAAO,QAAQ;EACjB;CACF;CAEA,OAAO;AACT"}
+{"version":3,"file":"localSource.js","names":[],"sources":["../src/localSource.ts"],"sourcesContent":["import { SourcererDisposedError } from './errors';\nimport { createPagePagination, positiveInteger } from './pagination';\nimport { createSourceStore } from './sourceStore';\nimport type { LocalSource, LocalSourceConfig, LocalSourceState, PagePagination } from './types';\n\n/** Local sources filter and paginate an in-memory collection synchronously. */\nexport function createLocalSource<T>(items: readonly T[]): LocalSource<T>;\nexport function createLocalSource<T, TParams = undefined>(\n  items: readonly T[],\n  config: LocalSourceConfig<T, TParams>,\n): LocalSource<T, TParams>;\nexport function createLocalSource<T, TParams = undefined>(\n  items: readonly T[],\n  config: LocalSourceConfig<T, TParams> = {} as LocalSourceConfig<T, TParams>,\n): LocalSource<T, TParams> {\n  let allItems = items;\n  let page = 1;\n  let pageSize = positiveInteger(config.pageSize ?? 20, 'pageSize');\n  let params = config.params as TParams;\n\n  const buildState = (): LocalSourceState<T, TParams> => {\n    const filtered = config.filter ? allItems.filter((item) => config.filter?.(item, params)) : allItems;\n    const pagination = createPagePagination(page, pageSize, filtered.length);\n    if (page > pagination.pageCount) {\n      page = pagination.pageCount;\n      return buildState();\n    }\n    const start = (page - 1) * pageSize;\n\n    return {\n      error: null,\n      items: filtered.slice(start, start + pageSize),\n      loading: false,\n      pagination,\n      params,\n    };\n  };\n\n  const store = createSourceStore(buildState());\n  const assertLive = (): void => {\n    if (store.disposed) throw new SourcererDisposedError();\n  };\n  const samePagination = (left: PagePagination, right: PagePagination): boolean =>\n    Object.keys(left).every((key) => left[key as keyof PagePagination] === right[key as keyof PagePagination]);\n  const commit = (): void => {\n    const next = buildState();\n    const current = store.value;\n    const sameItems =\n      next.items.length === current.items.length &&\n      next.items.every((item, index) => Object.is(item, current.items[index]));\n\n    if (Object.is(next.params, current.params) && sameItems && samePagination(next.pagination, current.pagination))\n      return;\n    store.set(next);\n  };\n  const goTo = (nextPage: number): void => {\n    assertLive();\n    const normalized = Math.min(positiveInteger(nextPage, 'page'), store.value.pagination.pageCount);\n    if (normalized === page) return;\n    page = normalized;\n    commit();\n  };\n\n  const source: LocalSource<T, TParams> = {\n    get disposalSignal() {\n      return store.disposalSignal;\n    },\n\n    dispose: store.dispose,\n\n    get disposed() {\n      return store.disposed;\n    },\n\n    first() {\n      goTo(1);\n    },\n\n    goTo,\n\n    last() {\n      goTo(store.value.pagination.pageCount);\n    },\n\n    next() {\n      if (store.value.pagination.hasNext) goTo(page + 1);\n      else assertLive();\n    },\n\n    previous() {\n      if (store.value.pagination.hasPrevious) goTo(page - 1);\n      else assertLive();\n    },\n\n    setItems(nextItems) {\n      assertLive();\n      if (nextItems === allItems) return;\n      allItems = nextItems;\n      commit();\n    },\n\n    setPageSize(nextPageSize) {\n      assertLive();\n      const normalized = positiveInteger(nextPageSize, 'pageSize');\n      if (normalized === pageSize) return;\n      page = 1;\n      pageSize = normalized;\n      commit();\n    },\n\n    setParams(nextParams) {\n      assertLive();\n      if (Object.is(nextParams, params)) return;\n      page = 1;\n      params = nextParams;\n      commit();\n    },\n\n    get state() {\n      return store.value;\n    },\n\n    subscribe: store.subscribe,\n\n    [Symbol.dispose]() {\n      source.dispose();\n    },\n  };\n\n  return source;\n}\n"],"mappings":";;;;AAWA,SAAgB,EACd,GACA,IAAwC,CAAC,GAChB;CACzB,IAAI,IAAW,GACX,IAAO,GACP,IAAW,EAAgB,EAAO,YAAY,IAAI,UAAU,GAC5D,IAAS,EAAO,QAEd,UAAiD;EACrD,IAAM,IAAW,EAAO,SAAS,EAAS,QAAQ,MAAS,EAAO,SAAS,GAAM,CAAM,CAAC,IAAI,GACtF,IAAa,EAAqB,GAAM,GAAU,EAAS,MAAM;EACvE,IAAI,IAAO,EAAW,WAEpB,OADA,IAAO,EAAW,WACX,EAAW;EAEpB,IAAM,KAAS,IAAO,KAAK;EAE3B,OAAO;GACL,OAAO;GACP,OAAO,EAAS,MAAM,GAAO,IAAQ,CAAQ;GAC7C,SAAS;GACT;GACA;EACF;CACF,GAEM,IAAQ,EAAkB,EAAW,CAAC,GACtC,UAAyB;EAC7B,IAAI,EAAM,UAAU,MAAM,IAAI,EAAuB;CACvD,GACM,KAAkB,GAAsB,MAC5C,OAAO,KAAK,CAAI,CAAC,CAAC,OAAO,MAAQ,EAAK,OAAiC,EAAM,EAA4B,GACrG,UAAqB;EACzB,IAAM,IAAO,EAAW,GAClB,IAAU,EAAM,OAChB,IACJ,EAAK,MAAM,WAAW,EAAQ,MAAM,UACpC,EAAK,MAAM,OAAO,GAAM,MAAU,OAAO,GAAG,GAAM,EAAQ,MAAM,EAAM,CAAC;EAErE,OAAO,GAAG,EAAK,QAAQ,EAAQ,MAAM,KAAK,KAAa,EAAe,EAAK,YAAY,EAAQ,UAAU,KAE7G,EAAM,IAAI,CAAI;CAChB,GACM,KAAQ,MAA2B;EACvC,EAAW;EACX,IAAM,IAAa,KAAK,IAAI,EAAgB,GAAU,MAAM,GAAG,EAAM,MAAM,WAAW,SAAS;EAC3F,MAAe,MACnB,IAAO,GACP,EAAO;CACT,GAEM,IAAkC;EACtC,IAAI,iBAAiB;GACnB,OAAO,EAAM;EACf;EAEA,SAAS,EAAM;EAEf,IAAI,WAAW;GACb,OAAO,EAAM;EACf;EAEA,QAAQ;GACN,EAAK,CAAC;EACR;EAEA;EAEA,OAAO;GACL,EAAK,EAAM,MAAM,WAAW,SAAS;EACvC;EAEA,OAAO;GACL,AAAI,EAAM,MAAM,WAAW,UAAS,EAAK,IAAO,CAAC,IAC5C,EAAW;EAClB;EAEA,WAAW;GACT,AAAI,EAAM,MAAM,WAAW,cAAa,EAAK,IAAO,CAAC,IAChD,EAAW;EAClB;EAEA,SAAS,GAAW;GAClB,EAAW,GACP,MAAc,MAClB,IAAW,GACX,EAAO;EACT;EAEA,YAAY,GAAc;GACxB,EAAW;GACX,IAAM,IAAa,EAAgB,GAAc,UAAU;GACvD,MAAe,MACnB,IAAO,GACP,IAAW,GACX,EAAO;EACT;EAEA,UAAU,GAAY;GACpB,EAAW,GACP,QAAO,GAAG,GAAY,CAAM,MAChC,IAAO,GACP,IAAS,GACT,EAAO;EACT;EAEA,IAAI,QAAQ;GACV,OAAO,EAAM;EACf;EAEA,WAAW,EAAM;EAEjB,CAAC,OAAO,WAAW;GACjB,EAAO,QAAQ;EACjB;CACF;CAEA,OAAO;AACT"}