cross-state 0.55.3 → 0.55.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1 +1 @@
1
- {"version":3,"file":"index.cjs","names":["Cache","definition: PagedCacheDefinition<T, Args>","internalCreate","options","createPagedCache: typeof createPaged & { defaultOptions: CacheOptions<any, any> }","defaultCacheOptions"],"sources":["../src/core/pagedCache.ts","../src/lib/updateHelpers.ts"],"sourcesContent":["import {\n Cache,\n defaultCacheOptions,\n internalCreate,\n type CacheOptions,\n type CreateCacheResult,\n} from '@core/cache';\nimport type { CalculationActions } from '@core/commonTypes';\nimport { autobind } from '@lib/autobind';\n\nexport interface PageCacheFunctionProps<T> extends CalculationActions<Promise<PagedState<T>>> {\n /**\n * Previously fetched pages (in order).\n */\n pages: T[];\n /**\n * Last fetched page or null if there are no previously fetched pages.\n */\n prevPage: T | null;\n}\n\nexport interface PageCacheFunction<T> {\n (props: PageCacheFunctionProps<T>): Promise<T | null>;\n}\n\nexport interface PagedCacheDefinition<T, Args extends any[]> {\n /**\n * Function to fetch a page.\n * The function receives the current state of the cache, including previously fetched pages.\n */\n fetchPage: (this: PagedCache<T, Args>, props: PageCacheFunctionProps<T>) => Promise<T | null>;\n /**\n * Optional function to determine the total number of pages - usually based on data in the fetched pages.\n */\n getPageCount?: (this: PagedCache<T, Args>, pages: T[]) => number | null;\n /**\n * Optional function to determine if there are more pages to fetch - usually based on data in the fetched pages.\n * If not provided, it will be assumed there are more pages until getPageCount is provided and the number of fetched pages equals the page count or until fetchPage returns null.\n */\n hasMorePages?: (this: PagedCache<T, Args>, pages: T[]) => boolean;\n}\n\nexport interface PagedCacheDefinitionFunction<T, Args extends any[]> {\n (...args: Args): PagedCacheDefinition<T, Args>;\n}\n\nexport interface PagedState<T> {\n pages: T[];\n hasMore: boolean;\n pageCount: number | null;\n}\n\nexport interface FetchNextPageOptions {\n /**\n * If true, will throw if the cache is in an error state or if another page is being fetched.\n */\n throwOnError?: boolean;\n}\n\nexport class PagedCache<T, Args extends any[] = []> extends Cache<PagedState<T>, Args> {\n constructor(\n public readonly definition: PagedCacheDefinition<T, Args>,\n args: Args,\n options: CacheOptions<PagedState<T>, Args> = {},\n ) {\n super(async (helpers) => loadPage(this, helpers, []), args, options, undefined);\n autobind(PagedCache);\n }\n\n async fetchNextPage({ throwOnError }: FetchNextPageOptions = {}): Promise<void> {\n const { status, isStale, isUpdating, value } = this.state.get();\n\n if (status === 'error') {\n if (!throwOnError) return;\n throw new Error('Cannot fetch next page while cache is in error state');\n }\n\n if (isUpdating) {\n if (!throwOnError) return;\n throw new Error('Cannot fetch next page while another page is being fetched');\n }\n\n if (status === 'pending' || isStale) {\n await this.get().catch(() => {});\n return;\n }\n\n if (!value.hasMore) {\n if (!throwOnError) return;\n throw new Error('No more pages to fetch');\n }\n\n this.stalePromise = this.calculatedValue?.value;\n\n const ac = new AbortController();\n const promise = loadPage(\n this,\n {\n use() {\n throw new Error('Not implemented');\n },\n connect() {\n throw new Error('Not implemented');\n },\n signal: ac.signal,\n },\n value.pages,\n );\n\n this.updateValue(promise);\n\n try {\n await promise;\n } catch (error) {\n if (!throwOnError) return;\n throw error;\n }\n }\n}\n\nasync function loadPage<T, Args extends any[]>(\n cache: PagedCache<T, Args>,\n helpers: CalculationActions<Promise<PagedState<T>>>,\n oldPages: T[],\n) {\n const { fetchPage, hasMorePages, getPageCount } = cache.definition;\n\n const page = await fetchPage.call(cache, {\n ...helpers,\n pages: oldPages,\n prevPage: oldPages.length > 0 ? oldPages[oldPages.length - 1]! : null,\n });\n\n const pages = page === null ? oldPages : oldPages.concat(page);\n const pageCount = getPageCount?.call(cache, pages) ?? null;\n const hasMore = hasMorePages\n ? hasMorePages.call(cache, pages)\n : pageCount !== null\n ? pages.length < pageCount\n : page !== null;\n\n return { pages, hasMore, pageCount };\n}\n\nfunction createPaged<T, Args extends any[] = []>(\n definition: PagedCacheDefinitionFunction<T, Args>,\n options?: CacheOptions<PagedState<T>, Args>,\n): CreateCacheResult<PagedState<T>, Args, PagedCache<T, Args>>;\n\nfunction createPaged<T>(\n definition: PagedCacheDefinition<T, []>,\n options?: CacheOptions<PagedState<T>, []>,\n): CreateCacheResult<PagedState<T>, [], PagedCache<T, []>>;\n\nfunction createPaged<T, Args extends any[] = []>(\n definition: PagedCacheDefinitionFunction<T, Args> | PagedCacheDefinition<T, Args>,\n options?: CacheOptions<PagedState<T>, Args>,\n): CreateCacheResult<PagedState<T>, Args, PagedCache<T, Args>> {\n return internalCreate<PagedState<T>, Args, PagedCache<T, Args>>((args, options) => {\n let currentDefinition = definition;\n if (currentDefinition instanceof Function) {\n currentDefinition = currentDefinition(...args);\n }\n return new PagedCache(currentDefinition, args, options);\n }, options);\n}\n\nexport const createPagedCache: typeof createPaged & { defaultOptions: CacheOptions<any, any> } =\n /* @__PURE__ */ Object.assign(createPaged, {\n defaultOptions: defaultCacheOptions,\n });\n","export function findOrDefault<T>(\n array: T[],\n predicate: (item: T) => boolean,\n defaultValue: T | (() => T),\n): T {\n const index = array.findIndex(predicate);\n\n if (index >= 0) {\n return array[index]!;\n }\n\n const value = defaultValue instanceof Function ? defaultValue() : defaultValue;\n array.push(value);\n return value;\n}\n"],"mappings":";;;;;;;;;AA2DA,IAAa,aAAb,MAAa,mBAA+CA,oBAA2B;CACrF,YACE,AAAgBC,YAChB,MACA,UAA6C,IAC7C;AACA,QAAM,OAAO,YAAY,SAAS,MAAM,SAAS,KAAK,MAAM,SAAS;EAJrD;AAKhB,yBAAS;;CAGX,MAAM,cAAc,EAAE,iBAAuC,IAAmB;EAC9E,MAAM,EAAE,QAAQ,SAAS,YAAY,UAAU,KAAK,MAAM;AAE1D,MAAI,WAAW,SAAS;AACtB,OAAI,CAAC,aAAc;AACnB,SAAM,IAAI,MAAM;;AAGlB,MAAI,YAAY;AACd,OAAI,CAAC,aAAc;AACnB,SAAM,IAAI,MAAM;;AAGlB,MAAI,WAAW,aAAa,SAAS;AACnC,SAAM,KAAK,MAAM,YAAY;AAC7B;;AAGF,MAAI,CAAC,MAAM,SAAS;AAClB,OAAI,CAAC,aAAc;AACnB,SAAM,IAAI,MAAM;;AAGlB,OAAK,eAAe,KAAK,iBAAiB;EAE1C,MAAM,KAAK,IAAI;EACf,MAAM,UAAU,SACd,MACA;GACE,MAAM;AACJ,UAAM,IAAI,MAAM;;GAElB,UAAU;AACR,UAAM,IAAI,MAAM;;GAElB,QAAQ,GAAG;KAEb,MAAM;AAGR,OAAK,YAAY;AAEjB,MAAI;AACF,SAAM;WACC,OAAO;AACd,OAAI,CAAC,aAAc;AACnB,SAAM;;;;AAKZ,eAAe,SACb,OACA,SACA,UACA;CACA,MAAM,EAAE,WAAW,cAAc,iBAAiB,MAAM;CAExD,MAAM,OAAO,MAAM,UAAU,KAAK,OAAO;EACvC,GAAG;EACH,OAAO;EACP,UAAU,SAAS,SAAS,IAAI,SAAS,SAAS,SAAS,KAAM;;CAGnE,MAAM,QAAQ,SAAS,OAAO,WAAW,SAAS,OAAO;CACzD,MAAM,YAAY,cAAc,KAAK,OAAO,UAAU;CACtD,MAAM,UAAU,eACZ,aAAa,KAAK,OAAO,SACzB,cAAc,OACZ,MAAM,SAAS,YACf,SAAS;AAEf,QAAO;EAAE;EAAO;EAAS;;;AAa3B,SAAS,YACP,YACA,SAC6D;AAC7D,QAAOC,8BAA0D,MAAM,cAAY;EACjF,IAAI,oBAAoB;AACxB,MAAI,6BAA6B,SAC/B,qBAAoB,kBAAkB,GAAG;AAE3C,SAAO,IAAI,WAAW,mBAAmB,MAAMC;IAC9C;;AAGL,MAAaC,mBACK,uBAAO,OAAO,aAAa,EACzC,gBAAgBC;;;;ACzKpB,SAAgB,cACd,OACA,WACA,cACG;CACH,MAAM,QAAQ,MAAM,UAAU;AAE9B,KAAI,SAAS,EACX,QAAO,MAAM;CAGf,MAAM,QAAQ,wBAAwB,WAAW,iBAAiB;AAClE,OAAM,KAAK;AACX,QAAO"}
1
+ {"version":3,"file":"index.cjs","names":["Cache","definition: PagedCacheDefinition<T, Args>","internalCreate","options","createPagedCache: typeof createPaged & { defaultOptions: CacheOptions<any, any> }","defaultCacheOptions"],"sources":["../src/core/pagedCache.ts","../src/lib/updateHelpers.ts"],"sourcesContent":["import {\n Cache,\n defaultCacheOptions,\n internalCreate,\n type CacheOptions,\n type CreateCacheResult,\n} from '@core/cache';\nimport type { CalculationActions } from '@core/commonTypes';\nimport { autobind } from '@lib/autobind';\n\nexport interface PageCacheFunctionProps<T> extends CalculationActions<Promise<PagedCacheState<T>>> {\n /**\n * Previously fetched pages (in order).\n */\n pages: T[];\n /**\n * Last fetched page or null if there are no previously fetched pages.\n */\n prevPage: T | null;\n}\n\nexport interface PageCacheFunction<T> {\n (props: PageCacheFunctionProps<T>): Promise<T | null>;\n}\n\nexport interface PagedCacheDefinition<T, Args extends any[]> {\n /**\n * Function to fetch a page.\n * The function receives the current state of the cache, including previously fetched pages.\n */\n fetchPage: (this: PagedCache<T, Args>, props: PageCacheFunctionProps<T>) => Promise<T | null>;\n /**\n * Optional function to determine the total number of pages - usually based on data in the fetched pages.\n */\n getPageCount?: (this: PagedCache<T, Args>, pages: T[]) => number | null;\n /**\n * Optional function to determine if there are more pages to fetch - usually based on data in the fetched pages.\n * If not provided, it will be assumed there are more pages until getPageCount is provided and the number of fetched pages equals the page count or until fetchPage returns null.\n */\n hasMorePages?: (this: PagedCache<T, Args>, pages: T[]) => boolean;\n}\n\nexport interface PagedCacheDefinitionFunction<T, Args extends any[]> {\n (...args: Args): PagedCacheDefinition<T, Args>;\n}\n\nexport interface PagedCacheState<T> {\n pages: T[];\n hasMore: boolean;\n pageCount: number | null;\n}\n\nexport interface FetchNextPageOptions {\n /**\n * If true, will throw if the cache is in an error state or if another page is being fetched.\n */\n throwOnError?: boolean;\n}\n\nexport class PagedCache<T, Args extends any[] = []> extends Cache<PagedCacheState<T>, Args> {\n constructor(\n public readonly definition: PagedCacheDefinition<T, Args>,\n args: Args,\n options: CacheOptions<PagedCacheState<T>, Args> = {},\n ) {\n super(async (helpers) => loadPage(this, helpers, []), args, options, undefined);\n autobind(PagedCache);\n }\n\n async fetchNextPage({ throwOnError }: FetchNextPageOptions = {}): Promise<void> {\n const { status, isStale, isUpdating, value } = this.state.get();\n\n if (status === 'error') {\n if (!throwOnError) return;\n throw new Error('Cannot fetch next page while cache is in error state');\n }\n\n if (isUpdating) {\n if (!throwOnError) return;\n throw new Error('Cannot fetch next page while another page is being fetched');\n }\n\n if (status === 'pending' || isStale) {\n await this.get().catch(() => {});\n return;\n }\n\n if (!value.hasMore) {\n if (!throwOnError) return;\n throw new Error('No more pages to fetch');\n }\n\n this.stalePromise = this.calculatedValue?.value;\n\n const ac = new AbortController();\n const promise = loadPage(\n this,\n {\n use() {\n throw new Error('Not implemented');\n },\n connect() {\n throw new Error('Not implemented');\n },\n signal: ac.signal,\n },\n value.pages,\n );\n\n this.updateValue(promise);\n\n try {\n await promise;\n } catch (error) {\n if (!throwOnError) return;\n throw error;\n }\n }\n}\n\nasync function loadPage<T, Args extends any[]>(\n cache: PagedCache<T, Args>,\n helpers: CalculationActions<Promise<PagedCacheState<T>>>,\n oldPages: T[],\n) {\n const { fetchPage, hasMorePages, getPageCount } = cache.definition;\n\n const page = await fetchPage.call(cache, {\n ...helpers,\n pages: oldPages,\n prevPage: oldPages.length > 0 ? oldPages[oldPages.length - 1]! : null,\n });\n\n const pages = page === null ? oldPages : oldPages.concat(page);\n const pageCount = getPageCount?.call(cache, pages) ?? null;\n const hasMore = hasMorePages\n ? hasMorePages.call(cache, pages)\n : pageCount !== null\n ? pages.length < pageCount\n : page !== null;\n\n return { pages, hasMore, pageCount };\n}\n\nfunction createPaged<T, Args extends any[] = []>(\n definition: PagedCacheDefinitionFunction<T, Args>,\n options?: CacheOptions<PagedCacheState<T>, Args>,\n): CreateCacheResult<PagedCacheState<T>, Args, PagedCache<T, Args>>;\n\nfunction createPaged<T>(\n definition: PagedCacheDefinition<T, []>,\n options?: CacheOptions<PagedCacheState<T>, []>,\n): CreateCacheResult<PagedCacheState<T>, [], PagedCache<T, []>>;\n\nfunction createPaged<T, Args extends any[] = []>(\n definition: PagedCacheDefinitionFunction<T, Args> | PagedCacheDefinition<T, Args>,\n options?: CacheOptions<PagedCacheState<T>, Args>,\n): CreateCacheResult<PagedCacheState<T>, Args, PagedCache<T, Args>> {\n return internalCreate<PagedCacheState<T>, Args, PagedCache<T, Args>>((args, options) => {\n let currentDefinition = definition;\n if (currentDefinition instanceof Function) {\n currentDefinition = currentDefinition(...args);\n }\n return new PagedCache(currentDefinition, args, options);\n }, options);\n}\n\nexport const createPagedCache: typeof createPaged & { defaultOptions: CacheOptions<any, any> } =\n /* @__PURE__ */ Object.assign(createPaged, {\n defaultOptions: defaultCacheOptions,\n });\n","export function findOrDefault<T>(\n array: T[],\n predicate: (item: T) => boolean,\n defaultValue: T | (() => T),\n): T {\n const index = array.findIndex(predicate);\n\n if (index >= 0) {\n return array[index]!;\n }\n\n const value = defaultValue instanceof Function ? defaultValue() : defaultValue;\n array.push(value);\n return value;\n}\n"],"mappings":";;;;;;;;;AA2DA,IAAa,aAAb,MAAa,mBAA+CA,oBAAgC;CAC1F,YACE,AAAgBC,YAChB,MACA,UAAkD,IAClD;AACA,QAAM,OAAO,YAAY,SAAS,MAAM,SAAS,KAAK,MAAM,SAAS;EAJrD;AAKhB,yBAAS;;CAGX,MAAM,cAAc,EAAE,iBAAuC,IAAmB;EAC9E,MAAM,EAAE,QAAQ,SAAS,YAAY,UAAU,KAAK,MAAM;AAE1D,MAAI,WAAW,SAAS;AACtB,OAAI,CAAC,aAAc;AACnB,SAAM,IAAI,MAAM;;AAGlB,MAAI,YAAY;AACd,OAAI,CAAC,aAAc;AACnB,SAAM,IAAI,MAAM;;AAGlB,MAAI,WAAW,aAAa,SAAS;AACnC,SAAM,KAAK,MAAM,YAAY;AAC7B;;AAGF,MAAI,CAAC,MAAM,SAAS;AAClB,OAAI,CAAC,aAAc;AACnB,SAAM,IAAI,MAAM;;AAGlB,OAAK,eAAe,KAAK,iBAAiB;EAE1C,MAAM,KAAK,IAAI;EACf,MAAM,UAAU,SACd,MACA;GACE,MAAM;AACJ,UAAM,IAAI,MAAM;;GAElB,UAAU;AACR,UAAM,IAAI,MAAM;;GAElB,QAAQ,GAAG;KAEb,MAAM;AAGR,OAAK,YAAY;AAEjB,MAAI;AACF,SAAM;WACC,OAAO;AACd,OAAI,CAAC,aAAc;AACnB,SAAM;;;;AAKZ,eAAe,SACb,OACA,SACA,UACA;CACA,MAAM,EAAE,WAAW,cAAc,iBAAiB,MAAM;CAExD,MAAM,OAAO,MAAM,UAAU,KAAK,OAAO;EACvC,GAAG;EACH,OAAO;EACP,UAAU,SAAS,SAAS,IAAI,SAAS,SAAS,SAAS,KAAM;;CAGnE,MAAM,QAAQ,SAAS,OAAO,WAAW,SAAS,OAAO;CACzD,MAAM,YAAY,cAAc,KAAK,OAAO,UAAU;CACtD,MAAM,UAAU,eACZ,aAAa,KAAK,OAAO,SACzB,cAAc,OACZ,MAAM,SAAS,YACf,SAAS;AAEf,QAAO;EAAE;EAAO;EAAS;;;AAa3B,SAAS,YACP,YACA,SACkE;AAClE,QAAOC,8BAA+D,MAAM,cAAY;EACtF,IAAI,oBAAoB;AACxB,MAAI,6BAA6B,SAC/B,qBAAoB,kBAAkB,GAAG;AAE3C,SAAO,IAAI,WAAW,mBAAmB,MAAMC;IAC9C;;AAGL,MAAaC,mBACK,uBAAO,OAAO,aAAa,EACzC,gBAAgBC;;;;ACzKpB,SAAgB,cACd,OACA,WACA,cACG;CACH,MAAM,QAAQ,MAAM,UAAU;AAE9B,KAAI,SAAS,EACX,QAAO,MAAM;CAGf,MAAM,QAAQ,wBAAwB,WAAW,iBAAiB;AAClE,OAAM,KAAK;AACX,QAAO"}
package/dist/index.d.cts CHANGED
@@ -4,7 +4,7 @@ import { Patch, diff } from "./diff-BQ8bB3Wk.cjs";
4
4
  import { Persist, PersistOptions, PersistStorage, PersistStorageBase, PersistStorageWithKeys, PersistStorageWithLength, PersistStorageWithListItems, persist } from "./persist-D7MAsyyW.cjs";
5
5
 
6
6
  //#region src/core/pagedCache.d.ts
7
- interface PageCacheFunctionProps<T> extends CalculationActions<Promise<PagedState<T>>> {
7
+ interface PageCacheFunctionProps<T> extends CalculationActions<Promise<PagedCacheState<T>>> {
8
8
  /**
9
9
  * Previously fetched pages (in order).
10
10
  */
@@ -36,7 +36,7 @@ interface PagedCacheDefinition<T, Args extends any[]> {
36
36
  interface PagedCacheDefinitionFunction<T, Args extends any[]> {
37
37
  (...args: Args): PagedCacheDefinition<T, Args>;
38
38
  }
39
- interface PagedState<T> {
39
+ interface PagedCacheState<T> {
40
40
  pages: T[];
41
41
  hasMore: boolean;
42
42
  pageCount: number | null;
@@ -47,15 +47,15 @@ interface FetchNextPageOptions {
47
47
  */
48
48
  throwOnError?: boolean;
49
49
  }
50
- declare class PagedCache<T, Args extends any[] = []> extends Cache<PagedState<T>, Args> {
50
+ declare class PagedCache<T, Args extends any[] = []> extends Cache<PagedCacheState<T>, Args> {
51
51
  readonly definition: PagedCacheDefinition<T, Args>;
52
- constructor(definition: PagedCacheDefinition<T, Args>, args: Args, options?: CacheOptions<PagedState<T>, Args>);
52
+ constructor(definition: PagedCacheDefinition<T, Args>, args: Args, options?: CacheOptions<PagedCacheState<T>, Args>);
53
53
  fetchNextPage({
54
54
  throwOnError
55
55
  }?: FetchNextPageOptions): Promise<void>;
56
56
  }
57
- declare function createPaged<T, Args extends any[] = []>(definition: PagedCacheDefinitionFunction<T, Args>, options?: CacheOptions<PagedState<T>, Args>): CreateCacheResult<PagedState<T>, Args, PagedCache<T, Args>>;
58
- declare function createPaged<T>(definition: PagedCacheDefinition<T, []>, options?: CacheOptions<PagedState<T>, []>): CreateCacheResult<PagedState<T>, [], PagedCache<T, []>>;
57
+ declare function createPaged<T, Args extends any[] = []>(definition: PagedCacheDefinitionFunction<T, Args>, options?: CacheOptions<PagedCacheState<T>, Args>): CreateCacheResult<PagedCacheState<T>, Args, PagedCache<T, Args>>;
58
+ declare function createPaged<T>(definition: PagedCacheDefinition<T, []>, options?: CacheOptions<PagedCacheState<T>, []>): CreateCacheResult<PagedCacheState<T>, [], PagedCache<T, []>>;
59
59
  declare const createPagedCache: typeof createPaged & {
60
60
  defaultOptions: CacheOptions<any, any>;
61
61
  };
@@ -118,5 +118,5 @@ declare function set<T, const P>(object: T, path: Constrain<P, SettablePath<T>>,
118
118
  //#region src/lib/updateHelpers.d.ts
119
119
  declare function findOrDefault<T>(array: T[], predicate: (item: T) => boolean, defaultValue: T | (() => T)): T;
120
120
  //#endregion
121
- export { AsyncConnectionActions, AsyncUpdateFunction, BaseConnectionActions, BoundStoreMethods, Cache, CacheBundle, CacheFunction, CacheGetOptions, CacheOptions, CacheState, CalculationActions, Cancel, Connection, ConnectionActions, CreateCacheResult, DisposableCancel, Duration, Effect, ErrorState, type Hashable, InstanceCache, Listener, PageCacheFunction, PageCacheFunctionProps, PagedCache, PagedCacheDefinition, PagedCacheDefinitionFunction, type Patch, type Path, type PathAsArray, type PathAsString, PendingState, Persist, PersistOptions, PersistStorage, PersistStorageBase, PersistStorageWithKeys, PersistStorageWithLength, PersistStorageWithListItems, Resource, ResourceGroup, Scope, Selector, type SettablePath, type SettablePathAsArray, type SettablePathAsString, Store, StoreMethods, StoreOptions, StoreOptionsWithMethods, SubscribeOptions, Update, UpdateFrom, UpdateFunction, Use, type Value, ValueState, allResources, applyPatches, arrayMethods, calcDuration, createCache, createPagedCache, createResourceGroup, createScope, createStore, deepEqual, diff, findOrDefault, fromExtendedJson, fromExtendedJsonString, get, hash, mapMethods, persist, recordMethods, set, setMethods, shallowEqual, simpleHash, strictEqual, toExtendedJson, toExtendedJsonString };
121
+ export { AsyncConnectionActions, AsyncUpdateFunction, BaseConnectionActions, BoundStoreMethods, Cache, CacheBundle, CacheFunction, CacheGetOptions, CacheOptions, CacheState, CalculationActions, Cancel, Connection, ConnectionActions, CreateCacheResult, DisposableCancel, Duration, Effect, ErrorState, FetchNextPageOptions, type Hashable, InstanceCache, Listener, PageCacheFunction, PageCacheFunctionProps, PagedCache, PagedCacheDefinition, PagedCacheDefinitionFunction, PagedCacheState, type Patch, type Path, type PathAsArray, type PathAsString, PendingState, Persist, PersistOptions, PersistStorage, PersistStorageBase, PersistStorageWithKeys, PersistStorageWithLength, PersistStorageWithListItems, Resource, ResourceGroup, Scope, Selector, type SettablePath, type SettablePathAsArray, type SettablePathAsString, Store, StoreMethods, StoreOptions, StoreOptionsWithMethods, SubscribeOptions, Update, UpdateFrom, UpdateFunction, Use, type Value, ValueState, allResources, applyPatches, arrayMethods, calcDuration, createCache, createPagedCache, createResourceGroup, createScope, createStore, deepEqual, diff, findOrDefault, fromExtendedJson, fromExtendedJsonString, get, hash, mapMethods, persist, recordMethods, set, setMethods, shallowEqual, simpleHash, strictEqual, toExtendedJson, toExtendedJsonString };
122
122
  //# sourceMappingURL=index.d.cts.map
package/dist/index.d.ts CHANGED
@@ -4,7 +4,7 @@ import { Patch, diff } from "./diff-gZezL04N.js";
4
4
  import { Persist, PersistOptions, PersistStorage, PersistStorageBase, PersistStorageWithKeys, PersistStorageWithLength, PersistStorageWithListItems, persist } from "./persist-CPjpg6D0.js";
5
5
 
6
6
  //#region src/core/pagedCache.d.ts
7
- interface PageCacheFunctionProps<T> extends CalculationActions<Promise<PagedState<T>>> {
7
+ interface PageCacheFunctionProps<T> extends CalculationActions<Promise<PagedCacheState<T>>> {
8
8
  /**
9
9
  * Previously fetched pages (in order).
10
10
  */
@@ -36,7 +36,7 @@ interface PagedCacheDefinition<T, Args extends any[]> {
36
36
  interface PagedCacheDefinitionFunction<T, Args extends any[]> {
37
37
  (...args: Args): PagedCacheDefinition<T, Args>;
38
38
  }
39
- interface PagedState<T> {
39
+ interface PagedCacheState<T> {
40
40
  pages: T[];
41
41
  hasMore: boolean;
42
42
  pageCount: number | null;
@@ -47,15 +47,15 @@ interface FetchNextPageOptions {
47
47
  */
48
48
  throwOnError?: boolean;
49
49
  }
50
- declare class PagedCache<T, Args extends any[] = []> extends Cache<PagedState<T>, Args> {
50
+ declare class PagedCache<T, Args extends any[] = []> extends Cache<PagedCacheState<T>, Args> {
51
51
  readonly definition: PagedCacheDefinition<T, Args>;
52
- constructor(definition: PagedCacheDefinition<T, Args>, args: Args, options?: CacheOptions<PagedState<T>, Args>);
52
+ constructor(definition: PagedCacheDefinition<T, Args>, args: Args, options?: CacheOptions<PagedCacheState<T>, Args>);
53
53
  fetchNextPage({
54
54
  throwOnError
55
55
  }?: FetchNextPageOptions): Promise<void>;
56
56
  }
57
- declare function createPaged<T, Args extends any[] = []>(definition: PagedCacheDefinitionFunction<T, Args>, options?: CacheOptions<PagedState<T>, Args>): CreateCacheResult<PagedState<T>, Args, PagedCache<T, Args>>;
58
- declare function createPaged<T>(definition: PagedCacheDefinition<T, []>, options?: CacheOptions<PagedState<T>, []>): CreateCacheResult<PagedState<T>, [], PagedCache<T, []>>;
57
+ declare function createPaged<T, Args extends any[] = []>(definition: PagedCacheDefinitionFunction<T, Args>, options?: CacheOptions<PagedCacheState<T>, Args>): CreateCacheResult<PagedCacheState<T>, Args, PagedCache<T, Args>>;
58
+ declare function createPaged<T>(definition: PagedCacheDefinition<T, []>, options?: CacheOptions<PagedCacheState<T>, []>): CreateCacheResult<PagedCacheState<T>, [], PagedCache<T, []>>;
59
59
  declare const createPagedCache: typeof createPaged & {
60
60
  defaultOptions: CacheOptions<any, any>;
61
61
  };
@@ -118,5 +118,5 @@ declare function set<T, const P>(object: T, path: Constrain<P, SettablePath<T>>,
118
118
  //#region src/lib/updateHelpers.d.ts
119
119
  declare function findOrDefault<T>(array: T[], predicate: (item: T) => boolean, defaultValue: T | (() => T)): T;
120
120
  //#endregion
121
- export { AsyncConnectionActions, AsyncUpdateFunction, BaseConnectionActions, BoundStoreMethods, Cache, CacheBundle, CacheFunction, CacheGetOptions, CacheOptions, CacheState, CalculationActions, Cancel, Connection, ConnectionActions, CreateCacheResult, DisposableCancel, Duration, Effect, ErrorState, type Hashable, InstanceCache, Listener, PageCacheFunction, PageCacheFunctionProps, PagedCache, PagedCacheDefinition, PagedCacheDefinitionFunction, type Patch, type Path, type PathAsArray, type PathAsString, PendingState, Persist, PersistOptions, PersistStorage, PersistStorageBase, PersistStorageWithKeys, PersistStorageWithLength, PersistStorageWithListItems, Resource, ResourceGroup, Scope, Selector, type SettablePath, type SettablePathAsArray, type SettablePathAsString, Store, StoreMethods, StoreOptions, StoreOptionsWithMethods, SubscribeOptions, Update, UpdateFrom, UpdateFunction, Use, type Value, ValueState, allResources, applyPatches, arrayMethods, calcDuration, createCache, createPagedCache, createResourceGroup, createScope, createStore, deepEqual, diff, findOrDefault, fromExtendedJson, fromExtendedJsonString, get, hash, mapMethods, persist, recordMethods, set, setMethods, shallowEqual, simpleHash, strictEqual, toExtendedJson, toExtendedJsonString };
121
+ export { AsyncConnectionActions, AsyncUpdateFunction, BaseConnectionActions, BoundStoreMethods, Cache, CacheBundle, CacheFunction, CacheGetOptions, CacheOptions, CacheState, CalculationActions, Cancel, Connection, ConnectionActions, CreateCacheResult, DisposableCancel, Duration, Effect, ErrorState, FetchNextPageOptions, type Hashable, InstanceCache, Listener, PageCacheFunction, PageCacheFunctionProps, PagedCache, PagedCacheDefinition, PagedCacheDefinitionFunction, PagedCacheState, type Patch, type Path, type PathAsArray, type PathAsString, PendingState, Persist, PersistOptions, PersistStorage, PersistStorageBase, PersistStorageWithKeys, PersistStorageWithLength, PersistStorageWithListItems, Resource, ResourceGroup, Scope, Selector, type SettablePath, type SettablePathAsArray, type SettablePathAsString, Store, StoreMethods, StoreOptions, StoreOptionsWithMethods, SubscribeOptions, Update, UpdateFrom, UpdateFunction, Use, type Value, ValueState, allResources, applyPatches, arrayMethods, calcDuration, createCache, createPagedCache, createResourceGroup, createScope, createStore, deepEqual, diff, findOrDefault, fromExtendedJson, fromExtendedJsonString, get, hash, mapMethods, persist, recordMethods, set, setMethods, shallowEqual, simpleHash, strictEqual, toExtendedJson, toExtendedJsonString };
122
122
  //# sourceMappingURL=index.d.ts.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","names":["definition: PagedCacheDefinition<T, Args>","options","createPagedCache: typeof createPaged & { defaultOptions: CacheOptions<any, any> }"],"sources":["../src/core/pagedCache.ts","../src/lib/updateHelpers.ts"],"sourcesContent":["import {\n Cache,\n defaultCacheOptions,\n internalCreate,\n type CacheOptions,\n type CreateCacheResult,\n} from '@core/cache';\nimport type { CalculationActions } from '@core/commonTypes';\nimport { autobind } from '@lib/autobind';\n\nexport interface PageCacheFunctionProps<T> extends CalculationActions<Promise<PagedState<T>>> {\n /**\n * Previously fetched pages (in order).\n */\n pages: T[];\n /**\n * Last fetched page or null if there are no previously fetched pages.\n */\n prevPage: T | null;\n}\n\nexport interface PageCacheFunction<T> {\n (props: PageCacheFunctionProps<T>): Promise<T | null>;\n}\n\nexport interface PagedCacheDefinition<T, Args extends any[]> {\n /**\n * Function to fetch a page.\n * The function receives the current state of the cache, including previously fetched pages.\n */\n fetchPage: (this: PagedCache<T, Args>, props: PageCacheFunctionProps<T>) => Promise<T | null>;\n /**\n * Optional function to determine the total number of pages - usually based on data in the fetched pages.\n */\n getPageCount?: (this: PagedCache<T, Args>, pages: T[]) => number | null;\n /**\n * Optional function to determine if there are more pages to fetch - usually based on data in the fetched pages.\n * If not provided, it will be assumed there are more pages until getPageCount is provided and the number of fetched pages equals the page count or until fetchPage returns null.\n */\n hasMorePages?: (this: PagedCache<T, Args>, pages: T[]) => boolean;\n}\n\nexport interface PagedCacheDefinitionFunction<T, Args extends any[]> {\n (...args: Args): PagedCacheDefinition<T, Args>;\n}\n\nexport interface PagedState<T> {\n pages: T[];\n hasMore: boolean;\n pageCount: number | null;\n}\n\nexport interface FetchNextPageOptions {\n /**\n * If true, will throw if the cache is in an error state or if another page is being fetched.\n */\n throwOnError?: boolean;\n}\n\nexport class PagedCache<T, Args extends any[] = []> extends Cache<PagedState<T>, Args> {\n constructor(\n public readonly definition: PagedCacheDefinition<T, Args>,\n args: Args,\n options: CacheOptions<PagedState<T>, Args> = {},\n ) {\n super(async (helpers) => loadPage(this, helpers, []), args, options, undefined);\n autobind(PagedCache);\n }\n\n async fetchNextPage({ throwOnError }: FetchNextPageOptions = {}): Promise<void> {\n const { status, isStale, isUpdating, value } = this.state.get();\n\n if (status === 'error') {\n if (!throwOnError) return;\n throw new Error('Cannot fetch next page while cache is in error state');\n }\n\n if (isUpdating) {\n if (!throwOnError) return;\n throw new Error('Cannot fetch next page while another page is being fetched');\n }\n\n if (status === 'pending' || isStale) {\n await this.get().catch(() => {});\n return;\n }\n\n if (!value.hasMore) {\n if (!throwOnError) return;\n throw new Error('No more pages to fetch');\n }\n\n this.stalePromise = this.calculatedValue?.value;\n\n const ac = new AbortController();\n const promise = loadPage(\n this,\n {\n use() {\n throw new Error('Not implemented');\n },\n connect() {\n throw new Error('Not implemented');\n },\n signal: ac.signal,\n },\n value.pages,\n );\n\n this.updateValue(promise);\n\n try {\n await promise;\n } catch (error) {\n if (!throwOnError) return;\n throw error;\n }\n }\n}\n\nasync function loadPage<T, Args extends any[]>(\n cache: PagedCache<T, Args>,\n helpers: CalculationActions<Promise<PagedState<T>>>,\n oldPages: T[],\n) {\n const { fetchPage, hasMorePages, getPageCount } = cache.definition;\n\n const page = await fetchPage.call(cache, {\n ...helpers,\n pages: oldPages,\n prevPage: oldPages.length > 0 ? oldPages[oldPages.length - 1]! : null,\n });\n\n const pages = page === null ? oldPages : oldPages.concat(page);\n const pageCount = getPageCount?.call(cache, pages) ?? null;\n const hasMore = hasMorePages\n ? hasMorePages.call(cache, pages)\n : pageCount !== null\n ? pages.length < pageCount\n : page !== null;\n\n return { pages, hasMore, pageCount };\n}\n\nfunction createPaged<T, Args extends any[] = []>(\n definition: PagedCacheDefinitionFunction<T, Args>,\n options?: CacheOptions<PagedState<T>, Args>,\n): CreateCacheResult<PagedState<T>, Args, PagedCache<T, Args>>;\n\nfunction createPaged<T>(\n definition: PagedCacheDefinition<T, []>,\n options?: CacheOptions<PagedState<T>, []>,\n): CreateCacheResult<PagedState<T>, [], PagedCache<T, []>>;\n\nfunction createPaged<T, Args extends any[] = []>(\n definition: PagedCacheDefinitionFunction<T, Args> | PagedCacheDefinition<T, Args>,\n options?: CacheOptions<PagedState<T>, Args>,\n): CreateCacheResult<PagedState<T>, Args, PagedCache<T, Args>> {\n return internalCreate<PagedState<T>, Args, PagedCache<T, Args>>((args, options) => {\n let currentDefinition = definition;\n if (currentDefinition instanceof Function) {\n currentDefinition = currentDefinition(...args);\n }\n return new PagedCache(currentDefinition, args, options);\n }, options);\n}\n\nexport const createPagedCache: typeof createPaged & { defaultOptions: CacheOptions<any, any> } =\n /* @__PURE__ */ Object.assign(createPaged, {\n defaultOptions: defaultCacheOptions,\n });\n","export function findOrDefault<T>(\n array: T[],\n predicate: (item: T) => boolean,\n defaultValue: T | (() => T),\n): T {\n const index = array.findIndex(predicate);\n\n if (index >= 0) {\n return array[index]!;\n }\n\n const value = defaultValue instanceof Function ? defaultValue() : defaultValue;\n array.push(value);\n return value;\n}\n"],"mappings":";;;;;;;;;AA2DA,IAAa,aAAb,MAAa,mBAA+C,MAA2B;CACrF,YACE,AAAgBA,YAChB,MACA,UAA6C,IAC7C;AACA,QAAM,OAAO,YAAY,SAAS,MAAM,SAAS,KAAK,MAAM,SAAS;EAJrD;AAKhB,WAAS;;CAGX,MAAM,cAAc,EAAE,iBAAuC,IAAmB;EAC9E,MAAM,EAAE,QAAQ,SAAS,YAAY,UAAU,KAAK,MAAM;AAE1D,MAAI,WAAW,SAAS;AACtB,OAAI,CAAC,aAAc;AACnB,SAAM,IAAI,MAAM;;AAGlB,MAAI,YAAY;AACd,OAAI,CAAC,aAAc;AACnB,SAAM,IAAI,MAAM;;AAGlB,MAAI,WAAW,aAAa,SAAS;AACnC,SAAM,KAAK,MAAM,YAAY;AAC7B;;AAGF,MAAI,CAAC,MAAM,SAAS;AAClB,OAAI,CAAC,aAAc;AACnB,SAAM,IAAI,MAAM;;AAGlB,OAAK,eAAe,KAAK,iBAAiB;EAE1C,MAAM,KAAK,IAAI;EACf,MAAM,UAAU,SACd,MACA;GACE,MAAM;AACJ,UAAM,IAAI,MAAM;;GAElB,UAAU;AACR,UAAM,IAAI,MAAM;;GAElB,QAAQ,GAAG;KAEb,MAAM;AAGR,OAAK,YAAY;AAEjB,MAAI;AACF,SAAM;WACC,OAAO;AACd,OAAI,CAAC,aAAc;AACnB,SAAM;;;;AAKZ,eAAe,SACb,OACA,SACA,UACA;CACA,MAAM,EAAE,WAAW,cAAc,iBAAiB,MAAM;CAExD,MAAM,OAAO,MAAM,UAAU,KAAK,OAAO;EACvC,GAAG;EACH,OAAO;EACP,UAAU,SAAS,SAAS,IAAI,SAAS,SAAS,SAAS,KAAM;;CAGnE,MAAM,QAAQ,SAAS,OAAO,WAAW,SAAS,OAAO;CACzD,MAAM,YAAY,cAAc,KAAK,OAAO,UAAU;CACtD,MAAM,UAAU,eACZ,aAAa,KAAK,OAAO,SACzB,cAAc,OACZ,MAAM,SAAS,YACf,SAAS;AAEf,QAAO;EAAE;EAAO;EAAS;;;AAa3B,SAAS,YACP,YACA,SAC6D;AAC7D,QAAO,gBAA0D,MAAM,cAAY;EACjF,IAAI,oBAAoB;AACxB,MAAI,6BAA6B,SAC/B,qBAAoB,kBAAkB,GAAG;AAE3C,SAAO,IAAI,WAAW,mBAAmB,MAAMC;IAC9C;;AAGL,MAAaC,mBACK,uBAAO,OAAO,aAAa,EACzC,gBAAgB;;;;ACzKpB,SAAgB,cACd,OACA,WACA,cACG;CACH,MAAM,QAAQ,MAAM,UAAU;AAE9B,KAAI,SAAS,EACX,QAAO,MAAM;CAGf,MAAM,QAAQ,wBAAwB,WAAW,iBAAiB;AAClE,OAAM,KAAK;AACX,QAAO"}
1
+ {"version":3,"file":"index.js","names":["definition: PagedCacheDefinition<T, Args>","options","createPagedCache: typeof createPaged & { defaultOptions: CacheOptions<any, any> }"],"sources":["../src/core/pagedCache.ts","../src/lib/updateHelpers.ts"],"sourcesContent":["import {\n Cache,\n defaultCacheOptions,\n internalCreate,\n type CacheOptions,\n type CreateCacheResult,\n} from '@core/cache';\nimport type { CalculationActions } from '@core/commonTypes';\nimport { autobind } from '@lib/autobind';\n\nexport interface PageCacheFunctionProps<T> extends CalculationActions<Promise<PagedCacheState<T>>> {\n /**\n * Previously fetched pages (in order).\n */\n pages: T[];\n /**\n * Last fetched page or null if there are no previously fetched pages.\n */\n prevPage: T | null;\n}\n\nexport interface PageCacheFunction<T> {\n (props: PageCacheFunctionProps<T>): Promise<T | null>;\n}\n\nexport interface PagedCacheDefinition<T, Args extends any[]> {\n /**\n * Function to fetch a page.\n * The function receives the current state of the cache, including previously fetched pages.\n */\n fetchPage: (this: PagedCache<T, Args>, props: PageCacheFunctionProps<T>) => Promise<T | null>;\n /**\n * Optional function to determine the total number of pages - usually based on data in the fetched pages.\n */\n getPageCount?: (this: PagedCache<T, Args>, pages: T[]) => number | null;\n /**\n * Optional function to determine if there are more pages to fetch - usually based on data in the fetched pages.\n * If not provided, it will be assumed there are more pages until getPageCount is provided and the number of fetched pages equals the page count or until fetchPage returns null.\n */\n hasMorePages?: (this: PagedCache<T, Args>, pages: T[]) => boolean;\n}\n\nexport interface PagedCacheDefinitionFunction<T, Args extends any[]> {\n (...args: Args): PagedCacheDefinition<T, Args>;\n}\n\nexport interface PagedCacheState<T> {\n pages: T[];\n hasMore: boolean;\n pageCount: number | null;\n}\n\nexport interface FetchNextPageOptions {\n /**\n * If true, will throw if the cache is in an error state or if another page is being fetched.\n */\n throwOnError?: boolean;\n}\n\nexport class PagedCache<T, Args extends any[] = []> extends Cache<PagedCacheState<T>, Args> {\n constructor(\n public readonly definition: PagedCacheDefinition<T, Args>,\n args: Args,\n options: CacheOptions<PagedCacheState<T>, Args> = {},\n ) {\n super(async (helpers) => loadPage(this, helpers, []), args, options, undefined);\n autobind(PagedCache);\n }\n\n async fetchNextPage({ throwOnError }: FetchNextPageOptions = {}): Promise<void> {\n const { status, isStale, isUpdating, value } = this.state.get();\n\n if (status === 'error') {\n if (!throwOnError) return;\n throw new Error('Cannot fetch next page while cache is in error state');\n }\n\n if (isUpdating) {\n if (!throwOnError) return;\n throw new Error('Cannot fetch next page while another page is being fetched');\n }\n\n if (status === 'pending' || isStale) {\n await this.get().catch(() => {});\n return;\n }\n\n if (!value.hasMore) {\n if (!throwOnError) return;\n throw new Error('No more pages to fetch');\n }\n\n this.stalePromise = this.calculatedValue?.value;\n\n const ac = new AbortController();\n const promise = loadPage(\n this,\n {\n use() {\n throw new Error('Not implemented');\n },\n connect() {\n throw new Error('Not implemented');\n },\n signal: ac.signal,\n },\n value.pages,\n );\n\n this.updateValue(promise);\n\n try {\n await promise;\n } catch (error) {\n if (!throwOnError) return;\n throw error;\n }\n }\n}\n\nasync function loadPage<T, Args extends any[]>(\n cache: PagedCache<T, Args>,\n helpers: CalculationActions<Promise<PagedCacheState<T>>>,\n oldPages: T[],\n) {\n const { fetchPage, hasMorePages, getPageCount } = cache.definition;\n\n const page = await fetchPage.call(cache, {\n ...helpers,\n pages: oldPages,\n prevPage: oldPages.length > 0 ? oldPages[oldPages.length - 1]! : null,\n });\n\n const pages = page === null ? oldPages : oldPages.concat(page);\n const pageCount = getPageCount?.call(cache, pages) ?? null;\n const hasMore = hasMorePages\n ? hasMorePages.call(cache, pages)\n : pageCount !== null\n ? pages.length < pageCount\n : page !== null;\n\n return { pages, hasMore, pageCount };\n}\n\nfunction createPaged<T, Args extends any[] = []>(\n definition: PagedCacheDefinitionFunction<T, Args>,\n options?: CacheOptions<PagedCacheState<T>, Args>,\n): CreateCacheResult<PagedCacheState<T>, Args, PagedCache<T, Args>>;\n\nfunction createPaged<T>(\n definition: PagedCacheDefinition<T, []>,\n options?: CacheOptions<PagedCacheState<T>, []>,\n): CreateCacheResult<PagedCacheState<T>, [], PagedCache<T, []>>;\n\nfunction createPaged<T, Args extends any[] = []>(\n definition: PagedCacheDefinitionFunction<T, Args> | PagedCacheDefinition<T, Args>,\n options?: CacheOptions<PagedCacheState<T>, Args>,\n): CreateCacheResult<PagedCacheState<T>, Args, PagedCache<T, Args>> {\n return internalCreate<PagedCacheState<T>, Args, PagedCache<T, Args>>((args, options) => {\n let currentDefinition = definition;\n if (currentDefinition instanceof Function) {\n currentDefinition = currentDefinition(...args);\n }\n return new PagedCache(currentDefinition, args, options);\n }, options);\n}\n\nexport const createPagedCache: typeof createPaged & { defaultOptions: CacheOptions<any, any> } =\n /* @__PURE__ */ Object.assign(createPaged, {\n defaultOptions: defaultCacheOptions,\n });\n","export function findOrDefault<T>(\n array: T[],\n predicate: (item: T) => boolean,\n defaultValue: T | (() => T),\n): T {\n const index = array.findIndex(predicate);\n\n if (index >= 0) {\n return array[index]!;\n }\n\n const value = defaultValue instanceof Function ? defaultValue() : defaultValue;\n array.push(value);\n return value;\n}\n"],"mappings":";;;;;;;;;AA2DA,IAAa,aAAb,MAAa,mBAA+C,MAAgC;CAC1F,YACE,AAAgBA,YAChB,MACA,UAAkD,IAClD;AACA,QAAM,OAAO,YAAY,SAAS,MAAM,SAAS,KAAK,MAAM,SAAS;EAJrD;AAKhB,WAAS;;CAGX,MAAM,cAAc,EAAE,iBAAuC,IAAmB;EAC9E,MAAM,EAAE,QAAQ,SAAS,YAAY,UAAU,KAAK,MAAM;AAE1D,MAAI,WAAW,SAAS;AACtB,OAAI,CAAC,aAAc;AACnB,SAAM,IAAI,MAAM;;AAGlB,MAAI,YAAY;AACd,OAAI,CAAC,aAAc;AACnB,SAAM,IAAI,MAAM;;AAGlB,MAAI,WAAW,aAAa,SAAS;AACnC,SAAM,KAAK,MAAM,YAAY;AAC7B;;AAGF,MAAI,CAAC,MAAM,SAAS;AAClB,OAAI,CAAC,aAAc;AACnB,SAAM,IAAI,MAAM;;AAGlB,OAAK,eAAe,KAAK,iBAAiB;EAE1C,MAAM,KAAK,IAAI;EACf,MAAM,UAAU,SACd,MACA;GACE,MAAM;AACJ,UAAM,IAAI,MAAM;;GAElB,UAAU;AACR,UAAM,IAAI,MAAM;;GAElB,QAAQ,GAAG;KAEb,MAAM;AAGR,OAAK,YAAY;AAEjB,MAAI;AACF,SAAM;WACC,OAAO;AACd,OAAI,CAAC,aAAc;AACnB,SAAM;;;;AAKZ,eAAe,SACb,OACA,SACA,UACA;CACA,MAAM,EAAE,WAAW,cAAc,iBAAiB,MAAM;CAExD,MAAM,OAAO,MAAM,UAAU,KAAK,OAAO;EACvC,GAAG;EACH,OAAO;EACP,UAAU,SAAS,SAAS,IAAI,SAAS,SAAS,SAAS,KAAM;;CAGnE,MAAM,QAAQ,SAAS,OAAO,WAAW,SAAS,OAAO;CACzD,MAAM,YAAY,cAAc,KAAK,OAAO,UAAU;CACtD,MAAM,UAAU,eACZ,aAAa,KAAK,OAAO,SACzB,cAAc,OACZ,MAAM,SAAS,YACf,SAAS;AAEf,QAAO;EAAE;EAAO;EAAS;;;AAa3B,SAAS,YACP,YACA,SACkE;AAClE,QAAO,gBAA+D,MAAM,cAAY;EACtF,IAAI,oBAAoB;AACxB,MAAI,6BAA6B,SAC/B,qBAAoB,kBAAkB,GAAG;AAE3C,SAAO,IAAI,WAAW,mBAAmB,MAAMC;IAC9C;;AAGL,MAAaC,mBACK,uBAAO,OAAO,aAAa,EACzC,gBAAgB;;;;ACzKpB,SAAgB,cACd,OACA,WACA,cACG;CACH,MAAM,QAAQ,MAAM,UAAU;AAE9B,KAAI,SAAS,EACX,QAAO,MAAM;CAGf,MAAM,QAAQ,wBAAwB,WAAW,iBAAiB;AAClE,OAAM,KAAK;AACX,QAAO"}
@@ -412,6 +412,22 @@ var Form = class Form {
412
412
  }
413
413
  };
414
414
  context.getField = (path) => lazy(path, () => getField(context, path));
415
+ (0, react.useEffect)(() => {
416
+ const transform$1 = options.transform;
417
+ if (!transform$1) return;
418
+ const store = formState.map((state) => state.draft ?? original ?? options.defaultValue, (draft) => (state) => ({
419
+ ...state,
420
+ draft
421
+ }));
422
+ return store.subscribe((value) => {
423
+ const result = transform$1(value, store);
424
+ if (result !== void 0 && !require_propAccess.deepEqual(result, value)) store.set(result);
425
+ });
426
+ }, [
427
+ original,
428
+ defaultValue,
429
+ options.transform
430
+ ]);
415
431
  useFormAutosave(context);
416
432
  return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(this.context.Provider, {
417
433
  value: context,
@@ -1 +1 @@
1
- {"version":3,"file":"index.cjs","names":["matches: Record<KeyType, any>","castArrayPath","isObject","value","form","name","Fragment","calcDuration","queue","debounce","options","deepEqual","errors","get","set","deepEqual","join","isObject","options: FormOptions<TDraft, TOriginal>","useStore","form","createStore","lastDraft: TDraft | undefined","context: FormContext<TDraft, TOriginal>","Form","UrlContext: Context<UrlContextType | undefined>","fromExtendedJsonString","toExtendedJsonString","value","url","location","params","update","options: Required<UrlOptions<T>>","update","value","delayedUpdate: (value: T) => void","debounce","throttle","simpleHash"],"sources":["../../src/react/form/customInput.tsx","../../src/lib/wildcardMatch.ts","../../src/react/form/formField.tsx","../../src/react/form/formForEach.tsx","../../src/react/form/useFormAutosave.ts","../../src/react/form/form.tsx","../../src/react/url/urlContext.tsx","../../src/react/url/urlHelpers.ts","../../src/react/url/urlOptions.ts","../../src/react/url/useUrlParam.ts","../../src/react/url/urlStore.ts","../../src/react/useDecoupledState.ts"],"sourcesContent":["import type { ReactNode } from 'react';\n\nexport interface CustomInputProps extends React.HTMLAttributes<HTMLDivElement> {\n name: string;\n children?: ReactNode;\n}\n\nexport function CustomInput({ name, children, ...props }: CustomInputProps): React.JSX.Element {\n return (\n <div\n {...props}\n style={{\n position: 'relative',\n ...props.style,\n }}\n >\n {children}\n\n <input\n name={name}\n style={{\n position: 'absolute',\n top: 0,\n left: 0,\n opacity: 0,\n width: '100%',\n height: '100%',\n pointerEvents: 'none',\n }}\n />\n </div>\n );\n}\n","import { isObject } from '@lib/helpers';\nimport { type KeyType } from './path';\nimport { castArrayPath } from './propAccess';\n\nexport function wildcardMatch(s: KeyType[] | string, w: KeyType[] | string): boolean {\n if (typeof s === 'string') {\n s = castArrayPath(s);\n }\n\n if (typeof w === 'string') {\n w = castArrayPath(w);\n }\n\n return s.length === w.length && s.every((s, i) => w[i] === '*' || s === w[i]);\n}\n\nexport function getWildCardMatches(\n object: any,\n path: [KeyType, ...KeyType[]] | string,\n): Record<KeyType, any> {\n const matches: Record<KeyType, any> = {};\n const [first, second, ...rest] = castArrayPath(path);\n\n if (first === undefined) {\n throw new Error('Path is empty');\n }\n\n if (!Array.isArray(object) && !isObject(object)) {\n object = {};\n }\n\n for (const [key, value] of first !== '*' ? [[first, object[first]]] : Object.entries(object)) {\n if (first !== '*' && first !== key) {\n continue;\n }\n\n if (second === undefined) {\n matches[key] = value;\n continue;\n }\n\n for (const [subKey, subValue] of Object.entries(getWildCardMatches(value, [second, ...rest]))) {\n matches[`${key}.${subKey}`] = subValue;\n }\n }\n\n return matches;\n}\n","import { type PathAsString, type Value } from '@lib/path';\nimport {\n createElement,\n useEffect,\n useState,\n type Component,\n type ComponentPropsWithoutRef,\n type ReactNode,\n} from 'react';\nimport {\n getDerivedState,\n type Field,\n type Form,\n type FormContext,\n type FormInstance,\n} from './form';\n\nexport interface FormFieldComponentProps<TValue, TPath> {\n name: TPath;\n value: TValue;\n onChange: (event: { target: { value: TValue } } | TValue | undefined, ...args: any[]) => void;\n onBlur: (...args: any[]) => void;\n}\n\nexport type FormFieldInfos<TDraft, TOriginal, TPath extends string> = Field<\n TDraft,\n TOriginal,\n TPath\n> & {\n hasTriggeredValidations: boolean;\n};\n\ntype NativeInputType = 'input' | 'select' | 'textarea';\n\ntype PartialComponentType<P> =\n | (new (props: P, context?: any) => Component<P, any>)\n | ((props: P, context?: any) => ReactNode);\n\nexport type FormFieldComponent = NativeInputType | PartialComponentType<any>;\n\ntype FieldValue<T extends FormFieldComponent> = ComponentPropsWithoutRef<T>['value'];\n\ntype FieldChangeValue<T extends FormFieldComponent> =\n ComponentPropsWithoutRef<T> extends {\n onChange?: (update: infer U) => void;\n }\n ? U extends { target: { value: infer V } }\n ? V\n : U\n : never;\n\ntype MakeOptional<T, Keys extends string> = Omit<T, Keys> & Partial<Pick<T, Keys & keyof T>>;\n\nexport type FormFieldProps<TPath, TDraft> = {\n name: TPath & PathAsString<TDraft>;\n commitOnBlur?: boolean;\n commitDebounce?: number;\n};\n\nexport type FormFieldPropsWithRender<TDraft, TOriginal, TPath extends string> = FormFieldProps<\n TPath,\n TDraft\n> &\n NoInfer<{\n component?: undefined;\n render: (\n props: FormFieldComponentProps<Value<TDraft, TPath>, TPath>,\n info: FormFieldInfos<TDraft, TOriginal, TPath>,\n form: FormContext<TDraft, TOriginal>,\n ) => ReactNode;\n inputFilter?: undefined;\n defaultValue?: undefined;\n serialize?: undefined;\n deserialize?: undefined;\n onChange?: undefined;\n onBlur?: undefined;\n }>;\n\ntype Serialize<TDraft, TOriginal, TPath, TComponent extends FormFieldComponent> = (\n value: Value<TDraft, TPath>,\n formState: FormInstance<TDraft, TOriginal>,\n) => FieldValue<TComponent>;\n\ntype Deserialize<TDraft, TOriginal, TPath, TComponent extends FormFieldComponent> = (\n value: FieldChangeValue<TComponent>,\n formState: FormInstance<TDraft, TOriginal>,\n) => Value<TDraft, TPath>;\n\nexport type FormFieldPropsWithComponent<\n TDraft,\n TOriginal,\n TPath extends string,\n TComponent extends FormFieldComponent,\n> = FormFieldProps<TPath, TDraft> & {\n component?: TComponent;\n render?: undefined;\n} & NoInfer<\n {\n inputFilter?: (value: FieldChangeValue<TComponent>) => boolean;\n } & MakeOptional<\n Omit<ComponentPropsWithoutRef<TComponent>, 'id' | 'name' | 'value' | 'defaultValue'>,\n 'onChange' | 'onBlur'\n > &\n (Value<TDraft, TPath> extends Exclude<FieldValue<TComponent>, undefined>\n ? {\n defaultValue?: FieldValue<TComponent>;\n serialize?: Serialize<TDraft, TOriginal, TPath, TComponent>;\n }\n : Value<TDraft, TPath> extends FieldValue<TComponent>\n ?\n | {\n defaultValue: FieldValue<TComponent>;\n serialize?: Serialize<TDraft, TOriginal, TPath, TComponent>;\n }\n | {\n defaultValue?: FieldValue<TComponent>;\n serialize: Serialize<TDraft, TOriginal, TPath, TComponent>;\n }\n : {\n serialize: Serialize<TDraft, TOriginal, TPath, TComponent>;\n }) &\n (FieldChangeValue<TComponent> extends Value<TDraft, TPath>\n ? {\n deserialize?: Deserialize<TDraft, TOriginal, TPath, TComponent>;\n }\n : {\n deserialize: Deserialize<TDraft, TOriginal, TPath, TComponent>;\n })\n >;\n\nexport function FormField<\n TDraft,\n TOriginal,\n TPath extends string,\n TComponent extends FormFieldComponent,\n>(\n this: Form<TDraft, any>,\n {\n // id,\n name = '' as any,\n component,\n commitOnBlur,\n commitDebounce,\n render,\n inputFilter,\n defaultValue,\n serialize,\n deserialize = (x) => x as Value<TDraft, TPath>,\n onChange,\n onBlur,\n ...restProps\n }:\n | FormFieldPropsWithRender<TDraft, TOriginal, TPath>\n | FormFieldPropsWithComponent<TDraft, TOriginal, TPath, TComponent>,\n): React.JSX.Element | null {\n type T = FieldChangeValue<TComponent>;\n\n const form = this.useForm();\n const getFormState = () => ({ ...form, ...getDerivedState(form) });\n const [localValue, setLocalValue] = useState<T>();\n\n const value = this.useFormState((form) => {\n const value = form.getField(name as any).value;\n if (serialize) {\n return serialize(value as any, getFormState());\n }\n if (value !== undefined) {\n return value;\n }\n return defaultValue;\n });\n\n const setValue = (x: FieldChangeValue<TComponent>) =>\n form.getField(name as any).setValue(deserialize(x, getFormState()));\n\n const hasTriggeredValidations = this.useFormState((form) => form.hasTriggeredValidations);\n\n useEffect(() => {\n if (localValue === undefined || !commitDebounce) {\n return;\n }\n\n const timeout = setTimeout(() => {\n setValue(localValue);\n setLocalValue(undefined);\n }, commitDebounce);\n\n return () => clearTimeout(timeout);\n }, [localValue, commitDebounce]);\n\n const props = {\n name,\n value: localValue ?? value,\n onChange: (event: { target: { value: T } } | T, ...moreArgs: any[]) => {\n const value =\n typeof event === 'object' && event !== null && 'target' in event\n ? event.target.value\n : event;\n\n if (inputFilter && !inputFilter(value)) {\n return;\n }\n\n if (commitOnBlur || commitDebounce) {\n setLocalValue(value);\n } else {\n setValue(value);\n }\n\n onChange?.(event, ...moreArgs);\n },\n onBlur(...args: any[]) {\n if (localValue !== undefined) {\n setValue(localValue);\n setLocalValue(undefined);\n }\n\n onBlur?.(...args);\n },\n } as FormFieldComponentProps<Value<TDraft, TPath>, TPath>;\n\n if (render) {\n return (\n <>\n {render(props, { ...form.getField(name as any), hasTriggeredValidations } as any, form) ??\n null}\n </>\n );\n }\n\n if (component) {\n return createElement(component, { ...restProps, ...props });\n }\n\n return null;\n}\n","import { type GetKeys, type Join, type PathAsString, type Value } from '@lib/path';\nimport { Fragment, useCallback, type ReactNode } from 'react';\nimport { type FieldHelperMethods, type Form } from './form';\n\nexport type ElementName<TDraft, TPath extends string> = keyof {\n [Path in TPath as Join<Path, GetKeys<NonNullable<Value<TDraft, Path>>> & (string | number)>]: 1;\n};\n\nexport interface FormForEachProps<TDraft, TPath extends string> {\n name: TPath & PathAsString<TDraft>;\n renderElement?: (props: {\n name: ElementName<TDraft, TPath>;\n key: `${GetKeys<NonNullable<Value<TDraft, TPath>>> & (string | number)}`;\n index: number;\n remove: () => void;\n }) => ReactNode;\n children?: (\n props: {\n setValue: (\n value: Value<TDraft, TPath> | ((value: Value<TDraft, TPath>) => Value<TDraft, TPath>),\n ) => void;\n } & FieldHelperMethods<TDraft, TPath>,\n ) => ReactNode;\n}\n\nexport function FormForEach<TDraft, TPath extends string>(\n this: Form<TDraft, any>,\n { name, renderElement, children }: FormForEachProps<TDraft, TPath>,\n): React.JSX.Element {\n const form = this.useForm();\n\n const names = this.useFormState(() => {\n const field = form.getField(name as any) as any;\n return field.names as any[];\n });\n\n const add = useCallback(\n (...args: any[]) => {\n const field = form.getField(name as any) as any;\n field.add(...args);\n },\n [form],\n );\n\n const remove = useCallback(\n (key: any) => {\n const field = form.getField(name as any) as any;\n field.remove(key);\n },\n [form],\n );\n\n const setValue = useCallback(\n (value: Value<TDraft, TPath> | ((value: Value<TDraft, TPath>) => Value<TDraft, TPath>)) => {\n const field = form.getField(name as any) as any;\n field.setValue(value);\n },\n [form],\n );\n\n return (\n <>\n {renderElement &&\n names.map((name, index) => {\n const key = name.split('.').pop();\n\n return (\n <Fragment key={key}>\n {renderElement({\n name,\n key,\n index,\n remove: () => remove(key),\n })}\n </Fragment>\n );\n })}\n\n {children?.({\n names,\n add,\n remove,\n setValue,\n } as any)}\n </>\n );\n}\n","import type { Duration } from '@core';\nimport { calcDuration } from '@lib/calcDuration';\nimport { debounce } from '@lib/debounce';\nimport { deepEqual } from '@lib/equals';\nimport type { MaybePromise } from '@lib/maybePromise';\nimport { queue } from '@lib/queue';\nimport { useEffect, useMemo, useRef } from 'react';\nimport type { FormContext } from './form';\n\nexport interface FormAutosaveOptions<TDraft, TOriginal> {\n save: (draft: TDraft, form: FormContext<TDraft, TOriginal>) => MaybePromise<void>;\n debounce?: Duration;\n resetAfterSave?: boolean;\n}\n\nexport function useFormAutosave<TDraft, TOriginal extends TDraft>(\n form: FormContext<TDraft, TOriginal>,\n): void {\n const { formState, options, getDraft } = form;\n const debounceTime = calcDuration(options.autoSave?.debounce ?? 2_000);\n const latestRef = useRef({ options });\n const lastValue = useRef<TDraft | undefined>(undefined);\n const q = useMemo(() => queue(), []);\n\n const run = useMemo(\n () =>\n debounce(async () => {\n const { options } = latestRef.current;\n const save = options.autoSave?.save;\n const draft = getDraft();\n\n lastValue.current = draft;\n\n q.clear();\n\n q(async () => {\n try {\n formState.set('saveInProgress', true);\n await save?.(draft, form);\n\n if (q.size === 0 && options.autoSave?.resetAfterSave) {\n form.reset();\n }\n } finally {\n formState.set('saveInProgress', false);\n\n if (q.size === 0) {\n formState.set('saveScheduled', false);\n }\n }\n });\n }, debounceTime),\n [formState, debounceTime],\n );\n\n useEffect(() => {\n if (!options.autoSave?.save) {\n return;\n }\n\n return formState\n .map((state) => state.draft)\n .subscribe(\n () => {\n if (deepEqual(getDraft(), lastValue.current)) {\n return;\n }\n\n run();\n formState.set('saveScheduled', true);\n },\n { runNow: false },\n );\n }, [formState]);\n\n useEffect(() => {\n latestRef.current = { options };\n });\n}\n","import { createStore, type Store, type Update } from '@core';\nimport { autobind } from '@lib/autobind';\nimport { deepEqual } from '@lib/equals';\nimport { isObject } from '@lib/helpers';\nimport {\n type Path,\n type PathAsString,\n type Value,\n type WildcardPathAsString,\n type WildcardValue,\n} from '@lib/path';\nimport { get, join, set } from '@lib/propAccess';\nimport type { Object_ } from '@lib/typeHelpers';\nimport { getWildCardMatches } from '@lib/wildcardMatch';\nimport {\n createContext,\n useContext,\n useEffect,\n useMemo,\n useRef,\n type Context,\n type FormEvent,\n type FunctionComponent,\n type HTMLProps,\n type ReactNode,\n} from 'react';\nimport { useStore, type UseStoreOptions } from '../useStore';\nimport {\n FormField,\n type FormFieldComponent,\n type FormFieldPropsWithComponent,\n type FormFieldPropsWithRender,\n} from './formField';\nimport { FormForEach, type ElementName, type FormForEachProps } from './formForEach';\nimport { useFormAutosave, type FormAutosaveOptions } from './useFormAutosave';\n\n/// /////////////////////////////////////////////////////////////////////////////\n// Form types\n/// /////////////////////////////////////////////////////////////////////////////\n\nexport type Transform<TDraft> = Path<TDraft> | '' extends infer TPath\n ? TPath extends TPath\n ? {\n update: (value: Value<TDraft, TPath>, store: Store<TDraft>) => void | TDraft;\n } & (TPath extends '' ? { trigger?: '' } : { trigger: TPath })\n : never\n : never;\n\nexport interface FormOptions<TDraft, TOriginal> {\n defaultValue: TDraft;\n validations?: Validations<TDraft, TOriginal>;\n localizeError?: (error: string, field: string) => string | undefined;\n autoSave?: FormAutosaveOptions<TDraft, TOriginal>;\n transform?: Transform<TDraft>[];\n validatedClass?: string;\n}\n\nexport type Validations<TDraft, TOriginal> = {\n [TPath in WildcardPathAsString<TDraft>]?: Record<string, Validation<TDraft, TOriginal, TPath>>;\n} & Record<string, Record<string, Validation<TDraft, TOriginal, any>>>;\n\nexport type Validation<TDraft, TOriginal, TPath> = (\n value: WildcardValue<TDraft, TPath>,\n context: {\n draft: TDraft;\n original: TOriginal;\n field: PathAsString<TDraft> | '';\n },\n) => boolean;\n\nexport type Field<TDraft, TOriginal, TPath extends string> = {\n originalValue: Value<TOriginal, TPath> | undefined;\n value: Value<TDraft, TPath>;\n setValue: (value: Update<Value<TDraft, TPath>>) => void;\n removeValue: () => void;\n hasChange: boolean;\n errors: string[];\n} & (Value<TDraft, TPath> extends Object_ ? FieldHelperMethods<TDraft, TPath> : {});\n\nexport type FieldHelperMethods<TDraft, TPath extends string> = {\n names: ElementName<TDraft, TPath>[];\n add: NonNullable<Value<TDraft, TPath>> extends readonly (infer T)[]\n ? (element: T) => void\n : NonNullable<Value<TDraft, TPath>> extends Record<infer K, infer V>\n ? (key: K, value: V) => void\n : never;\n remove: Value<TDraft, TPath> extends readonly any[]\n ? (index: number) => void\n : (key: string) => void;\n};\n\nexport interface FormState<TDraft> {\n draft: TDraft | undefined;\n hasTriggeredValidations: boolean;\n saveScheduled: boolean;\n saveInProgress: boolean;\n}\n\nexport interface FormDerivedState<TDraft> {\n draft: TDraft;\n hasTriggeredValidations: boolean;\n saveScheduled: boolean;\n saveInProgress: boolean;\n hasChanges: boolean;\n errors: Map<string, string[]>;\n isValid: boolean;\n}\n\nexport interface FormContext<TDraft, TOriginal> {\n formState: Store<FormState<TDraft>>;\n options: FormOptions<TDraft, TOriginal>;\n original: TOriginal | undefined;\n getField: <TPath extends string>(path: TPath) => Field<TDraft, TOriginal, TPath>;\n getDraft: () => TDraft;\n hasTriggeredValidations: () => boolean;\n saveScheduled: () => boolean;\n saveInProgress: () => boolean;\n hasChanges: () => boolean;\n getErrors: () => Map<string, string[]>;\n isValid: () => boolean;\n validate: () => boolean;\n reset: () => void;\n}\n\nexport interface FormInstance<TDraft, TOriginal>\n extends FormDerivedState<TDraft>,\n Pick<\n FormContext<TDraft, TOriginal>,\n 'options' | 'original' | 'getField' | 'validate' | 'reset'\n > {}\n\n/// /////////////////////////////////////////////////////////////////////////////\n// Implementation\n/// /////////////////////////////////////////////////////////////////////////////\n\nfunction FormContainer({\n form,\n ...formProps\n}: {\n form: Form<any, any>;\n onSubmit?: (\n event: FormEvent<HTMLFormElement>,\n form: FormInstance<any, any>,\n ) => void | Promise<void>;\n} & Omit<HTMLProps<HTMLFormElement>, 'form' | 'onSubmit'>) {\n const formInstance = form.useForm();\n const hasTriggeredValidations = form.useFormState((state) => state.hasTriggeredValidations);\n\n const formRef = useRef<HTMLFormElement>(null);\n\n function updateValidity(errors: Map<string, string[]>, buttonElement?: HTMLButtonElement) {\n const formElement = formRef.current;\n if (!formElement) {\n return;\n }\n\n const localizedErrors = new Map(\n [...errors.entries()].map(\n ([field, errors]) =>\n [\n field,\n errors.map((error) => formInstance.options.localizeError?.(error, field) ?? error),\n ] as const,\n ),\n );\n\n for (const element of Array.from(formElement.elements)) {\n if ('name' in element && 'setCustomValidity' in element) {\n (element as HTMLObjectElement).setCustomValidity(\n localizedErrors.get((element as HTMLObjectElement).name)?.join('\\n') ?? '',\n );\n }\n }\n\n if (buttonElement && 'setCustomValidity' in buttonElement) {\n const errorString = [...errors.values()].flat().join('\\n');\n\n buttonElement.setCustomValidity(errorString);\n }\n }\n\n useEffect(() => {\n return formInstance.formState\n .map(() => formInstance.getErrors())\n .subscribe((errors) => updateValidity(errors));\n }, []);\n\n return (\n <form\n ref={formRef}\n noValidate\n {...formProps}\n className={[\n formProps.className,\n hasTriggeredValidations ? (formInstance.options.validatedClass ?? 'validated') : undefined,\n ]\n .filter(Boolean)\n .join(' ')}\n onSubmit={async (event) => {\n if (formInstance.saveInProgress()) {\n return;\n }\n\n try {\n formInstance.formState.set('saveInProgress', true);\n event.preventDefault();\n\n const formElement = event.currentTarget;\n const buttonElement =\n event.nativeEvent instanceof SubmitEvent &&\n event.nativeEvent.submitter instanceof HTMLButtonElement\n ? event.nativeEvent.submitter\n : undefined;\n\n updateValidity(formInstance.getErrors(), buttonElement);\n\n formElement.reportValidity();\n\n const isValid = formInstance.validate();\n if (isValid) {\n await formProps.onSubmit?.(event, {\n ...formInstance,\n ...getDerivedState(formInstance),\n });\n }\n } finally {\n formInstance.formState.set('saveInProgress', false);\n }\n }}\n />\n );\n}\n\nfunction getField<TDraft, TOriginal extends TDraft, TPath extends string>(\n form: FormContext<TDraft, TOriginal>,\n path: TPath,\n): Field<TDraft, TOriginal, TPath> {\n const field = {\n get originalValue() {\n return form.original !== undefined ? get(form.original as any, path as any) : undefined;\n },\n\n get value() {\n const draft = form.getDraft();\n return get(draft ?? form.original ?? form.options.defaultValue, path as any);\n },\n\n setValue(update: Update<Value<TDraft, TPath>>) {\n form.formState.set('draft', (draft = form.original ?? form.options.defaultValue) => {\n if (update instanceof Function) {\n update = update(get(draft, path as any) as Value<TDraft, TPath>);\n }\n\n return set(draft, path as any, update as any);\n });\n },\n\n get hasChange() {\n return !deepEqual(this.originalValue, this.value, { undefinedEqualsAbsent: true });\n },\n\n get errors() {\n const errors = form.getErrors();\n return errors.get(path) ?? [];\n },\n\n get names(): any {\n const { value } = this;\n\n if (Array.isArray(value)) {\n return value.map((_, index) => join(path, String(index)));\n }\n\n if (isObject(value)) {\n return Object.keys(value).map((key) => join(path, key));\n }\n\n return [];\n },\n\n add(...args: any[]) {\n this.setValue((value): any => {\n if (!value) {\n throw new Error(`Cannot add element to ${JSON.stringify(value)}`);\n }\n\n if (Array.isArray(value)) {\n return [...(value ?? []), args[0]];\n }\n\n if (isObject(value)) {\n return {\n ...value,\n [args[0]]: args[1],\n };\n }\n\n throw new Error(`Cannot add element to ${JSON.stringify(value)}`);\n });\n },\n\n remove(key: string | number) {\n this.setValue((value): any => {\n if (!value) {\n throw new Error(`Cannot remove element from ${JSON.stringify(value)}`);\n }\n\n if (Array.isArray(value)) {\n return value.filter((_, index) => index !== Number(key));\n }\n\n if (isObject(value)) {\n const { [key]: _, ...rest } = value as Record<string | number, unknown>;\n return rest;\n }\n\n throw new Error(`Cannot remove element from ${JSON.stringify(value)}`);\n });\n },\n };\n\n return field as any;\n}\n\nfunction getErrors<TDraft, TOriginal>(\n draft: TDraft,\n original: TOriginal | undefined,\n validations: FormOptions<TDraft, TOriginal>['validations'],\n) {\n const errors = new Map<string, string[]>();\n\n for (const [path, block] of Object.entries(validations ?? {})) {\n for (const [validationName, validate] of Object.entries(\n block as Record<string, Validation<any, any, any>>,\n )) {\n let matched = false;\n\n for (const [field, value] of Object.entries(getWildCardMatches(draft, path))) {\n matched = true;\n if (!validate(value, { draft, original, field })) {\n const fieldErrors = errors.get(field) ?? [];\n fieldErrors.push(validationName);\n errors.set(field, fieldErrors);\n }\n }\n\n if (!matched && !path.includes('*')) {\n if (!validate(undefined, { draft, original, field: path })) {\n const fieldErrors = errors.get(path) ?? [];\n fieldErrors.push(validationName);\n errors.set(path, fieldErrors);\n }\n }\n }\n }\n\n return errors;\n}\n\nexport function getDerivedState<TDraft>(\n instance: FormContext<TDraft, any>,\n): FormDerivedState<TDraft> {\n return {\n draft: instance.getDraft(),\n hasTriggeredValidations: instance.hasTriggeredValidations(),\n saveScheduled: instance.saveScheduled(),\n saveInProgress: instance.saveInProgress(),\n hasChanges: instance.hasChanges(),\n errors: instance.getErrors(),\n isValid: instance.isValid(),\n };\n}\n\nexport class Form<TDraft, TOriginal extends TDraft = TDraft> {\n context: Context<FormContext<TDraft, TOriginal> | null> = createContext<FormContext<\n TDraft,\n TOriginal\n > | null>(null);\n\n constructor(public readonly options: FormOptions<TDraft, TOriginal>) {\n autobind(Form);\n }\n\n useForm(): FormContext<TDraft, TOriginal> {\n const context = useContext(this.context);\n\n if (!context) {\n throw new Error('Form context not found');\n }\n\n return context;\n }\n\n useFormState<S>(\n selector: (state: FormInstance<TDraft, TOriginal>) => S,\n useStoreOptions?: UseStoreOptions<S>,\n ): S {\n const form = this.useForm();\n\n return useStore(\n form.formState,\n () =>\n selector({\n ...form,\n ...getDerivedState(form),\n }),\n\n useStoreOptions,\n );\n }\n\n useField<TPath extends string>(\n path: TPath,\n useStoreOptions?: UseStoreOptions<any>,\n ): Field<TDraft, TOriginal, TPath> {\n const form = this.useForm();\n this.useFormState((form) => [form.getField(path).value, form.original], useStoreOptions);\n return form.getField(path);\n }\n\n // ///////////////////////////////////////////////////////////////////////////\n // React Components\n // ///////////////////////////////////////////////////////////////////////////\n\n Form({\n original,\n defaultValue,\n validations,\n localizeError,\n autoSave,\n transform,\n validatedClass,\n ...formProps\n }: {\n original?: TOriginal;\n onSubmit?: (event: FormEvent<HTMLFormElement>, form: FormInstance<TDraft, TOriginal>) => void;\n } & Partial<FormOptions<TDraft, TOriginal>> &\n Omit<HTMLProps<HTMLFormElement>, 'defaultValue' | 'autoSave' | 'onSubmit'>): React.JSX.Element {\n const options: FormOptions<TDraft, TOriginal> = {\n defaultValue: { ...this.options.defaultValue, ...defaultValue },\n validations: { ...this.options.validations, ...validations } as Validations<\n TDraft,\n TOriginal\n >,\n localizeError: localizeError ?? this.options.localizeError,\n autoSave: autoSave ?? this.options.autoSave,\n transform: transform ?? this.options.transform,\n validatedClass: validatedClass ?? this.options.validatedClass,\n };\n\n const formState = useMemo(() => {\n return createStore<FormState<TDraft>>({\n draft: undefined,\n hasTriggeredValidations: false,\n saveScheduled: false,\n saveInProgress: false,\n });\n }, []);\n\n let lastDraft: TDraft | undefined;\n const cache = new Map<string, unknown>();\n function lazy<T>(key: string, fn: () => T): T {\n if (lastDraft !== formState.get().draft) {\n cache.clear();\n lastDraft = formState.get().draft;\n }\n\n let value = cache.get(key);\n if (!cache.has(key)) {\n value = fn();\n cache.set(key, value);\n }\n\n return value as T;\n }\n\n const context: FormContext<TDraft, TOriginal> = {\n formState,\n options,\n original,\n\n getField() {\n throw new Error('Not implemented');\n },\n\n getDraft() {\n return formState.get().draft ?? original ?? options.defaultValue;\n },\n\n hasTriggeredValidations() {\n return formState.get().hasTriggeredValidations;\n },\n\n saveScheduled() {\n return formState.get().saveScheduled;\n },\n\n saveInProgress() {\n return formState.get().saveInProgress;\n },\n\n hasChanges() {\n return lazy(\n 'hasChanges',\n () =>\n !deepEqual(this.getDraft(), original ?? options.defaultValue, {\n undefinedEqualsAbsent: true,\n }),\n );\n },\n\n getErrors() {\n return lazy('getErrors', () => getErrors(this.getDraft(), original, options.validations));\n },\n\n isValid() {\n return lazy('isValid', () => this.getErrors().size === 0);\n },\n\n validate() {\n formState.set('hasTriggeredValidations', true);\n return this.isValid();\n },\n\n reset() {\n formState.set('draft', undefined);\n formState.set('hasTriggeredValidations', false);\n },\n };\n\n context.getField = (path) => lazy(path, () => getField(context, path));\n\n // useEffect(() => {\n // const handles = options.transform?.map(({ trigger, update }) => {\n // const draft = derivedState.map('draft');\n // const triggerStore = trigger ? draft.map(trigger as any) : draft;\n\n // return triggerStore.subscribe(() => {\n // const value = trigger ? get(draft.get(), trigger as any) : draft.get();\n // const result = update(value as any, draft);\n\n // if (result !== undefined) {\n // draft.set(result);\n // }\n // });\n // });\n\n // return () => {\n // handles?.forEach((handle) => handle());\n // };\n // }, [original,options.transform]);\n\n useFormAutosave(context);\n\n return (\n <this.context.Provider value={context}>\n <FormContainer {...formProps} form={this} />\n </this.context.Provider>\n );\n }\n\n FormState<S>({\n selector,\n children,\n }: {\n selector: (form: FormInstance<TDraft, TOriginal>) => S;\n children: (selectedState: S) => ReactNode;\n }): React.JSX.Element {\n const selectedState = this.useFormState(selector);\n return <>{children(selectedState)}</>;\n }\n\n Field<const TPath extends string>(\n props: FormFieldPropsWithRender<TDraft, TOriginal, TPath>,\n ): React.JSX.Element;\n\n Field<const TPath extends string, const TComponent extends FormFieldComponent = 'input'>(\n props: FormFieldPropsWithComponent<TDraft, TOriginal, TPath, TComponent>,\n ): React.JSX.Element;\n\n Field(props: any): React.JSX.Element {\n return Reflect.apply(FormField, this, [{ component: 'input', ...props }]);\n }\n\n ForEach<const TPath extends string>(props: FormForEachProps<TDraft, TPath>): React.JSX.Element {\n return Reflect.apply(FormForEach, this, [props]);\n }\n\n withForm<TProps extends Record<string, unknown>>(\n Component: React.ComponentType<TProps>,\n formProps?: Parameters<this['Form']>[0],\n ): FunctionComponent<TProps> {\n const { Form } = this;\n return function FormWrapper(props: TProps) {\n return (\n <Form {...formProps}>\n <Component {...props} />\n </Form>\n );\n };\n }\n}\n\nexport function createForm<TDraft, TOriginal extends TDraft = TDraft>(\n options: FormOptions<TDraft, TOriginal>,\n): Form<TDraft, TOriginal> {\n return new Form(options);\n}\n","import React, { createContext, useContext, type Context, type ReactNode } from 'react';\n\nexport type Location = string | { pathname: string; search: string; hash: string };\n\nexport interface UrlContextType {\n location: Location;\n navigate: (navigate: (from: Location) => string) => void;\n}\n\nexport type UrlContextProviderProps = { children?: ReactNode } & (\n | { location: UrlContextType['location'] }\n | { locationHook: () => UrlContextType['location'] }\n) &\n ({ navigate: UrlContextType['navigate'] } | { navigateHook: () => UrlContextType['navigate'] });\n\nexport const UrlContext: Context<UrlContextType | undefined> = createContext<\n UrlContextType | undefined\n>(undefined);\n\nexport function UrlProvider({ children, ...props }: UrlContextProviderProps): React.JSX.Element {\n const location = 'location' in props ? props.location : props.locationHook();\n const navigate = 'navigate' in props ? props.navigate : props.navigateHook();\n\n return <UrlContext.Provider value={{ location, navigate }}>{children}</UrlContext.Provider>;\n}\n\nexport function useUrlContext(): UrlContextType {\n const context = useContext(UrlContext);\n if (!context) {\n throw new Error('useUrlContext must be used within a UrlContextProvider');\n }\n return context;\n}\n","import { fromExtendedJsonString, toExtendedJsonString } from '@lib/extendedJson';\nimport type { Location } from '@react/url/urlContext';\n\nexport function defaultDeserializer<T>(value: string): T {\n if (value === undefined) {\n return undefined as T;\n }\n\n try {\n return fromExtendedJsonString(value) as T;\n } catch {\n return undefined as T;\n }\n}\n\nexport function defaultSerializer<T>(value: T): string {\n return toExtendedJsonString(value);\n}\n\nexport function parseLocation(location: Location): URL {\n if (typeof location !== 'string') {\n location = `${location.pathname}${location.search}${location.hash}`;\n }\n\n return new URL(location, window.location.origin);\n}\n\nexport function createStorageKey(id: string, key: string) {\n return `cross-state:url:${id}:${key}`;\n}\n","import { defaultDeserializer, defaultSerializer } from '@react/url/urlHelpers';\n\nexport interface UrlOptions<T> {\n key: string;\n type?: 'search' | 'hash';\n serialize?: (value: T) => string;\n deserialize?: (value: string) => T;\n defaultValue: T;\n writeDefaultValue?: boolean;\n onCommit?: (value: T) => void;\n persist?: { id: string } | null;\n}\n\nexport interface UrlOptionsWithoutDefaults<T>\n extends Omit<UrlOptions<T | undefined>, 'defaultValue'> {\n defaultValue?: T | undefined;\n}\n\nexport function createUrlOptions<T>(options: UrlOptions<T>): Required<UrlOptions<T>>;\nexport function createUrlOptions<T>(\n options: UrlOptionsWithoutDefaults<T>,\n): Required<UrlOptions<T | undefined>>;\nexport function createUrlOptions<T>({\n key,\n type = 'hash',\n serialize = defaultSerializer,\n deserialize = defaultDeserializer,\n defaultValue = undefined as T,\n writeDefaultValue = false,\n onCommit = () => undefined,\n persist = null,\n}: UrlOptionsWithoutDefaults<T>): Required<UrlOptionsWithoutDefaults<T>> {\n return {\n key,\n type,\n serialize,\n deserialize,\n defaultValue,\n writeDefaultValue,\n onCommit,\n persist,\n };\n}\n","import type { Update, UpdateFunction } from '@core';\nimport { useUrlContext } from '@react/url/urlContext';\nimport { createStorageKey, parseLocation } from '@react/url/urlHelpers';\nimport {\n createUrlOptions,\n type UrlOptions,\n type UrlOptionsWithoutDefaults,\n} from '@react/url/urlOptions';\nimport type { UrlStore } from '@react/url/urlStore';\nimport { useEffect, useMemo } from 'react';\n\nexport function useUrlParam<T>(store: UrlStore<T>): [T, update: UpdateFunction<T>];\nexport function useUrlParam<T>(options: UrlOptions<T>): [T, update: UpdateFunction<T>];\nexport function useUrlParam<T>(\n options: UrlOptionsWithoutDefaults<T>,\n): [T | undefined, update: UpdateFunction<T | undefined>];\nexport function useUrlParam<T>(\n input: UrlStore<T> | UrlOptionsWithoutDefaults<T>,\n): [T, update: UpdateFunction<T>] {\n const { key, type, serialize, deserialize, defaultValue, writeDefaultValue, onCommit, persist } =\n createUrlOptions('options' in input ? input.options : (input as UrlOptions<T>));\n\n const { location, navigate } = useUrlContext();\n const url = parseLocation(location);\n const params = new URLSearchParams(url[type].slice(1));\n const urlValue = params.get(key);\n\n const storageKey = persist && createStorageKey(persist.id, key);\n const storageValue = storageKey ? localStorage.getItem(storageKey) : null;\n\n const value = useMemo(\n () =>\n urlValue !== null\n ? deserialize(urlValue)\n : storageValue !== null\n ? deserialize(storageValue)\n : defaultValue,\n [urlValue],\n );\n\n function commit(value: T) {\n const serializedValue = serialize(value);\n\n navigate((location) => {\n const url = parseLocation(location);\n const params = new URLSearchParams(url[type].slice(1));\n\n if (!writeDefaultValue && serializedValue === serialize(defaultValue)) {\n params.delete(key);\n } else {\n params.set(key, serializedValue);\n }\n\n url[type] = params.toString();\n return url.toString().replace(window.location.origin, '');\n });\n\n if (storageKey) {\n localStorage.setItem(storageKey, serializedValue);\n }\n\n onCommit?.(value);\n }\n\n function update(update: Update<T>) {\n if (update instanceof Function) {\n update = update(value);\n }\n\n commit(update);\n }\n\n useEffect(() => {\n if (urlValue !== null) {\n commit(deserialize(urlValue));\n }\n }, [urlValue]);\n\n useEffect(() => {\n if (urlValue === null && storageValue !== null) {\n commit(deserialize(storageValue));\n } else if (urlValue === null && writeDefaultValue) {\n commit(defaultValue);\n }\n }, []);\n\n return [value, update];\n}\n","import type { UpdateFunction } from '@core';\nimport type { Location } from '@react/url/urlContext';\nimport { parseLocation } from '@react/url/urlHelpers';\nimport {\n createUrlOptions,\n type UrlOptions,\n type UrlOptionsWithoutDefaults,\n} from '@react/url/urlOptions';\nimport { useUrlParam } from '@react/url/useUrlParam';\n\nexport class UrlStore<T> {\n constructor(public readonly options: Required<UrlOptions<T>>) {}\n\n useStore(): T {\n return useUrlParam(this)[0];\n }\n\n useProp(): [T, update: UpdateFunction<T>] {\n return useUrlParam(this);\n }\n\n parse(location: Location): T | undefined {\n const url = parseLocation(location);\n const params = new URLSearchParams(url[this.options.type].slice(1));\n const urlValue = params.get(this.options.key);\n return urlValue !== null ? this.options.deserialize(urlValue) : undefined;\n }\n}\nexport function createUrlStore<T>(options: UrlOptions<T>): UrlStore<T>;\nexport function createUrlStore<T>(options: UrlOptionsWithoutDefaults<T>): UrlStore<T | undefined>;\nexport function createUrlStore<T>(options: UrlOptionsWithoutDefaults<T>) {\n return new UrlStore(createUrlOptions(options));\n}\n","import { startTransition, useEffect, useMemo, useRef, useState } from 'react';\nimport { type Duration } from '@core';\nimport { debounce } from '@lib/debounce';\nimport { simpleHash } from '@lib/hash';\nimport { throttle } from '@lib/throttle';\n\nexport interface UseDecoupledStateOptions<T> {\n debounce?: Duration;\n throttle?: Duration;\n onCommit?: (value: T) => void;\n}\n\nexport function useDecoupledState<T>(\n value: T,\n onChange: (value: T) => void,\n options: UseDecoupledStateOptions<T> = {},\n): [state: T, setState: (value: T) => void] {\n const [dirty, setDirty] = useState<{ v: T }>();\n const ref = useRef({ onChange, onCommit: options.onCommit });\n\n useEffect(() => {\n ref.current = { onChange, onCommit: options.onCommit };\n }, [onChange]);\n\n const update = useMemo(() => {\n const { onChange, onCommit } = ref.current;\n\n const update = (value: T) => {\n onChange(value);\n setDirty(undefined);\n onCommit?.(value);\n };\n\n let delayedUpdate: (value: T) => void;\n\n if (options.debounce) {\n delayedUpdate = debounce(update, options.debounce);\n } else if (options.throttle) {\n delayedUpdate = throttle(update, options.throttle);\n } else {\n delayedUpdate = (value) => startTransition(() => update(value));\n }\n\n return (value: T) => {\n setDirty({ v: value });\n delayedUpdate(value);\n };\n }, [simpleHash([options.debounce, options.throttle])]);\n\n return [dirty ? dirty.v : value, update];\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.cjs","names":["matches: Record<KeyType, any>","castArrayPath","isObject","value","form","name","Fragment","calcDuration","queue","debounce","options","deepEqual","errors","get","set","deepEqual","join","isObject","options: FormOptions<TDraft, TOriginal>","useStore","form","createStore","lastDraft: TDraft | undefined","context: FormContext<TDraft, TOriginal>","transform","Form","UrlContext: Context<UrlContextType | undefined>","fromExtendedJsonString","toExtendedJsonString","value","url","location","params","update","options: Required<UrlOptions<T>>","update","value","delayedUpdate: (value: T) => void","debounce","throttle","simpleHash"],"sources":["../../src/react/form/customInput.tsx","../../src/lib/wildcardMatch.ts","../../src/react/form/formField.tsx","../../src/react/form/formForEach.tsx","../../src/react/form/useFormAutosave.ts","../../src/react/form/form.tsx","../../src/react/url/urlContext.tsx","../../src/react/url/urlHelpers.ts","../../src/react/url/urlOptions.ts","../../src/react/url/useUrlParam.ts","../../src/react/url/urlStore.ts","../../src/react/useDecoupledState.ts"],"sourcesContent":["import type { ReactNode } from 'react';\n\nexport interface CustomInputProps extends React.HTMLAttributes<HTMLDivElement> {\n name: string;\n children?: ReactNode;\n}\n\nexport function CustomInput({ name, children, ...props }: CustomInputProps): React.JSX.Element {\n return (\n <div\n {...props}\n style={{\n position: 'relative',\n ...props.style,\n }}\n >\n {children}\n\n <input\n name={name}\n style={{\n position: 'absolute',\n top: 0,\n left: 0,\n opacity: 0,\n width: '100%',\n height: '100%',\n pointerEvents: 'none',\n }}\n />\n </div>\n );\n}\n","import { isObject } from '@lib/helpers';\nimport { type KeyType } from './path';\nimport { castArrayPath } from './propAccess';\n\nexport function wildcardMatch(s: KeyType[] | string, w: KeyType[] | string): boolean {\n if (typeof s === 'string') {\n s = castArrayPath(s);\n }\n\n if (typeof w === 'string') {\n w = castArrayPath(w);\n }\n\n return s.length === w.length && s.every((s, i) => w[i] === '*' || s === w[i]);\n}\n\nexport function getWildCardMatches(\n object: any,\n path: [KeyType, ...KeyType[]] | string,\n): Record<KeyType, any> {\n const matches: Record<KeyType, any> = {};\n const [first, second, ...rest] = castArrayPath(path);\n\n if (first === undefined) {\n throw new Error('Path is empty');\n }\n\n if (!Array.isArray(object) && !isObject(object)) {\n object = {};\n }\n\n for (const [key, value] of first !== '*' ? [[first, object[first]]] : Object.entries(object)) {\n if (first !== '*' && first !== key) {\n continue;\n }\n\n if (second === undefined) {\n matches[key] = value;\n continue;\n }\n\n for (const [subKey, subValue] of Object.entries(getWildCardMatches(value, [second, ...rest]))) {\n matches[`${key}.${subKey}`] = subValue;\n }\n }\n\n return matches;\n}\n","import { type PathAsString, type Value } from '@lib/path';\nimport {\n createElement,\n useEffect,\n useState,\n type Component,\n type ComponentPropsWithoutRef,\n type ReactNode,\n} from 'react';\nimport {\n getDerivedState,\n type Field,\n type Form,\n type FormContext,\n type FormInstance,\n} from './form';\n\nexport interface FormFieldComponentProps<TValue, TPath> {\n name: TPath;\n value: TValue;\n onChange: (event: { target: { value: TValue } } | TValue | undefined, ...args: any[]) => void;\n onBlur: (...args: any[]) => void;\n}\n\nexport type FormFieldInfos<TDraft, TOriginal, TPath extends string> = Field<\n TDraft,\n TOriginal,\n TPath\n> & {\n hasTriggeredValidations: boolean;\n};\n\ntype NativeInputType = 'input' | 'select' | 'textarea';\n\ntype PartialComponentType<P> =\n | (new (props: P, context?: any) => Component<P, any>)\n | ((props: P, context?: any) => ReactNode);\n\nexport type FormFieldComponent = NativeInputType | PartialComponentType<any>;\n\ntype FieldValue<T extends FormFieldComponent> = ComponentPropsWithoutRef<T>['value'];\n\ntype FieldChangeValue<T extends FormFieldComponent> =\n ComponentPropsWithoutRef<T> extends {\n onChange?: (update: infer U) => void;\n }\n ? U extends { target: { value: infer V } }\n ? V\n : U\n : never;\n\ntype MakeOptional<T, Keys extends string> = Omit<T, Keys> & Partial<Pick<T, Keys & keyof T>>;\n\nexport type FormFieldProps<TPath, TDraft> = {\n name: TPath & PathAsString<TDraft>;\n commitOnBlur?: boolean;\n commitDebounce?: number;\n};\n\nexport type FormFieldPropsWithRender<TDraft, TOriginal, TPath extends string> = FormFieldProps<\n TPath,\n TDraft\n> &\n NoInfer<{\n component?: undefined;\n render: (\n props: FormFieldComponentProps<Value<TDraft, TPath>, TPath>,\n info: FormFieldInfos<TDraft, TOriginal, TPath>,\n form: FormContext<TDraft, TOriginal>,\n ) => ReactNode;\n inputFilter?: undefined;\n defaultValue?: undefined;\n serialize?: undefined;\n deserialize?: undefined;\n onChange?: undefined;\n onBlur?: undefined;\n }>;\n\ntype Serialize<TDraft, TOriginal, TPath, TComponent extends FormFieldComponent> = (\n value: Value<TDraft, TPath>,\n formState: FormInstance<TDraft, TOriginal>,\n) => FieldValue<TComponent>;\n\ntype Deserialize<TDraft, TOriginal, TPath, TComponent extends FormFieldComponent> = (\n value: FieldChangeValue<TComponent>,\n formState: FormInstance<TDraft, TOriginal>,\n) => Value<TDraft, TPath>;\n\nexport type FormFieldPropsWithComponent<\n TDraft,\n TOriginal,\n TPath extends string,\n TComponent extends FormFieldComponent,\n> = FormFieldProps<TPath, TDraft> & {\n component?: TComponent;\n render?: undefined;\n} & NoInfer<\n {\n inputFilter?: (value: FieldChangeValue<TComponent>) => boolean;\n } & MakeOptional<\n Omit<ComponentPropsWithoutRef<TComponent>, 'id' | 'name' | 'value' | 'defaultValue'>,\n 'onChange' | 'onBlur'\n > &\n (Value<TDraft, TPath> extends Exclude<FieldValue<TComponent>, undefined>\n ? {\n defaultValue?: FieldValue<TComponent>;\n serialize?: Serialize<TDraft, TOriginal, TPath, TComponent>;\n }\n : Value<TDraft, TPath> extends FieldValue<TComponent>\n ?\n | {\n defaultValue: FieldValue<TComponent>;\n serialize?: Serialize<TDraft, TOriginal, TPath, TComponent>;\n }\n | {\n defaultValue?: FieldValue<TComponent>;\n serialize: Serialize<TDraft, TOriginal, TPath, TComponent>;\n }\n : {\n serialize: Serialize<TDraft, TOriginal, TPath, TComponent>;\n }) &\n (FieldChangeValue<TComponent> extends Value<TDraft, TPath>\n ? {\n deserialize?: Deserialize<TDraft, TOriginal, TPath, TComponent>;\n }\n : {\n deserialize: Deserialize<TDraft, TOriginal, TPath, TComponent>;\n })\n >;\n\nexport function FormField<\n TDraft,\n TOriginal,\n TPath extends string,\n TComponent extends FormFieldComponent,\n>(\n this: Form<TDraft, any>,\n {\n // id,\n name = '' as any,\n component,\n commitOnBlur,\n commitDebounce,\n render,\n inputFilter,\n defaultValue,\n serialize,\n deserialize = (x) => x as Value<TDraft, TPath>,\n onChange,\n onBlur,\n ...restProps\n }:\n | FormFieldPropsWithRender<TDraft, TOriginal, TPath>\n | FormFieldPropsWithComponent<TDraft, TOriginal, TPath, TComponent>,\n): React.JSX.Element | null {\n type T = FieldChangeValue<TComponent>;\n\n const form = this.useForm();\n const getFormState = () => ({ ...form, ...getDerivedState(form) });\n const [localValue, setLocalValue] = useState<T>();\n\n const value = this.useFormState((form) => {\n const value = form.getField(name as any).value;\n if (serialize) {\n return serialize(value as any, getFormState());\n }\n if (value !== undefined) {\n return value;\n }\n return defaultValue;\n });\n\n const setValue = (x: FieldChangeValue<TComponent>) =>\n form.getField(name as any).setValue(deserialize(x, getFormState()));\n\n const hasTriggeredValidations = this.useFormState((form) => form.hasTriggeredValidations);\n\n useEffect(() => {\n if (localValue === undefined || !commitDebounce) {\n return;\n }\n\n const timeout = setTimeout(() => {\n setValue(localValue);\n setLocalValue(undefined);\n }, commitDebounce);\n\n return () => clearTimeout(timeout);\n }, [localValue, commitDebounce]);\n\n const props = {\n name,\n value: localValue ?? value,\n onChange: (event: { target: { value: T } } | T, ...moreArgs: any[]) => {\n const value =\n typeof event === 'object' && event !== null && 'target' in event\n ? event.target.value\n : event;\n\n if (inputFilter && !inputFilter(value)) {\n return;\n }\n\n if (commitOnBlur || commitDebounce) {\n setLocalValue(value);\n } else {\n setValue(value);\n }\n\n onChange?.(event, ...moreArgs);\n },\n onBlur(...args: any[]) {\n if (localValue !== undefined) {\n setValue(localValue);\n setLocalValue(undefined);\n }\n\n onBlur?.(...args);\n },\n } as FormFieldComponentProps<Value<TDraft, TPath>, TPath>;\n\n if (render) {\n return (\n <>\n {render(props, { ...form.getField(name as any), hasTriggeredValidations } as any, form) ??\n null}\n </>\n );\n }\n\n if (component) {\n return createElement(component, { ...restProps, ...props });\n }\n\n return null;\n}\n","import { type GetKeys, type Join, type PathAsString, type Value } from '@lib/path';\nimport { Fragment, useCallback, type ReactNode } from 'react';\nimport { type FieldHelperMethods, type Form } from './form';\n\nexport type ElementName<TDraft, TPath extends string> = keyof {\n [Path in TPath as Join<Path, GetKeys<NonNullable<Value<TDraft, Path>>> & (string | number)>]: 1;\n};\n\nexport interface FormForEachProps<TDraft, TPath extends string> {\n name: TPath & PathAsString<TDraft>;\n renderElement?: (props: {\n name: ElementName<TDraft, TPath>;\n key: `${GetKeys<NonNullable<Value<TDraft, TPath>>> & (string | number)}`;\n index: number;\n remove: () => void;\n }) => ReactNode;\n children?: (\n props: {\n setValue: (\n value: Value<TDraft, TPath> | ((value: Value<TDraft, TPath>) => Value<TDraft, TPath>),\n ) => void;\n } & FieldHelperMethods<TDraft, TPath>,\n ) => ReactNode;\n}\n\nexport function FormForEach<TDraft, TPath extends string>(\n this: Form<TDraft, any>,\n { name, renderElement, children }: FormForEachProps<TDraft, TPath>,\n): React.JSX.Element {\n const form = this.useForm();\n\n const names = this.useFormState(() => {\n const field = form.getField(name as any) as any;\n return field.names as any[];\n });\n\n const add = useCallback(\n (...args: any[]) => {\n const field = form.getField(name as any) as any;\n field.add(...args);\n },\n [form],\n );\n\n const remove = useCallback(\n (key: any) => {\n const field = form.getField(name as any) as any;\n field.remove(key);\n },\n [form],\n );\n\n const setValue = useCallback(\n (value: Value<TDraft, TPath> | ((value: Value<TDraft, TPath>) => Value<TDraft, TPath>)) => {\n const field = form.getField(name as any) as any;\n field.setValue(value);\n },\n [form],\n );\n\n return (\n <>\n {renderElement &&\n names.map((name, index) => {\n const key = name.split('.').pop();\n\n return (\n <Fragment key={key}>\n {renderElement({\n name,\n key,\n index,\n remove: () => remove(key),\n })}\n </Fragment>\n );\n })}\n\n {children?.({\n names,\n add,\n remove,\n setValue,\n } as any)}\n </>\n );\n}\n","import type { Duration } from '@core';\nimport { calcDuration } from '@lib/calcDuration';\nimport { debounce } from '@lib/debounce';\nimport { deepEqual } from '@lib/equals';\nimport type { MaybePromise } from '@lib/maybePromise';\nimport { queue } from '@lib/queue';\nimport { useEffect, useMemo, useRef } from 'react';\nimport type { FormContext } from './form';\n\nexport interface FormAutosaveOptions<TDraft, TOriginal> {\n save: (draft: TDraft, form: FormContext<TDraft, TOriginal>) => MaybePromise<void>;\n debounce?: Duration;\n resetAfterSave?: boolean;\n}\n\nexport function useFormAutosave<TDraft, TOriginal extends TDraft>(\n form: FormContext<TDraft, TOriginal>,\n): void {\n const { formState, options, getDraft } = form;\n const debounceTime = calcDuration(options.autoSave?.debounce ?? 2_000);\n const latestRef = useRef({ options });\n const lastValue = useRef<TDraft | undefined>(undefined);\n const q = useMemo(() => queue(), []);\n\n const run = useMemo(\n () =>\n debounce(async () => {\n const { options } = latestRef.current;\n const save = options.autoSave?.save;\n const draft = getDraft();\n\n lastValue.current = draft;\n\n q.clear();\n\n q(async () => {\n try {\n formState.set('saveInProgress', true);\n await save?.(draft, form);\n\n if (q.size === 0 && options.autoSave?.resetAfterSave) {\n form.reset();\n }\n } finally {\n formState.set('saveInProgress', false);\n\n if (q.size === 0) {\n formState.set('saveScheduled', false);\n }\n }\n });\n }, debounceTime),\n [formState, debounceTime],\n );\n\n useEffect(() => {\n if (!options.autoSave?.save) {\n return;\n }\n\n return formState\n .map((state) => state.draft)\n .subscribe(\n () => {\n if (deepEqual(getDraft(), lastValue.current)) {\n return;\n }\n\n run();\n formState.set('saveScheduled', true);\n },\n { runNow: false },\n );\n }, [formState]);\n\n useEffect(() => {\n latestRef.current = { options };\n });\n}\n","import { createStore, type Store, type Update } from '@core';\nimport { autobind } from '@lib/autobind';\nimport { deepEqual } from '@lib/equals';\nimport { isObject } from '@lib/helpers';\nimport {\n type PathAsString,\n type Value,\n type WildcardPathAsString,\n type WildcardValue,\n} from '@lib/path';\nimport { get, join, set } from '@lib/propAccess';\nimport type { Object_ } from '@lib/typeHelpers';\nimport { getWildCardMatches } from '@lib/wildcardMatch';\nimport {\n createContext,\n useContext,\n useEffect,\n useMemo,\n useRef,\n type Context,\n type FormEvent,\n type FunctionComponent,\n type HTMLProps,\n type ReactNode,\n} from 'react';\nimport { useStore, type UseStoreOptions } from '../useStore';\nimport {\n FormField,\n type FormFieldComponent,\n type FormFieldPropsWithComponent,\n type FormFieldPropsWithRender,\n} from './formField';\nimport { FormForEach, type ElementName, type FormForEachProps } from './formForEach';\nimport { useFormAutosave, type FormAutosaveOptions } from './useFormAutosave';\n\n/// /////////////////////////////////////////////////////////////////////////////\n// Form types\n/// /////////////////////////////////////////////////////////////////////////////\n\nexport interface Transform<TDraft> {\n (value: TDraft, store: Store<TDraft>): void | TDraft;\n}\n\nexport interface FormOptions<TDraft, TOriginal> {\n defaultValue: TDraft;\n validations?: Validations<TDraft, TOriginal>;\n localizeError?: (error: string, field: string) => string | undefined;\n autoSave?: FormAutosaveOptions<TDraft, TOriginal>;\n transform?: Transform<TDraft>;\n validatedClass?: string;\n}\n\nexport type Validations<TDraft, TOriginal> = {\n [TPath in WildcardPathAsString<TDraft>]?: Record<string, Validation<TDraft, TOriginal, TPath>>;\n} & Record<string, Record<string, Validation<TDraft, TOriginal, any>>>;\n\nexport type Validation<TDraft, TOriginal, TPath> = (\n value: WildcardValue<TDraft, TPath>,\n context: {\n draft: TDraft;\n original: TOriginal;\n field: PathAsString<TDraft> | '';\n },\n) => boolean;\n\nexport type Field<TDraft, TOriginal, TPath extends string> = {\n originalValue: Value<TOriginal, TPath> | undefined;\n value: Value<TDraft, TPath>;\n setValue: (value: Update<Value<TDraft, TPath>>) => void;\n removeValue: () => void;\n hasChange: boolean;\n errors: string[];\n} & (Value<TDraft, TPath> extends Object_ ? FieldHelperMethods<TDraft, TPath> : {});\n\nexport type FieldHelperMethods<TDraft, TPath extends string> = {\n names: ElementName<TDraft, TPath>[];\n add: NonNullable<Value<TDraft, TPath>> extends readonly (infer T)[]\n ? (element: T) => void\n : NonNullable<Value<TDraft, TPath>> extends Record<infer K, infer V>\n ? (key: K, value: V) => void\n : never;\n remove: Value<TDraft, TPath> extends readonly any[]\n ? (index: number) => void\n : (key: string) => void;\n};\n\nexport interface FormState<TDraft> {\n draft: TDraft | undefined;\n hasTriggeredValidations: boolean;\n saveScheduled: boolean;\n saveInProgress: boolean;\n}\n\nexport interface FormDerivedState<TDraft> {\n draft: TDraft;\n hasTriggeredValidations: boolean;\n saveScheduled: boolean;\n saveInProgress: boolean;\n hasChanges: boolean;\n errors: Map<string, string[]>;\n isValid: boolean;\n}\n\nexport interface FormContext<TDraft, TOriginal> {\n formState: Store<FormState<TDraft>>;\n options: FormOptions<TDraft, TOriginal>;\n original: TOriginal | undefined;\n getField: <TPath extends string>(path: TPath) => Field<TDraft, TOriginal, TPath>;\n getDraft: () => TDraft;\n hasTriggeredValidations: () => boolean;\n saveScheduled: () => boolean;\n saveInProgress: () => boolean;\n hasChanges: () => boolean;\n getErrors: () => Map<string, string[]>;\n isValid: () => boolean;\n validate: () => boolean;\n reset: () => void;\n}\n\nexport interface FormInstance<TDraft, TOriginal>\n extends FormDerivedState<TDraft>,\n Pick<\n FormContext<TDraft, TOriginal>,\n 'options' | 'original' | 'getField' | 'validate' | 'reset'\n > {}\n\n/// /////////////////////////////////////////////////////////////////////////////\n// Implementation\n/// /////////////////////////////////////////////////////////////////////////////\n\nfunction FormContainer({\n form,\n ...formProps\n}: {\n form: Form<any, any>;\n onSubmit?: (\n event: FormEvent<HTMLFormElement>,\n form: FormInstance<any, any>,\n ) => void | Promise<void>;\n} & Omit<HTMLProps<HTMLFormElement>, 'form' | 'onSubmit'>) {\n const formInstance = form.useForm();\n const hasTriggeredValidations = form.useFormState((state) => state.hasTriggeredValidations);\n\n const formRef = useRef<HTMLFormElement>(null);\n\n function updateValidity(errors: Map<string, string[]>, buttonElement?: HTMLButtonElement) {\n const formElement = formRef.current;\n if (!formElement) {\n return;\n }\n\n const localizedErrors = new Map(\n [...errors.entries()].map(\n ([field, errors]) =>\n [\n field,\n errors.map((error) => formInstance.options.localizeError?.(error, field) ?? error),\n ] as const,\n ),\n );\n\n for (const element of Array.from(formElement.elements)) {\n if ('name' in element && 'setCustomValidity' in element) {\n (element as HTMLObjectElement).setCustomValidity(\n localizedErrors.get((element as HTMLObjectElement).name)?.join('\\n') ?? '',\n );\n }\n }\n\n if (buttonElement && 'setCustomValidity' in buttonElement) {\n const errorString = [...errors.values()].flat().join('\\n');\n\n buttonElement.setCustomValidity(errorString);\n }\n }\n\n useEffect(() => {\n return formInstance.formState\n .map(() => formInstance.getErrors())\n .subscribe((errors) => updateValidity(errors));\n }, []);\n\n return (\n <form\n ref={formRef}\n noValidate\n {...formProps}\n className={[\n formProps.className,\n hasTriggeredValidations ? (formInstance.options.validatedClass ?? 'validated') : undefined,\n ]\n .filter(Boolean)\n .join(' ')}\n onSubmit={async (event) => {\n if (formInstance.saveInProgress()) {\n return;\n }\n\n try {\n formInstance.formState.set('saveInProgress', true);\n event.preventDefault();\n\n const formElement = event.currentTarget;\n const buttonElement =\n event.nativeEvent instanceof SubmitEvent &&\n event.nativeEvent.submitter instanceof HTMLButtonElement\n ? event.nativeEvent.submitter\n : undefined;\n\n updateValidity(formInstance.getErrors(), buttonElement);\n\n formElement.reportValidity();\n\n const isValid = formInstance.validate();\n if (isValid) {\n await formProps.onSubmit?.(event, {\n ...formInstance,\n ...getDerivedState(formInstance),\n });\n }\n } finally {\n formInstance.formState.set('saveInProgress', false);\n }\n }}\n />\n );\n}\n\nfunction getField<TDraft, TOriginal extends TDraft, TPath extends string>(\n form: FormContext<TDraft, TOriginal>,\n path: TPath,\n): Field<TDraft, TOriginal, TPath> {\n const field = {\n get originalValue() {\n return form.original !== undefined ? get(form.original as any, path as any) : undefined;\n },\n\n get value() {\n const draft = form.getDraft();\n return get(draft ?? form.original ?? form.options.defaultValue, path as any);\n },\n\n setValue(update: Update<Value<TDraft, TPath>>) {\n form.formState.set('draft', (draft = form.original ?? form.options.defaultValue) => {\n if (update instanceof Function) {\n update = update(get(draft, path as any) as Value<TDraft, TPath>);\n }\n\n return set(draft, path as any, update as any);\n });\n },\n\n get hasChange() {\n return !deepEqual(this.originalValue, this.value, { undefinedEqualsAbsent: true });\n },\n\n get errors() {\n const errors = form.getErrors();\n return errors.get(path) ?? [];\n },\n\n get names(): any {\n const { value } = this;\n\n if (Array.isArray(value)) {\n return value.map((_, index) => join(path, String(index)));\n }\n\n if (isObject(value)) {\n return Object.keys(value).map((key) => join(path, key));\n }\n\n return [];\n },\n\n add(...args: any[]) {\n this.setValue((value): any => {\n if (!value) {\n throw new Error(`Cannot add element to ${JSON.stringify(value)}`);\n }\n\n if (Array.isArray(value)) {\n return [...(value ?? []), args[0]];\n }\n\n if (isObject(value)) {\n return {\n ...value,\n [args[0]]: args[1],\n };\n }\n\n throw new Error(`Cannot add element to ${JSON.stringify(value)}`);\n });\n },\n\n remove(key: string | number) {\n this.setValue((value): any => {\n if (!value) {\n throw new Error(`Cannot remove element from ${JSON.stringify(value)}`);\n }\n\n if (Array.isArray(value)) {\n return value.filter((_, index) => index !== Number(key));\n }\n\n if (isObject(value)) {\n const { [key]: _, ...rest } = value as Record<string | number, unknown>;\n return rest;\n }\n\n throw new Error(`Cannot remove element from ${JSON.stringify(value)}`);\n });\n },\n };\n\n return field as any;\n}\n\nfunction getErrors<TDraft, TOriginal>(\n draft: TDraft,\n original: TOriginal | undefined,\n validations: FormOptions<TDraft, TOriginal>['validations'],\n) {\n const errors = new Map<string, string[]>();\n\n for (const [path, block] of Object.entries(validations ?? {})) {\n for (const [validationName, validate] of Object.entries(\n block as Record<string, Validation<any, any, any>>,\n )) {\n let matched = false;\n\n for (const [field, value] of Object.entries(getWildCardMatches(draft, path))) {\n matched = true;\n if (!validate(value, { draft, original, field })) {\n const fieldErrors = errors.get(field) ?? [];\n fieldErrors.push(validationName);\n errors.set(field, fieldErrors);\n }\n }\n\n if (!matched && !path.includes('*')) {\n if (!validate(undefined, { draft, original, field: path })) {\n const fieldErrors = errors.get(path) ?? [];\n fieldErrors.push(validationName);\n errors.set(path, fieldErrors);\n }\n }\n }\n }\n\n return errors;\n}\n\nexport function getDerivedState<TDraft>(\n instance: FormContext<TDraft, any>,\n): FormDerivedState<TDraft> {\n return {\n draft: instance.getDraft(),\n hasTriggeredValidations: instance.hasTriggeredValidations(),\n saveScheduled: instance.saveScheduled(),\n saveInProgress: instance.saveInProgress(),\n hasChanges: instance.hasChanges(),\n errors: instance.getErrors(),\n isValid: instance.isValid(),\n };\n}\n\nexport class Form<TDraft, TOriginal extends TDraft = TDraft> {\n context: Context<FormContext<TDraft, TOriginal> | null> = createContext<FormContext<\n TDraft,\n TOriginal\n > | null>(null);\n\n constructor(public readonly options: FormOptions<TDraft, TOriginal>) {\n autobind(Form);\n }\n\n useForm(): FormContext<TDraft, TOriginal> {\n const context = useContext(this.context);\n\n if (!context) {\n throw new Error('Form context not found');\n }\n\n return context;\n }\n\n useFormState<S>(\n selector: (state: FormInstance<TDraft, TOriginal>) => S,\n useStoreOptions?: UseStoreOptions<S>,\n ): S {\n const form = this.useForm();\n\n return useStore(\n form.formState,\n () =>\n selector({\n ...form,\n ...getDerivedState(form),\n }),\n\n useStoreOptions,\n );\n }\n\n useField<TPath extends string>(\n path: TPath,\n useStoreOptions?: UseStoreOptions<any>,\n ): Field<TDraft, TOriginal, TPath> {\n const form = this.useForm();\n this.useFormState((form) => [form.getField(path).value, form.original], useStoreOptions);\n return form.getField(path);\n }\n\n // ///////////////////////////////////////////////////////////////////////////\n // React Components\n // ///////////////////////////////////////////////////////////////////////////\n\n Form({\n original,\n defaultValue,\n validations,\n localizeError,\n autoSave,\n transform,\n validatedClass,\n ...formProps\n }: {\n original?: TOriginal;\n onSubmit?: (event: FormEvent<HTMLFormElement>, form: FormInstance<TDraft, TOriginal>) => void;\n } & Partial<FormOptions<TDraft, TOriginal>> &\n Omit<HTMLProps<HTMLFormElement>, 'defaultValue' | 'autoSave' | 'onSubmit'>): React.JSX.Element {\n const options: FormOptions<TDraft, TOriginal> = {\n defaultValue: { ...this.options.defaultValue, ...defaultValue },\n validations: { ...this.options.validations, ...validations } as Validations<\n TDraft,\n TOriginal\n >,\n localizeError: localizeError ?? this.options.localizeError,\n autoSave: autoSave ?? this.options.autoSave,\n transform: transform ?? this.options.transform,\n validatedClass: validatedClass ?? this.options.validatedClass,\n };\n\n const formState = useMemo(() => {\n return createStore<FormState<TDraft>>({\n draft: undefined,\n hasTriggeredValidations: false,\n saveScheduled: false,\n saveInProgress: false,\n });\n }, []);\n\n let lastDraft: TDraft | undefined;\n const cache = new Map<string, unknown>();\n function lazy<T>(key: string, fn: () => T): T {\n if (lastDraft !== formState.get().draft) {\n cache.clear();\n lastDraft = formState.get().draft;\n }\n\n let value = cache.get(key);\n if (!cache.has(key)) {\n value = fn();\n cache.set(key, value);\n }\n\n return value as T;\n }\n\n const context: FormContext<TDraft, TOriginal> = {\n formState,\n options,\n original,\n\n getField() {\n throw new Error('Not implemented');\n },\n\n getDraft() {\n return formState.get().draft ?? original ?? options.defaultValue;\n },\n\n hasTriggeredValidations() {\n return formState.get().hasTriggeredValidations;\n },\n\n saveScheduled() {\n return formState.get().saveScheduled;\n },\n\n saveInProgress() {\n return formState.get().saveInProgress;\n },\n\n hasChanges() {\n return lazy(\n 'hasChanges',\n () =>\n !deepEqual(this.getDraft(), original ?? options.defaultValue, {\n undefinedEqualsAbsent: true,\n }),\n );\n },\n\n getErrors() {\n return lazy('getErrors', () => getErrors(this.getDraft(), original, options.validations));\n },\n\n isValid() {\n return lazy('isValid', () => this.getErrors().size === 0);\n },\n\n validate() {\n formState.set('hasTriggeredValidations', true);\n return this.isValid();\n },\n\n reset() {\n formState.set('draft', undefined);\n formState.set('hasTriggeredValidations', false);\n },\n };\n\n context.getField = (path) => lazy(path, () => getField(context, path));\n\n useEffect(() => {\n const transform = options.transform;\n if (!transform) {\n return;\n }\n\n const store = formState.map(\n (state) => state.draft ?? original ?? options.defaultValue,\n (draft) => (state) => ({ ...state, draft }),\n );\n\n return store.subscribe((value) => {\n const result = transform(value, store);\n\n if (result !== undefined && !deepEqual(result, value)) {\n store.set(result);\n }\n });\n }, [original, defaultValue, options.transform]);\n\n useFormAutosave(context);\n\n return (\n <this.context.Provider value={context}>\n <FormContainer {...formProps} form={this} />\n </this.context.Provider>\n );\n }\n\n FormState<S>({\n selector,\n children,\n }: {\n selector: (form: FormInstance<TDraft, TOriginal>) => S;\n children: (selectedState: S) => ReactNode;\n }): React.JSX.Element {\n const selectedState = this.useFormState(selector);\n return <>{children(selectedState)}</>;\n }\n\n Field<const TPath extends string>(\n props: FormFieldPropsWithRender<TDraft, TOriginal, TPath>,\n ): React.JSX.Element;\n\n Field<const TPath extends string, const TComponent extends FormFieldComponent = 'input'>(\n props: FormFieldPropsWithComponent<TDraft, TOriginal, TPath, TComponent>,\n ): React.JSX.Element;\n\n Field(props: any): React.JSX.Element {\n return Reflect.apply(FormField, this, [{ component: 'input', ...props }]);\n }\n\n ForEach<const TPath extends string>(props: FormForEachProps<TDraft, TPath>): React.JSX.Element {\n return Reflect.apply(FormForEach, this, [props]);\n }\n\n withForm<TProps extends Record<string, unknown>>(\n Component: React.ComponentType<TProps>,\n formProps?: Parameters<this['Form']>[0],\n ): FunctionComponent<TProps> {\n const { Form } = this;\n return function FormWrapper(props: TProps) {\n return (\n <Form {...formProps}>\n <Component {...props} />\n </Form>\n );\n };\n }\n}\n\nexport function createForm<TDraft, TOriginal extends TDraft = TDraft>(\n options: FormOptions<TDraft, TOriginal>,\n): Form<TDraft, TOriginal> {\n return new Form(options);\n}\n","import React, { createContext, useContext, type Context, type ReactNode } from 'react';\n\nexport type Location = string | { pathname: string; search: string; hash: string };\n\nexport interface UrlContextType {\n location: Location;\n navigate: (navigate: (from: Location) => string) => void;\n}\n\nexport type UrlContextProviderProps = { children?: ReactNode } & (\n | { location: UrlContextType['location'] }\n | { locationHook: () => UrlContextType['location'] }\n) &\n ({ navigate: UrlContextType['navigate'] } | { navigateHook: () => UrlContextType['navigate'] });\n\nexport const UrlContext: Context<UrlContextType | undefined> = createContext<\n UrlContextType | undefined\n>(undefined);\n\nexport function UrlProvider({ children, ...props }: UrlContextProviderProps): React.JSX.Element {\n const location = 'location' in props ? props.location : props.locationHook();\n const navigate = 'navigate' in props ? props.navigate : props.navigateHook();\n\n return <UrlContext.Provider value={{ location, navigate }}>{children}</UrlContext.Provider>;\n}\n\nexport function useUrlContext(): UrlContextType {\n const context = useContext(UrlContext);\n if (!context) {\n throw new Error('useUrlContext must be used within a UrlContextProvider');\n }\n return context;\n}\n","import { fromExtendedJsonString, toExtendedJsonString } from '@lib/extendedJson';\nimport type { Location } from '@react/url/urlContext';\n\nexport function defaultDeserializer<T>(value: string): T {\n if (value === undefined) {\n return undefined as T;\n }\n\n try {\n return fromExtendedJsonString(value) as T;\n } catch {\n return undefined as T;\n }\n}\n\nexport function defaultSerializer<T>(value: T): string {\n return toExtendedJsonString(value);\n}\n\nexport function parseLocation(location: Location): URL {\n if (typeof location !== 'string') {\n location = `${location.pathname}${location.search}${location.hash}`;\n }\n\n return new URL(location, window.location.origin);\n}\n\nexport function createStorageKey(id: string, key: string) {\n return `cross-state:url:${id}:${key}`;\n}\n","import { defaultDeserializer, defaultSerializer } from '@react/url/urlHelpers';\n\nexport interface UrlOptions<T> {\n key: string;\n type?: 'search' | 'hash';\n serialize?: (value: T) => string;\n deserialize?: (value: string) => T;\n defaultValue: T;\n writeDefaultValue?: boolean;\n onCommit?: (value: T) => void;\n persist?: { id: string } | null;\n}\n\nexport interface UrlOptionsWithoutDefaults<T>\n extends Omit<UrlOptions<T | undefined>, 'defaultValue'> {\n defaultValue?: T | undefined;\n}\n\nexport function createUrlOptions<T>(options: UrlOptions<T>): Required<UrlOptions<T>>;\nexport function createUrlOptions<T>(\n options: UrlOptionsWithoutDefaults<T>,\n): Required<UrlOptions<T | undefined>>;\nexport function createUrlOptions<T>({\n key,\n type = 'hash',\n serialize = defaultSerializer,\n deserialize = defaultDeserializer,\n defaultValue = undefined as T,\n writeDefaultValue = false,\n onCommit = () => undefined,\n persist = null,\n}: UrlOptionsWithoutDefaults<T>): Required<UrlOptionsWithoutDefaults<T>> {\n return {\n key,\n type,\n serialize,\n deserialize,\n defaultValue,\n writeDefaultValue,\n onCommit,\n persist,\n };\n}\n","import type { Update, UpdateFunction } from '@core';\nimport { useUrlContext } from '@react/url/urlContext';\nimport { createStorageKey, parseLocation } from '@react/url/urlHelpers';\nimport {\n createUrlOptions,\n type UrlOptions,\n type UrlOptionsWithoutDefaults,\n} from '@react/url/urlOptions';\nimport type { UrlStore } from '@react/url/urlStore';\nimport { useEffect, useMemo } from 'react';\n\nexport function useUrlParam<T>(store: UrlStore<T>): [T, update: UpdateFunction<T>];\nexport function useUrlParam<T>(options: UrlOptions<T>): [T, update: UpdateFunction<T>];\nexport function useUrlParam<T>(\n options: UrlOptionsWithoutDefaults<T>,\n): [T | undefined, update: UpdateFunction<T | undefined>];\nexport function useUrlParam<T>(\n input: UrlStore<T> | UrlOptionsWithoutDefaults<T>,\n): [T, update: UpdateFunction<T>] {\n const { key, type, serialize, deserialize, defaultValue, writeDefaultValue, onCommit, persist } =\n createUrlOptions('options' in input ? input.options : (input as UrlOptions<T>));\n\n const { location, navigate } = useUrlContext();\n const url = parseLocation(location);\n const params = new URLSearchParams(url[type].slice(1));\n const urlValue = params.get(key);\n\n const storageKey = persist && createStorageKey(persist.id, key);\n const storageValue = storageKey ? localStorage.getItem(storageKey) : null;\n\n const value = useMemo(\n () =>\n urlValue !== null\n ? deserialize(urlValue)\n : storageValue !== null\n ? deserialize(storageValue)\n : defaultValue,\n [urlValue],\n );\n\n function commit(value: T) {\n const serializedValue = serialize(value);\n\n navigate((location) => {\n const url = parseLocation(location);\n const params = new URLSearchParams(url[type].slice(1));\n\n if (!writeDefaultValue && serializedValue === serialize(defaultValue)) {\n params.delete(key);\n } else {\n params.set(key, serializedValue);\n }\n\n url[type] = params.toString();\n return url.toString().replace(window.location.origin, '');\n });\n\n if (storageKey) {\n localStorage.setItem(storageKey, serializedValue);\n }\n\n onCommit?.(value);\n }\n\n function update(update: Update<T>) {\n if (update instanceof Function) {\n update = update(value);\n }\n\n commit(update);\n }\n\n useEffect(() => {\n if (urlValue !== null) {\n commit(deserialize(urlValue));\n }\n }, [urlValue]);\n\n useEffect(() => {\n if (urlValue === null && storageValue !== null) {\n commit(deserialize(storageValue));\n } else if (urlValue === null && writeDefaultValue) {\n commit(defaultValue);\n }\n }, []);\n\n return [value, update];\n}\n","import type { UpdateFunction } from '@core';\nimport type { Location } from '@react/url/urlContext';\nimport { parseLocation } from '@react/url/urlHelpers';\nimport {\n createUrlOptions,\n type UrlOptions,\n type UrlOptionsWithoutDefaults,\n} from '@react/url/urlOptions';\nimport { useUrlParam } from '@react/url/useUrlParam';\n\nexport class UrlStore<T> {\n constructor(public readonly options: Required<UrlOptions<T>>) {}\n\n useStore(): T {\n return useUrlParam(this)[0];\n }\n\n useProp(): [T, update: UpdateFunction<T>] {\n return useUrlParam(this);\n }\n\n parse(location: Location): T | undefined {\n const url = parseLocation(location);\n const params = new URLSearchParams(url[this.options.type].slice(1));\n const urlValue = params.get(this.options.key);\n return urlValue !== null ? this.options.deserialize(urlValue) : undefined;\n }\n}\nexport function createUrlStore<T>(options: UrlOptions<T>): UrlStore<T>;\nexport function createUrlStore<T>(options: UrlOptionsWithoutDefaults<T>): UrlStore<T | undefined>;\nexport function createUrlStore<T>(options: UrlOptionsWithoutDefaults<T>) {\n return new UrlStore(createUrlOptions(options));\n}\n","import { startTransition, useEffect, useMemo, useRef, useState } from 'react';\nimport { type Duration } from '@core';\nimport { debounce } from '@lib/debounce';\nimport { simpleHash } from '@lib/hash';\nimport { throttle } from '@lib/throttle';\n\nexport interface UseDecoupledStateOptions<T> {\n debounce?: Duration;\n throttle?: Duration;\n onCommit?: (value: T) => void;\n}\n\nexport function useDecoupledState<T>(\n value: T,\n onChange: (value: T) => void,\n options: UseDecoupledStateOptions<T> = {},\n): [state: T, setState: (value: T) => void] {\n const [dirty, setDirty] = useState<{ v: T }>();\n const ref = useRef({ onChange, onCommit: options.onCommit });\n\n useEffect(() => {\n ref.current = { onChange, onCommit: options.onCommit };\n }, [onChange]);\n\n const update = useMemo(() => {\n const { onChange, onCommit } = ref.current;\n\n const update = (value: T) => {\n onChange(value);\n setDirty(undefined);\n onCommit?.(value);\n };\n\n let delayedUpdate: (value: T) => void;\n\n if (options.debounce) {\n delayedUpdate = debounce(update, options.debounce);\n } else if (options.throttle) {\n delayedUpdate = throttle(update, options.throttle);\n } else {\n delayedUpdate = (value) => startTransition(() => update(value));\n }\n\n return (value: T) => {\n setDirty({ v: value });\n delayedUpdate(value);\n };\n }, [simpleHash([options.debounce, options.throttle])]);\n\n return [dirty ? dirty.v : value, update];\n}\n"],"mappings":"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"}
@@ -102,19 +102,15 @@ interface FormAutosaveOptions<TDraft, TOriginal> {
102
102
  }
103
103
  //#endregion
104
104
  //#region src/react/form/form.d.ts
105
- type Transform<TDraft> = Path$1<TDraft> | "" extends infer TPath ? TPath extends TPath ? {
106
- update: (value: Value<TDraft, TPath>, store: Store<TDraft>) => void | TDraft;
107
- } & (TPath extends "" ? {
108
- trigger?: "";
109
- } : {
110
- trigger: TPath;
111
- }) : never : never;
105
+ interface Transform<TDraft> {
106
+ (value: TDraft, store: Store<TDraft>): void | TDraft;
107
+ }
112
108
  interface FormOptions<TDraft, TOriginal> {
113
109
  defaultValue: TDraft;
114
110
  validations?: Validations<TDraft, TOriginal>;
115
111
  localizeError?: (error: string, field: string) => string | undefined;
116
112
  autoSave?: FormAutosaveOptions<TDraft, TOriginal>;
117
- transform?: Transform<TDraft>[];
113
+ transform?: Transform<TDraft>;
118
114
  validatedClass?: string;
119
115
  }
120
116
  type Validations<TDraft, TOriginal> = { [TPath in WildcardPathAsString<TDraft>]?: Record<string, Validation<TDraft, TOriginal, TPath>> } & Record<string, Record<string, Validation<TDraft, TOriginal, any>>>;
@@ -102,19 +102,15 @@ interface FormAutosaveOptions<TDraft, TOriginal> {
102
102
  }
103
103
  //#endregion
104
104
  //#region src/react/form/form.d.ts
105
- type Transform<TDraft> = Path$1<TDraft> | "" extends infer TPath ? TPath extends TPath ? {
106
- update: (value: Value<TDraft, TPath>, store: Store<TDraft>) => void | TDraft;
107
- } & (TPath extends "" ? {
108
- trigger?: "";
109
- } : {
110
- trigger: TPath;
111
- }) : never : never;
105
+ interface Transform<TDraft> {
106
+ (value: TDraft, store: Store<TDraft>): void | TDraft;
107
+ }
112
108
  interface FormOptions<TDraft, TOriginal> {
113
109
  defaultValue: TDraft;
114
110
  validations?: Validations<TDraft, TOriginal>;
115
111
  localizeError?: (error: string, field: string) => string | undefined;
116
112
  autoSave?: FormAutosaveOptions<TDraft, TOriginal>;
117
- transform?: Transform<TDraft>[];
113
+ transform?: Transform<TDraft>;
118
114
  validatedClass?: string;
119
115
  }
120
116
  type Validations<TDraft, TOriginal> = { [TPath in WildcardPathAsString<TDraft>]?: Record<string, Validation<TDraft, TOriginal, TPath>> } & Record<string, Record<string, Validation<TDraft, TOriginal, any>>>;
@@ -411,6 +411,22 @@ var Form = class Form {
411
411
  }
412
412
  };
413
413
  context.getField = (path) => lazy(path, () => getField(context, path));
414
+ useEffect(() => {
415
+ const transform$1 = options.transform;
416
+ if (!transform$1) return;
417
+ const store = formState.map((state) => state.draft ?? original ?? options.defaultValue, (draft) => (state) => ({
418
+ ...state,
419
+ draft
420
+ }));
421
+ return store.subscribe((value) => {
422
+ const result = transform$1(value, store);
423
+ if (result !== void 0 && !deepEqual(result, value)) store.set(result);
424
+ });
425
+ }, [
426
+ original,
427
+ defaultValue,
428
+ options.transform
429
+ ]);
414
430
  useFormAutosave(context);
415
431
  return /* @__PURE__ */ jsx(this.context.Provider, {
416
432
  value: context,
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","names":["matches: Record<KeyType, any>","value","form","name","options","errors","options: FormOptions<TDraft, TOriginal>","form","lastDraft: TDraft | undefined","context: FormContext<TDraft, TOriginal>","Form","Component","UrlContext: Context<UrlContextType | undefined>","value","url","location","params","update","options: Required<UrlOptions<T>>","update","value","delayedUpdate: (value: T) => void"],"sources":["../../src/react/form/customInput.tsx","../../src/lib/wildcardMatch.ts","../../src/react/form/formField.tsx","../../src/react/form/formForEach.tsx","../../src/react/form/useFormAutosave.ts","../../src/react/form/form.tsx","../../src/react/url/urlContext.tsx","../../src/react/url/urlHelpers.ts","../../src/react/url/urlOptions.ts","../../src/react/url/useUrlParam.ts","../../src/react/url/urlStore.ts","../../src/react/useDecoupledState.ts"],"sourcesContent":["import type { ReactNode } from 'react';\n\nexport interface CustomInputProps extends React.HTMLAttributes<HTMLDivElement> {\n name: string;\n children?: ReactNode;\n}\n\nexport function CustomInput({ name, children, ...props }: CustomInputProps): React.JSX.Element {\n return (\n <div\n {...props}\n style={{\n position: 'relative',\n ...props.style,\n }}\n >\n {children}\n\n <input\n name={name}\n style={{\n position: 'absolute',\n top: 0,\n left: 0,\n opacity: 0,\n width: '100%',\n height: '100%',\n pointerEvents: 'none',\n }}\n />\n </div>\n );\n}\n","import { isObject } from '@lib/helpers';\nimport { type KeyType } from './path';\nimport { castArrayPath } from './propAccess';\n\nexport function wildcardMatch(s: KeyType[] | string, w: KeyType[] | string): boolean {\n if (typeof s === 'string') {\n s = castArrayPath(s);\n }\n\n if (typeof w === 'string') {\n w = castArrayPath(w);\n }\n\n return s.length === w.length && s.every((s, i) => w[i] === '*' || s === w[i]);\n}\n\nexport function getWildCardMatches(\n object: any,\n path: [KeyType, ...KeyType[]] | string,\n): Record<KeyType, any> {\n const matches: Record<KeyType, any> = {};\n const [first, second, ...rest] = castArrayPath(path);\n\n if (first === undefined) {\n throw new Error('Path is empty');\n }\n\n if (!Array.isArray(object) && !isObject(object)) {\n object = {};\n }\n\n for (const [key, value] of first !== '*' ? [[first, object[first]]] : Object.entries(object)) {\n if (first !== '*' && first !== key) {\n continue;\n }\n\n if (second === undefined) {\n matches[key] = value;\n continue;\n }\n\n for (const [subKey, subValue] of Object.entries(getWildCardMatches(value, [second, ...rest]))) {\n matches[`${key}.${subKey}`] = subValue;\n }\n }\n\n return matches;\n}\n","import { type PathAsString, type Value } from '@lib/path';\nimport {\n createElement,\n useEffect,\n useState,\n type Component,\n type ComponentPropsWithoutRef,\n type ReactNode,\n} from 'react';\nimport {\n getDerivedState,\n type Field,\n type Form,\n type FormContext,\n type FormInstance,\n} from './form';\n\nexport interface FormFieldComponentProps<TValue, TPath> {\n name: TPath;\n value: TValue;\n onChange: (event: { target: { value: TValue } } | TValue | undefined, ...args: any[]) => void;\n onBlur: (...args: any[]) => void;\n}\n\nexport type FormFieldInfos<TDraft, TOriginal, TPath extends string> = Field<\n TDraft,\n TOriginal,\n TPath\n> & {\n hasTriggeredValidations: boolean;\n};\n\ntype NativeInputType = 'input' | 'select' | 'textarea';\n\ntype PartialComponentType<P> =\n | (new (props: P, context?: any) => Component<P, any>)\n | ((props: P, context?: any) => ReactNode);\n\nexport type FormFieldComponent = NativeInputType | PartialComponentType<any>;\n\ntype FieldValue<T extends FormFieldComponent> = ComponentPropsWithoutRef<T>['value'];\n\ntype FieldChangeValue<T extends FormFieldComponent> =\n ComponentPropsWithoutRef<T> extends {\n onChange?: (update: infer U) => void;\n }\n ? U extends { target: { value: infer V } }\n ? V\n : U\n : never;\n\ntype MakeOptional<T, Keys extends string> = Omit<T, Keys> & Partial<Pick<T, Keys & keyof T>>;\n\nexport type FormFieldProps<TPath, TDraft> = {\n name: TPath & PathAsString<TDraft>;\n commitOnBlur?: boolean;\n commitDebounce?: number;\n};\n\nexport type FormFieldPropsWithRender<TDraft, TOriginal, TPath extends string> = FormFieldProps<\n TPath,\n TDraft\n> &\n NoInfer<{\n component?: undefined;\n render: (\n props: FormFieldComponentProps<Value<TDraft, TPath>, TPath>,\n info: FormFieldInfos<TDraft, TOriginal, TPath>,\n form: FormContext<TDraft, TOriginal>,\n ) => ReactNode;\n inputFilter?: undefined;\n defaultValue?: undefined;\n serialize?: undefined;\n deserialize?: undefined;\n onChange?: undefined;\n onBlur?: undefined;\n }>;\n\ntype Serialize<TDraft, TOriginal, TPath, TComponent extends FormFieldComponent> = (\n value: Value<TDraft, TPath>,\n formState: FormInstance<TDraft, TOriginal>,\n) => FieldValue<TComponent>;\n\ntype Deserialize<TDraft, TOriginal, TPath, TComponent extends FormFieldComponent> = (\n value: FieldChangeValue<TComponent>,\n formState: FormInstance<TDraft, TOriginal>,\n) => Value<TDraft, TPath>;\n\nexport type FormFieldPropsWithComponent<\n TDraft,\n TOriginal,\n TPath extends string,\n TComponent extends FormFieldComponent,\n> = FormFieldProps<TPath, TDraft> & {\n component?: TComponent;\n render?: undefined;\n} & NoInfer<\n {\n inputFilter?: (value: FieldChangeValue<TComponent>) => boolean;\n } & MakeOptional<\n Omit<ComponentPropsWithoutRef<TComponent>, 'id' | 'name' | 'value' | 'defaultValue'>,\n 'onChange' | 'onBlur'\n > &\n (Value<TDraft, TPath> extends Exclude<FieldValue<TComponent>, undefined>\n ? {\n defaultValue?: FieldValue<TComponent>;\n serialize?: Serialize<TDraft, TOriginal, TPath, TComponent>;\n }\n : Value<TDraft, TPath> extends FieldValue<TComponent>\n ?\n | {\n defaultValue: FieldValue<TComponent>;\n serialize?: Serialize<TDraft, TOriginal, TPath, TComponent>;\n }\n | {\n defaultValue?: FieldValue<TComponent>;\n serialize: Serialize<TDraft, TOriginal, TPath, TComponent>;\n }\n : {\n serialize: Serialize<TDraft, TOriginal, TPath, TComponent>;\n }) &\n (FieldChangeValue<TComponent> extends Value<TDraft, TPath>\n ? {\n deserialize?: Deserialize<TDraft, TOriginal, TPath, TComponent>;\n }\n : {\n deserialize: Deserialize<TDraft, TOriginal, TPath, TComponent>;\n })\n >;\n\nexport function FormField<\n TDraft,\n TOriginal,\n TPath extends string,\n TComponent extends FormFieldComponent,\n>(\n this: Form<TDraft, any>,\n {\n // id,\n name = '' as any,\n component,\n commitOnBlur,\n commitDebounce,\n render,\n inputFilter,\n defaultValue,\n serialize,\n deserialize = (x) => x as Value<TDraft, TPath>,\n onChange,\n onBlur,\n ...restProps\n }:\n | FormFieldPropsWithRender<TDraft, TOriginal, TPath>\n | FormFieldPropsWithComponent<TDraft, TOriginal, TPath, TComponent>,\n): React.JSX.Element | null {\n type T = FieldChangeValue<TComponent>;\n\n const form = this.useForm();\n const getFormState = () => ({ ...form, ...getDerivedState(form) });\n const [localValue, setLocalValue] = useState<T>();\n\n const value = this.useFormState((form) => {\n const value = form.getField(name as any).value;\n if (serialize) {\n return serialize(value as any, getFormState());\n }\n if (value !== undefined) {\n return value;\n }\n return defaultValue;\n });\n\n const setValue = (x: FieldChangeValue<TComponent>) =>\n form.getField(name as any).setValue(deserialize(x, getFormState()));\n\n const hasTriggeredValidations = this.useFormState((form) => form.hasTriggeredValidations);\n\n useEffect(() => {\n if (localValue === undefined || !commitDebounce) {\n return;\n }\n\n const timeout = setTimeout(() => {\n setValue(localValue);\n setLocalValue(undefined);\n }, commitDebounce);\n\n return () => clearTimeout(timeout);\n }, [localValue, commitDebounce]);\n\n const props = {\n name,\n value: localValue ?? value,\n onChange: (event: { target: { value: T } } | T, ...moreArgs: any[]) => {\n const value =\n typeof event === 'object' && event !== null && 'target' in event\n ? event.target.value\n : event;\n\n if (inputFilter && !inputFilter(value)) {\n return;\n }\n\n if (commitOnBlur || commitDebounce) {\n setLocalValue(value);\n } else {\n setValue(value);\n }\n\n onChange?.(event, ...moreArgs);\n },\n onBlur(...args: any[]) {\n if (localValue !== undefined) {\n setValue(localValue);\n setLocalValue(undefined);\n }\n\n onBlur?.(...args);\n },\n } as FormFieldComponentProps<Value<TDraft, TPath>, TPath>;\n\n if (render) {\n return (\n <>\n {render(props, { ...form.getField(name as any), hasTriggeredValidations } as any, form) ??\n null}\n </>\n );\n }\n\n if (component) {\n return createElement(component, { ...restProps, ...props });\n }\n\n return null;\n}\n","import { type GetKeys, type Join, type PathAsString, type Value } from '@lib/path';\nimport { Fragment, useCallback, type ReactNode } from 'react';\nimport { type FieldHelperMethods, type Form } from './form';\n\nexport type ElementName<TDraft, TPath extends string> = keyof {\n [Path in TPath as Join<Path, GetKeys<NonNullable<Value<TDraft, Path>>> & (string | number)>]: 1;\n};\n\nexport interface FormForEachProps<TDraft, TPath extends string> {\n name: TPath & PathAsString<TDraft>;\n renderElement?: (props: {\n name: ElementName<TDraft, TPath>;\n key: `${GetKeys<NonNullable<Value<TDraft, TPath>>> & (string | number)}`;\n index: number;\n remove: () => void;\n }) => ReactNode;\n children?: (\n props: {\n setValue: (\n value: Value<TDraft, TPath> | ((value: Value<TDraft, TPath>) => Value<TDraft, TPath>),\n ) => void;\n } & FieldHelperMethods<TDraft, TPath>,\n ) => ReactNode;\n}\n\nexport function FormForEach<TDraft, TPath extends string>(\n this: Form<TDraft, any>,\n { name, renderElement, children }: FormForEachProps<TDraft, TPath>,\n): React.JSX.Element {\n const form = this.useForm();\n\n const names = this.useFormState(() => {\n const field = form.getField(name as any) as any;\n return field.names as any[];\n });\n\n const add = useCallback(\n (...args: any[]) => {\n const field = form.getField(name as any) as any;\n field.add(...args);\n },\n [form],\n );\n\n const remove = useCallback(\n (key: any) => {\n const field = form.getField(name as any) as any;\n field.remove(key);\n },\n [form],\n );\n\n const setValue = useCallback(\n (value: Value<TDraft, TPath> | ((value: Value<TDraft, TPath>) => Value<TDraft, TPath>)) => {\n const field = form.getField(name as any) as any;\n field.setValue(value);\n },\n [form],\n );\n\n return (\n <>\n {renderElement &&\n names.map((name, index) => {\n const key = name.split('.').pop();\n\n return (\n <Fragment key={key}>\n {renderElement({\n name,\n key,\n index,\n remove: () => remove(key),\n })}\n </Fragment>\n );\n })}\n\n {children?.({\n names,\n add,\n remove,\n setValue,\n } as any)}\n </>\n );\n}\n","import type { Duration } from '@core';\nimport { calcDuration } from '@lib/calcDuration';\nimport { debounce } from '@lib/debounce';\nimport { deepEqual } from '@lib/equals';\nimport type { MaybePromise } from '@lib/maybePromise';\nimport { queue } from '@lib/queue';\nimport { useEffect, useMemo, useRef } from 'react';\nimport type { FormContext } from './form';\n\nexport interface FormAutosaveOptions<TDraft, TOriginal> {\n save: (draft: TDraft, form: FormContext<TDraft, TOriginal>) => MaybePromise<void>;\n debounce?: Duration;\n resetAfterSave?: boolean;\n}\n\nexport function useFormAutosave<TDraft, TOriginal extends TDraft>(\n form: FormContext<TDraft, TOriginal>,\n): void {\n const { formState, options, getDraft } = form;\n const debounceTime = calcDuration(options.autoSave?.debounce ?? 2_000);\n const latestRef = useRef({ options });\n const lastValue = useRef<TDraft | undefined>(undefined);\n const q = useMemo(() => queue(), []);\n\n const run = useMemo(\n () =>\n debounce(async () => {\n const { options } = latestRef.current;\n const save = options.autoSave?.save;\n const draft = getDraft();\n\n lastValue.current = draft;\n\n q.clear();\n\n q(async () => {\n try {\n formState.set('saveInProgress', true);\n await save?.(draft, form);\n\n if (q.size === 0 && options.autoSave?.resetAfterSave) {\n form.reset();\n }\n } finally {\n formState.set('saveInProgress', false);\n\n if (q.size === 0) {\n formState.set('saveScheduled', false);\n }\n }\n });\n }, debounceTime),\n [formState, debounceTime],\n );\n\n useEffect(() => {\n if (!options.autoSave?.save) {\n return;\n }\n\n return formState\n .map((state) => state.draft)\n .subscribe(\n () => {\n if (deepEqual(getDraft(), lastValue.current)) {\n return;\n }\n\n run();\n formState.set('saveScheduled', true);\n },\n { runNow: false },\n );\n }, [formState]);\n\n useEffect(() => {\n latestRef.current = { options };\n });\n}\n","import { createStore, type Store, type Update } from '@core';\nimport { autobind } from '@lib/autobind';\nimport { deepEqual } from '@lib/equals';\nimport { isObject } from '@lib/helpers';\nimport {\n type Path,\n type PathAsString,\n type Value,\n type WildcardPathAsString,\n type WildcardValue,\n} from '@lib/path';\nimport { get, join, set } from '@lib/propAccess';\nimport type { Object_ } from '@lib/typeHelpers';\nimport { getWildCardMatches } from '@lib/wildcardMatch';\nimport {\n createContext,\n useContext,\n useEffect,\n useMemo,\n useRef,\n type Context,\n type FormEvent,\n type FunctionComponent,\n type HTMLProps,\n type ReactNode,\n} from 'react';\nimport { useStore, type UseStoreOptions } from '../useStore';\nimport {\n FormField,\n type FormFieldComponent,\n type FormFieldPropsWithComponent,\n type FormFieldPropsWithRender,\n} from './formField';\nimport { FormForEach, type ElementName, type FormForEachProps } from './formForEach';\nimport { useFormAutosave, type FormAutosaveOptions } from './useFormAutosave';\n\n/// /////////////////////////////////////////////////////////////////////////////\n// Form types\n/// /////////////////////////////////////////////////////////////////////////////\n\nexport type Transform<TDraft> = Path<TDraft> | '' extends infer TPath\n ? TPath extends TPath\n ? {\n update: (value: Value<TDraft, TPath>, store: Store<TDraft>) => void | TDraft;\n } & (TPath extends '' ? { trigger?: '' } : { trigger: TPath })\n : never\n : never;\n\nexport interface FormOptions<TDraft, TOriginal> {\n defaultValue: TDraft;\n validations?: Validations<TDraft, TOriginal>;\n localizeError?: (error: string, field: string) => string | undefined;\n autoSave?: FormAutosaveOptions<TDraft, TOriginal>;\n transform?: Transform<TDraft>[];\n validatedClass?: string;\n}\n\nexport type Validations<TDraft, TOriginal> = {\n [TPath in WildcardPathAsString<TDraft>]?: Record<string, Validation<TDraft, TOriginal, TPath>>;\n} & Record<string, Record<string, Validation<TDraft, TOriginal, any>>>;\n\nexport type Validation<TDraft, TOriginal, TPath> = (\n value: WildcardValue<TDraft, TPath>,\n context: {\n draft: TDraft;\n original: TOriginal;\n field: PathAsString<TDraft> | '';\n },\n) => boolean;\n\nexport type Field<TDraft, TOriginal, TPath extends string> = {\n originalValue: Value<TOriginal, TPath> | undefined;\n value: Value<TDraft, TPath>;\n setValue: (value: Update<Value<TDraft, TPath>>) => void;\n removeValue: () => void;\n hasChange: boolean;\n errors: string[];\n} & (Value<TDraft, TPath> extends Object_ ? FieldHelperMethods<TDraft, TPath> : {});\n\nexport type FieldHelperMethods<TDraft, TPath extends string> = {\n names: ElementName<TDraft, TPath>[];\n add: NonNullable<Value<TDraft, TPath>> extends readonly (infer T)[]\n ? (element: T) => void\n : NonNullable<Value<TDraft, TPath>> extends Record<infer K, infer V>\n ? (key: K, value: V) => void\n : never;\n remove: Value<TDraft, TPath> extends readonly any[]\n ? (index: number) => void\n : (key: string) => void;\n};\n\nexport interface FormState<TDraft> {\n draft: TDraft | undefined;\n hasTriggeredValidations: boolean;\n saveScheduled: boolean;\n saveInProgress: boolean;\n}\n\nexport interface FormDerivedState<TDraft> {\n draft: TDraft;\n hasTriggeredValidations: boolean;\n saveScheduled: boolean;\n saveInProgress: boolean;\n hasChanges: boolean;\n errors: Map<string, string[]>;\n isValid: boolean;\n}\n\nexport interface FormContext<TDraft, TOriginal> {\n formState: Store<FormState<TDraft>>;\n options: FormOptions<TDraft, TOriginal>;\n original: TOriginal | undefined;\n getField: <TPath extends string>(path: TPath) => Field<TDraft, TOriginal, TPath>;\n getDraft: () => TDraft;\n hasTriggeredValidations: () => boolean;\n saveScheduled: () => boolean;\n saveInProgress: () => boolean;\n hasChanges: () => boolean;\n getErrors: () => Map<string, string[]>;\n isValid: () => boolean;\n validate: () => boolean;\n reset: () => void;\n}\n\nexport interface FormInstance<TDraft, TOriginal>\n extends FormDerivedState<TDraft>,\n Pick<\n FormContext<TDraft, TOriginal>,\n 'options' | 'original' | 'getField' | 'validate' | 'reset'\n > {}\n\n/// /////////////////////////////////////////////////////////////////////////////\n// Implementation\n/// /////////////////////////////////////////////////////////////////////////////\n\nfunction FormContainer({\n form,\n ...formProps\n}: {\n form: Form<any, any>;\n onSubmit?: (\n event: FormEvent<HTMLFormElement>,\n form: FormInstance<any, any>,\n ) => void | Promise<void>;\n} & Omit<HTMLProps<HTMLFormElement>, 'form' | 'onSubmit'>) {\n const formInstance = form.useForm();\n const hasTriggeredValidations = form.useFormState((state) => state.hasTriggeredValidations);\n\n const formRef = useRef<HTMLFormElement>(null);\n\n function updateValidity(errors: Map<string, string[]>, buttonElement?: HTMLButtonElement) {\n const formElement = formRef.current;\n if (!formElement) {\n return;\n }\n\n const localizedErrors = new Map(\n [...errors.entries()].map(\n ([field, errors]) =>\n [\n field,\n errors.map((error) => formInstance.options.localizeError?.(error, field) ?? error),\n ] as const,\n ),\n );\n\n for (const element of Array.from(formElement.elements)) {\n if ('name' in element && 'setCustomValidity' in element) {\n (element as HTMLObjectElement).setCustomValidity(\n localizedErrors.get((element as HTMLObjectElement).name)?.join('\\n') ?? '',\n );\n }\n }\n\n if (buttonElement && 'setCustomValidity' in buttonElement) {\n const errorString = [...errors.values()].flat().join('\\n');\n\n buttonElement.setCustomValidity(errorString);\n }\n }\n\n useEffect(() => {\n return formInstance.formState\n .map(() => formInstance.getErrors())\n .subscribe((errors) => updateValidity(errors));\n }, []);\n\n return (\n <form\n ref={formRef}\n noValidate\n {...formProps}\n className={[\n formProps.className,\n hasTriggeredValidations ? (formInstance.options.validatedClass ?? 'validated') : undefined,\n ]\n .filter(Boolean)\n .join(' ')}\n onSubmit={async (event) => {\n if (formInstance.saveInProgress()) {\n return;\n }\n\n try {\n formInstance.formState.set('saveInProgress', true);\n event.preventDefault();\n\n const formElement = event.currentTarget;\n const buttonElement =\n event.nativeEvent instanceof SubmitEvent &&\n event.nativeEvent.submitter instanceof HTMLButtonElement\n ? event.nativeEvent.submitter\n : undefined;\n\n updateValidity(formInstance.getErrors(), buttonElement);\n\n formElement.reportValidity();\n\n const isValid = formInstance.validate();\n if (isValid) {\n await formProps.onSubmit?.(event, {\n ...formInstance,\n ...getDerivedState(formInstance),\n });\n }\n } finally {\n formInstance.formState.set('saveInProgress', false);\n }\n }}\n />\n );\n}\n\nfunction getField<TDraft, TOriginal extends TDraft, TPath extends string>(\n form: FormContext<TDraft, TOriginal>,\n path: TPath,\n): Field<TDraft, TOriginal, TPath> {\n const field = {\n get originalValue() {\n return form.original !== undefined ? get(form.original as any, path as any) : undefined;\n },\n\n get value() {\n const draft = form.getDraft();\n return get(draft ?? form.original ?? form.options.defaultValue, path as any);\n },\n\n setValue(update: Update<Value<TDraft, TPath>>) {\n form.formState.set('draft', (draft = form.original ?? form.options.defaultValue) => {\n if (update instanceof Function) {\n update = update(get(draft, path as any) as Value<TDraft, TPath>);\n }\n\n return set(draft, path as any, update as any);\n });\n },\n\n get hasChange() {\n return !deepEqual(this.originalValue, this.value, { undefinedEqualsAbsent: true });\n },\n\n get errors() {\n const errors = form.getErrors();\n return errors.get(path) ?? [];\n },\n\n get names(): any {\n const { value } = this;\n\n if (Array.isArray(value)) {\n return value.map((_, index) => join(path, String(index)));\n }\n\n if (isObject(value)) {\n return Object.keys(value).map((key) => join(path, key));\n }\n\n return [];\n },\n\n add(...args: any[]) {\n this.setValue((value): any => {\n if (!value) {\n throw new Error(`Cannot add element to ${JSON.stringify(value)}`);\n }\n\n if (Array.isArray(value)) {\n return [...(value ?? []), args[0]];\n }\n\n if (isObject(value)) {\n return {\n ...value,\n [args[0]]: args[1],\n };\n }\n\n throw new Error(`Cannot add element to ${JSON.stringify(value)}`);\n });\n },\n\n remove(key: string | number) {\n this.setValue((value): any => {\n if (!value) {\n throw new Error(`Cannot remove element from ${JSON.stringify(value)}`);\n }\n\n if (Array.isArray(value)) {\n return value.filter((_, index) => index !== Number(key));\n }\n\n if (isObject(value)) {\n const { [key]: _, ...rest } = value as Record<string | number, unknown>;\n return rest;\n }\n\n throw new Error(`Cannot remove element from ${JSON.stringify(value)}`);\n });\n },\n };\n\n return field as any;\n}\n\nfunction getErrors<TDraft, TOriginal>(\n draft: TDraft,\n original: TOriginal | undefined,\n validations: FormOptions<TDraft, TOriginal>['validations'],\n) {\n const errors = new Map<string, string[]>();\n\n for (const [path, block] of Object.entries(validations ?? {})) {\n for (const [validationName, validate] of Object.entries(\n block as Record<string, Validation<any, any, any>>,\n )) {\n let matched = false;\n\n for (const [field, value] of Object.entries(getWildCardMatches(draft, path))) {\n matched = true;\n if (!validate(value, { draft, original, field })) {\n const fieldErrors = errors.get(field) ?? [];\n fieldErrors.push(validationName);\n errors.set(field, fieldErrors);\n }\n }\n\n if (!matched && !path.includes('*')) {\n if (!validate(undefined, { draft, original, field: path })) {\n const fieldErrors = errors.get(path) ?? [];\n fieldErrors.push(validationName);\n errors.set(path, fieldErrors);\n }\n }\n }\n }\n\n return errors;\n}\n\nexport function getDerivedState<TDraft>(\n instance: FormContext<TDraft, any>,\n): FormDerivedState<TDraft> {\n return {\n draft: instance.getDraft(),\n hasTriggeredValidations: instance.hasTriggeredValidations(),\n saveScheduled: instance.saveScheduled(),\n saveInProgress: instance.saveInProgress(),\n hasChanges: instance.hasChanges(),\n errors: instance.getErrors(),\n isValid: instance.isValid(),\n };\n}\n\nexport class Form<TDraft, TOriginal extends TDraft = TDraft> {\n context: Context<FormContext<TDraft, TOriginal> | null> = createContext<FormContext<\n TDraft,\n TOriginal\n > | null>(null);\n\n constructor(public readonly options: FormOptions<TDraft, TOriginal>) {\n autobind(Form);\n }\n\n useForm(): FormContext<TDraft, TOriginal> {\n const context = useContext(this.context);\n\n if (!context) {\n throw new Error('Form context not found');\n }\n\n return context;\n }\n\n useFormState<S>(\n selector: (state: FormInstance<TDraft, TOriginal>) => S,\n useStoreOptions?: UseStoreOptions<S>,\n ): S {\n const form = this.useForm();\n\n return useStore(\n form.formState,\n () =>\n selector({\n ...form,\n ...getDerivedState(form),\n }),\n\n useStoreOptions,\n );\n }\n\n useField<TPath extends string>(\n path: TPath,\n useStoreOptions?: UseStoreOptions<any>,\n ): Field<TDraft, TOriginal, TPath> {\n const form = this.useForm();\n this.useFormState((form) => [form.getField(path).value, form.original], useStoreOptions);\n return form.getField(path);\n }\n\n // ///////////////////////////////////////////////////////////////////////////\n // React Components\n // ///////////////////////////////////////////////////////////////////////////\n\n Form({\n original,\n defaultValue,\n validations,\n localizeError,\n autoSave,\n transform,\n validatedClass,\n ...formProps\n }: {\n original?: TOriginal;\n onSubmit?: (event: FormEvent<HTMLFormElement>, form: FormInstance<TDraft, TOriginal>) => void;\n } & Partial<FormOptions<TDraft, TOriginal>> &\n Omit<HTMLProps<HTMLFormElement>, 'defaultValue' | 'autoSave' | 'onSubmit'>): React.JSX.Element {\n const options: FormOptions<TDraft, TOriginal> = {\n defaultValue: { ...this.options.defaultValue, ...defaultValue },\n validations: { ...this.options.validations, ...validations } as Validations<\n TDraft,\n TOriginal\n >,\n localizeError: localizeError ?? this.options.localizeError,\n autoSave: autoSave ?? this.options.autoSave,\n transform: transform ?? this.options.transform,\n validatedClass: validatedClass ?? this.options.validatedClass,\n };\n\n const formState = useMemo(() => {\n return createStore<FormState<TDraft>>({\n draft: undefined,\n hasTriggeredValidations: false,\n saveScheduled: false,\n saveInProgress: false,\n });\n }, []);\n\n let lastDraft: TDraft | undefined;\n const cache = new Map<string, unknown>();\n function lazy<T>(key: string, fn: () => T): T {\n if (lastDraft !== formState.get().draft) {\n cache.clear();\n lastDraft = formState.get().draft;\n }\n\n let value = cache.get(key);\n if (!cache.has(key)) {\n value = fn();\n cache.set(key, value);\n }\n\n return value as T;\n }\n\n const context: FormContext<TDraft, TOriginal> = {\n formState,\n options,\n original,\n\n getField() {\n throw new Error('Not implemented');\n },\n\n getDraft() {\n return formState.get().draft ?? original ?? options.defaultValue;\n },\n\n hasTriggeredValidations() {\n return formState.get().hasTriggeredValidations;\n },\n\n saveScheduled() {\n return formState.get().saveScheduled;\n },\n\n saveInProgress() {\n return formState.get().saveInProgress;\n },\n\n hasChanges() {\n return lazy(\n 'hasChanges',\n () =>\n !deepEqual(this.getDraft(), original ?? options.defaultValue, {\n undefinedEqualsAbsent: true,\n }),\n );\n },\n\n getErrors() {\n return lazy('getErrors', () => getErrors(this.getDraft(), original, options.validations));\n },\n\n isValid() {\n return lazy('isValid', () => this.getErrors().size === 0);\n },\n\n validate() {\n formState.set('hasTriggeredValidations', true);\n return this.isValid();\n },\n\n reset() {\n formState.set('draft', undefined);\n formState.set('hasTriggeredValidations', false);\n },\n };\n\n context.getField = (path) => lazy(path, () => getField(context, path));\n\n // useEffect(() => {\n // const handles = options.transform?.map(({ trigger, update }) => {\n // const draft = derivedState.map('draft');\n // const triggerStore = trigger ? draft.map(trigger as any) : draft;\n\n // return triggerStore.subscribe(() => {\n // const value = trigger ? get(draft.get(), trigger as any) : draft.get();\n // const result = update(value as any, draft);\n\n // if (result !== undefined) {\n // draft.set(result);\n // }\n // });\n // });\n\n // return () => {\n // handles?.forEach((handle) => handle());\n // };\n // }, [original,options.transform]);\n\n useFormAutosave(context);\n\n return (\n <this.context.Provider value={context}>\n <FormContainer {...formProps} form={this} />\n </this.context.Provider>\n );\n }\n\n FormState<S>({\n selector,\n children,\n }: {\n selector: (form: FormInstance<TDraft, TOriginal>) => S;\n children: (selectedState: S) => ReactNode;\n }): React.JSX.Element {\n const selectedState = this.useFormState(selector);\n return <>{children(selectedState)}</>;\n }\n\n Field<const TPath extends string>(\n props: FormFieldPropsWithRender<TDraft, TOriginal, TPath>,\n ): React.JSX.Element;\n\n Field<const TPath extends string, const TComponent extends FormFieldComponent = 'input'>(\n props: FormFieldPropsWithComponent<TDraft, TOriginal, TPath, TComponent>,\n ): React.JSX.Element;\n\n Field(props: any): React.JSX.Element {\n return Reflect.apply(FormField, this, [{ component: 'input', ...props }]);\n }\n\n ForEach<const TPath extends string>(props: FormForEachProps<TDraft, TPath>): React.JSX.Element {\n return Reflect.apply(FormForEach, this, [props]);\n }\n\n withForm<TProps extends Record<string, unknown>>(\n Component: React.ComponentType<TProps>,\n formProps?: Parameters<this['Form']>[0],\n ): FunctionComponent<TProps> {\n const { Form } = this;\n return function FormWrapper(props: TProps) {\n return (\n <Form {...formProps}>\n <Component {...props} />\n </Form>\n );\n };\n }\n}\n\nexport function createForm<TDraft, TOriginal extends TDraft = TDraft>(\n options: FormOptions<TDraft, TOriginal>,\n): Form<TDraft, TOriginal> {\n return new Form(options);\n}\n","import React, { createContext, useContext, type Context, type ReactNode } from 'react';\n\nexport type Location = string | { pathname: string; search: string; hash: string };\n\nexport interface UrlContextType {\n location: Location;\n navigate: (navigate: (from: Location) => string) => void;\n}\n\nexport type UrlContextProviderProps = { children?: ReactNode } & (\n | { location: UrlContextType['location'] }\n | { locationHook: () => UrlContextType['location'] }\n) &\n ({ navigate: UrlContextType['navigate'] } | { navigateHook: () => UrlContextType['navigate'] });\n\nexport const UrlContext: Context<UrlContextType | undefined> = createContext<\n UrlContextType | undefined\n>(undefined);\n\nexport function UrlProvider({ children, ...props }: UrlContextProviderProps): React.JSX.Element {\n const location = 'location' in props ? props.location : props.locationHook();\n const navigate = 'navigate' in props ? props.navigate : props.navigateHook();\n\n return <UrlContext.Provider value={{ location, navigate }}>{children}</UrlContext.Provider>;\n}\n\nexport function useUrlContext(): UrlContextType {\n const context = useContext(UrlContext);\n if (!context) {\n throw new Error('useUrlContext must be used within a UrlContextProvider');\n }\n return context;\n}\n","import { fromExtendedJsonString, toExtendedJsonString } from '@lib/extendedJson';\nimport type { Location } from '@react/url/urlContext';\n\nexport function defaultDeserializer<T>(value: string): T {\n if (value === undefined) {\n return undefined as T;\n }\n\n try {\n return fromExtendedJsonString(value) as T;\n } catch {\n return undefined as T;\n }\n}\n\nexport function defaultSerializer<T>(value: T): string {\n return toExtendedJsonString(value);\n}\n\nexport function parseLocation(location: Location): URL {\n if (typeof location !== 'string') {\n location = `${location.pathname}${location.search}${location.hash}`;\n }\n\n return new URL(location, window.location.origin);\n}\n\nexport function createStorageKey(id: string, key: string) {\n return `cross-state:url:${id}:${key}`;\n}\n","import { defaultDeserializer, defaultSerializer } from '@react/url/urlHelpers';\n\nexport interface UrlOptions<T> {\n key: string;\n type?: 'search' | 'hash';\n serialize?: (value: T) => string;\n deserialize?: (value: string) => T;\n defaultValue: T;\n writeDefaultValue?: boolean;\n onCommit?: (value: T) => void;\n persist?: { id: string } | null;\n}\n\nexport interface UrlOptionsWithoutDefaults<T>\n extends Omit<UrlOptions<T | undefined>, 'defaultValue'> {\n defaultValue?: T | undefined;\n}\n\nexport function createUrlOptions<T>(options: UrlOptions<T>): Required<UrlOptions<T>>;\nexport function createUrlOptions<T>(\n options: UrlOptionsWithoutDefaults<T>,\n): Required<UrlOptions<T | undefined>>;\nexport function createUrlOptions<T>({\n key,\n type = 'hash',\n serialize = defaultSerializer,\n deserialize = defaultDeserializer,\n defaultValue = undefined as T,\n writeDefaultValue = false,\n onCommit = () => undefined,\n persist = null,\n}: UrlOptionsWithoutDefaults<T>): Required<UrlOptionsWithoutDefaults<T>> {\n return {\n key,\n type,\n serialize,\n deserialize,\n defaultValue,\n writeDefaultValue,\n onCommit,\n persist,\n };\n}\n","import type { Update, UpdateFunction } from '@core';\nimport { useUrlContext } from '@react/url/urlContext';\nimport { createStorageKey, parseLocation } from '@react/url/urlHelpers';\nimport {\n createUrlOptions,\n type UrlOptions,\n type UrlOptionsWithoutDefaults,\n} from '@react/url/urlOptions';\nimport type { UrlStore } from '@react/url/urlStore';\nimport { useEffect, useMemo } from 'react';\n\nexport function useUrlParam<T>(store: UrlStore<T>): [T, update: UpdateFunction<T>];\nexport function useUrlParam<T>(options: UrlOptions<T>): [T, update: UpdateFunction<T>];\nexport function useUrlParam<T>(\n options: UrlOptionsWithoutDefaults<T>,\n): [T | undefined, update: UpdateFunction<T | undefined>];\nexport function useUrlParam<T>(\n input: UrlStore<T> | UrlOptionsWithoutDefaults<T>,\n): [T, update: UpdateFunction<T>] {\n const { key, type, serialize, deserialize, defaultValue, writeDefaultValue, onCommit, persist } =\n createUrlOptions('options' in input ? input.options : (input as UrlOptions<T>));\n\n const { location, navigate } = useUrlContext();\n const url = parseLocation(location);\n const params = new URLSearchParams(url[type].slice(1));\n const urlValue = params.get(key);\n\n const storageKey = persist && createStorageKey(persist.id, key);\n const storageValue = storageKey ? localStorage.getItem(storageKey) : null;\n\n const value = useMemo(\n () =>\n urlValue !== null\n ? deserialize(urlValue)\n : storageValue !== null\n ? deserialize(storageValue)\n : defaultValue,\n [urlValue],\n );\n\n function commit(value: T) {\n const serializedValue = serialize(value);\n\n navigate((location) => {\n const url = parseLocation(location);\n const params = new URLSearchParams(url[type].slice(1));\n\n if (!writeDefaultValue && serializedValue === serialize(defaultValue)) {\n params.delete(key);\n } else {\n params.set(key, serializedValue);\n }\n\n url[type] = params.toString();\n return url.toString().replace(window.location.origin, '');\n });\n\n if (storageKey) {\n localStorage.setItem(storageKey, serializedValue);\n }\n\n onCommit?.(value);\n }\n\n function update(update: Update<T>) {\n if (update instanceof Function) {\n update = update(value);\n }\n\n commit(update);\n }\n\n useEffect(() => {\n if (urlValue !== null) {\n commit(deserialize(urlValue));\n }\n }, [urlValue]);\n\n useEffect(() => {\n if (urlValue === null && storageValue !== null) {\n commit(deserialize(storageValue));\n } else if (urlValue === null && writeDefaultValue) {\n commit(defaultValue);\n }\n }, []);\n\n return [value, update];\n}\n","import type { UpdateFunction } from '@core';\nimport type { Location } from '@react/url/urlContext';\nimport { parseLocation } from '@react/url/urlHelpers';\nimport {\n createUrlOptions,\n type UrlOptions,\n type UrlOptionsWithoutDefaults,\n} from '@react/url/urlOptions';\nimport { useUrlParam } from '@react/url/useUrlParam';\n\nexport class UrlStore<T> {\n constructor(public readonly options: Required<UrlOptions<T>>) {}\n\n useStore(): T {\n return useUrlParam(this)[0];\n }\n\n useProp(): [T, update: UpdateFunction<T>] {\n return useUrlParam(this);\n }\n\n parse(location: Location): T | undefined {\n const url = parseLocation(location);\n const params = new URLSearchParams(url[this.options.type].slice(1));\n const urlValue = params.get(this.options.key);\n return urlValue !== null ? this.options.deserialize(urlValue) : undefined;\n }\n}\nexport function createUrlStore<T>(options: UrlOptions<T>): UrlStore<T>;\nexport function createUrlStore<T>(options: UrlOptionsWithoutDefaults<T>): UrlStore<T | undefined>;\nexport function createUrlStore<T>(options: UrlOptionsWithoutDefaults<T>) {\n return new UrlStore(createUrlOptions(options));\n}\n","import { startTransition, useEffect, useMemo, useRef, useState } from 'react';\nimport { type Duration } from '@core';\nimport { debounce } from '@lib/debounce';\nimport { simpleHash } from '@lib/hash';\nimport { throttle } from '@lib/throttle';\n\nexport interface UseDecoupledStateOptions<T> {\n debounce?: Duration;\n throttle?: Duration;\n onCommit?: (value: T) => void;\n}\n\nexport function useDecoupledState<T>(\n value: T,\n onChange: (value: T) => void,\n options: UseDecoupledStateOptions<T> = {},\n): [state: T, setState: (value: T) => void] {\n const [dirty, setDirty] = useState<{ v: T }>();\n const ref = useRef({ onChange, onCommit: options.onCommit });\n\n useEffect(() => {\n ref.current = { onChange, onCommit: options.onCommit };\n }, [onChange]);\n\n const update = useMemo(() => {\n const { onChange, onCommit } = ref.current;\n\n const update = (value: T) => {\n onChange(value);\n setDirty(undefined);\n onCommit?.(value);\n };\n\n let delayedUpdate: (value: T) => void;\n\n if (options.debounce) {\n delayedUpdate = debounce(update, options.debounce);\n } else if (options.throttle) {\n delayedUpdate = throttle(update, options.throttle);\n } else {\n delayedUpdate = (value) => startTransition(() => update(value));\n }\n\n return (value: T) => {\n setDirty({ v: value });\n delayedUpdate(value);\n };\n }, [simpleHash([options.debounce, options.throttle])]);\n\n return [dirty ? dirty.v : value, update];\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.js","names":["matches: Record<KeyType, any>","value","form","name","options","errors","options: FormOptions<TDraft, TOriginal>","form","lastDraft: TDraft | undefined","context: FormContext<TDraft, TOriginal>","transform","Form","Component","UrlContext: Context<UrlContextType | undefined>","value","url","location","params","update","options: Required<UrlOptions<T>>","update","value","delayedUpdate: (value: T) => void"],"sources":["../../src/react/form/customInput.tsx","../../src/lib/wildcardMatch.ts","../../src/react/form/formField.tsx","../../src/react/form/formForEach.tsx","../../src/react/form/useFormAutosave.ts","../../src/react/form/form.tsx","../../src/react/url/urlContext.tsx","../../src/react/url/urlHelpers.ts","../../src/react/url/urlOptions.ts","../../src/react/url/useUrlParam.ts","../../src/react/url/urlStore.ts","../../src/react/useDecoupledState.ts"],"sourcesContent":["import type { ReactNode } from 'react';\n\nexport interface CustomInputProps extends React.HTMLAttributes<HTMLDivElement> {\n name: string;\n children?: ReactNode;\n}\n\nexport function CustomInput({ name, children, ...props }: CustomInputProps): React.JSX.Element {\n return (\n <div\n {...props}\n style={{\n position: 'relative',\n ...props.style,\n }}\n >\n {children}\n\n <input\n name={name}\n style={{\n position: 'absolute',\n top: 0,\n left: 0,\n opacity: 0,\n width: '100%',\n height: '100%',\n pointerEvents: 'none',\n }}\n />\n </div>\n );\n}\n","import { isObject } from '@lib/helpers';\nimport { type KeyType } from './path';\nimport { castArrayPath } from './propAccess';\n\nexport function wildcardMatch(s: KeyType[] | string, w: KeyType[] | string): boolean {\n if (typeof s === 'string') {\n s = castArrayPath(s);\n }\n\n if (typeof w === 'string') {\n w = castArrayPath(w);\n }\n\n return s.length === w.length && s.every((s, i) => w[i] === '*' || s === w[i]);\n}\n\nexport function getWildCardMatches(\n object: any,\n path: [KeyType, ...KeyType[]] | string,\n): Record<KeyType, any> {\n const matches: Record<KeyType, any> = {};\n const [first, second, ...rest] = castArrayPath(path);\n\n if (first === undefined) {\n throw new Error('Path is empty');\n }\n\n if (!Array.isArray(object) && !isObject(object)) {\n object = {};\n }\n\n for (const [key, value] of first !== '*' ? [[first, object[first]]] : Object.entries(object)) {\n if (first !== '*' && first !== key) {\n continue;\n }\n\n if (second === undefined) {\n matches[key] = value;\n continue;\n }\n\n for (const [subKey, subValue] of Object.entries(getWildCardMatches(value, [second, ...rest]))) {\n matches[`${key}.${subKey}`] = subValue;\n }\n }\n\n return matches;\n}\n","import { type PathAsString, type Value } from '@lib/path';\nimport {\n createElement,\n useEffect,\n useState,\n type Component,\n type ComponentPropsWithoutRef,\n type ReactNode,\n} from 'react';\nimport {\n getDerivedState,\n type Field,\n type Form,\n type FormContext,\n type FormInstance,\n} from './form';\n\nexport interface FormFieldComponentProps<TValue, TPath> {\n name: TPath;\n value: TValue;\n onChange: (event: { target: { value: TValue } } | TValue | undefined, ...args: any[]) => void;\n onBlur: (...args: any[]) => void;\n}\n\nexport type FormFieldInfos<TDraft, TOriginal, TPath extends string> = Field<\n TDraft,\n TOriginal,\n TPath\n> & {\n hasTriggeredValidations: boolean;\n};\n\ntype NativeInputType = 'input' | 'select' | 'textarea';\n\ntype PartialComponentType<P> =\n | (new (props: P, context?: any) => Component<P, any>)\n | ((props: P, context?: any) => ReactNode);\n\nexport type FormFieldComponent = NativeInputType | PartialComponentType<any>;\n\ntype FieldValue<T extends FormFieldComponent> = ComponentPropsWithoutRef<T>['value'];\n\ntype FieldChangeValue<T extends FormFieldComponent> =\n ComponentPropsWithoutRef<T> extends {\n onChange?: (update: infer U) => void;\n }\n ? U extends { target: { value: infer V } }\n ? V\n : U\n : never;\n\ntype MakeOptional<T, Keys extends string> = Omit<T, Keys> & Partial<Pick<T, Keys & keyof T>>;\n\nexport type FormFieldProps<TPath, TDraft> = {\n name: TPath & PathAsString<TDraft>;\n commitOnBlur?: boolean;\n commitDebounce?: number;\n};\n\nexport type FormFieldPropsWithRender<TDraft, TOriginal, TPath extends string> = FormFieldProps<\n TPath,\n TDraft\n> &\n NoInfer<{\n component?: undefined;\n render: (\n props: FormFieldComponentProps<Value<TDraft, TPath>, TPath>,\n info: FormFieldInfos<TDraft, TOriginal, TPath>,\n form: FormContext<TDraft, TOriginal>,\n ) => ReactNode;\n inputFilter?: undefined;\n defaultValue?: undefined;\n serialize?: undefined;\n deserialize?: undefined;\n onChange?: undefined;\n onBlur?: undefined;\n }>;\n\ntype Serialize<TDraft, TOriginal, TPath, TComponent extends FormFieldComponent> = (\n value: Value<TDraft, TPath>,\n formState: FormInstance<TDraft, TOriginal>,\n) => FieldValue<TComponent>;\n\ntype Deserialize<TDraft, TOriginal, TPath, TComponent extends FormFieldComponent> = (\n value: FieldChangeValue<TComponent>,\n formState: FormInstance<TDraft, TOriginal>,\n) => Value<TDraft, TPath>;\n\nexport type FormFieldPropsWithComponent<\n TDraft,\n TOriginal,\n TPath extends string,\n TComponent extends FormFieldComponent,\n> = FormFieldProps<TPath, TDraft> & {\n component?: TComponent;\n render?: undefined;\n} & NoInfer<\n {\n inputFilter?: (value: FieldChangeValue<TComponent>) => boolean;\n } & MakeOptional<\n Omit<ComponentPropsWithoutRef<TComponent>, 'id' | 'name' | 'value' | 'defaultValue'>,\n 'onChange' | 'onBlur'\n > &\n (Value<TDraft, TPath> extends Exclude<FieldValue<TComponent>, undefined>\n ? {\n defaultValue?: FieldValue<TComponent>;\n serialize?: Serialize<TDraft, TOriginal, TPath, TComponent>;\n }\n : Value<TDraft, TPath> extends FieldValue<TComponent>\n ?\n | {\n defaultValue: FieldValue<TComponent>;\n serialize?: Serialize<TDraft, TOriginal, TPath, TComponent>;\n }\n | {\n defaultValue?: FieldValue<TComponent>;\n serialize: Serialize<TDraft, TOriginal, TPath, TComponent>;\n }\n : {\n serialize: Serialize<TDraft, TOriginal, TPath, TComponent>;\n }) &\n (FieldChangeValue<TComponent> extends Value<TDraft, TPath>\n ? {\n deserialize?: Deserialize<TDraft, TOriginal, TPath, TComponent>;\n }\n : {\n deserialize: Deserialize<TDraft, TOriginal, TPath, TComponent>;\n })\n >;\n\nexport function FormField<\n TDraft,\n TOriginal,\n TPath extends string,\n TComponent extends FormFieldComponent,\n>(\n this: Form<TDraft, any>,\n {\n // id,\n name = '' as any,\n component,\n commitOnBlur,\n commitDebounce,\n render,\n inputFilter,\n defaultValue,\n serialize,\n deserialize = (x) => x as Value<TDraft, TPath>,\n onChange,\n onBlur,\n ...restProps\n }:\n | FormFieldPropsWithRender<TDraft, TOriginal, TPath>\n | FormFieldPropsWithComponent<TDraft, TOriginal, TPath, TComponent>,\n): React.JSX.Element | null {\n type T = FieldChangeValue<TComponent>;\n\n const form = this.useForm();\n const getFormState = () => ({ ...form, ...getDerivedState(form) });\n const [localValue, setLocalValue] = useState<T>();\n\n const value = this.useFormState((form) => {\n const value = form.getField(name as any).value;\n if (serialize) {\n return serialize(value as any, getFormState());\n }\n if (value !== undefined) {\n return value;\n }\n return defaultValue;\n });\n\n const setValue = (x: FieldChangeValue<TComponent>) =>\n form.getField(name as any).setValue(deserialize(x, getFormState()));\n\n const hasTriggeredValidations = this.useFormState((form) => form.hasTriggeredValidations);\n\n useEffect(() => {\n if (localValue === undefined || !commitDebounce) {\n return;\n }\n\n const timeout = setTimeout(() => {\n setValue(localValue);\n setLocalValue(undefined);\n }, commitDebounce);\n\n return () => clearTimeout(timeout);\n }, [localValue, commitDebounce]);\n\n const props = {\n name,\n value: localValue ?? value,\n onChange: (event: { target: { value: T } } | T, ...moreArgs: any[]) => {\n const value =\n typeof event === 'object' && event !== null && 'target' in event\n ? event.target.value\n : event;\n\n if (inputFilter && !inputFilter(value)) {\n return;\n }\n\n if (commitOnBlur || commitDebounce) {\n setLocalValue(value);\n } else {\n setValue(value);\n }\n\n onChange?.(event, ...moreArgs);\n },\n onBlur(...args: any[]) {\n if (localValue !== undefined) {\n setValue(localValue);\n setLocalValue(undefined);\n }\n\n onBlur?.(...args);\n },\n } as FormFieldComponentProps<Value<TDraft, TPath>, TPath>;\n\n if (render) {\n return (\n <>\n {render(props, { ...form.getField(name as any), hasTriggeredValidations } as any, form) ??\n null}\n </>\n );\n }\n\n if (component) {\n return createElement(component, { ...restProps, ...props });\n }\n\n return null;\n}\n","import { type GetKeys, type Join, type PathAsString, type Value } from '@lib/path';\nimport { Fragment, useCallback, type ReactNode } from 'react';\nimport { type FieldHelperMethods, type Form } from './form';\n\nexport type ElementName<TDraft, TPath extends string> = keyof {\n [Path in TPath as Join<Path, GetKeys<NonNullable<Value<TDraft, Path>>> & (string | number)>]: 1;\n};\n\nexport interface FormForEachProps<TDraft, TPath extends string> {\n name: TPath & PathAsString<TDraft>;\n renderElement?: (props: {\n name: ElementName<TDraft, TPath>;\n key: `${GetKeys<NonNullable<Value<TDraft, TPath>>> & (string | number)}`;\n index: number;\n remove: () => void;\n }) => ReactNode;\n children?: (\n props: {\n setValue: (\n value: Value<TDraft, TPath> | ((value: Value<TDraft, TPath>) => Value<TDraft, TPath>),\n ) => void;\n } & FieldHelperMethods<TDraft, TPath>,\n ) => ReactNode;\n}\n\nexport function FormForEach<TDraft, TPath extends string>(\n this: Form<TDraft, any>,\n { name, renderElement, children }: FormForEachProps<TDraft, TPath>,\n): React.JSX.Element {\n const form = this.useForm();\n\n const names = this.useFormState(() => {\n const field = form.getField(name as any) as any;\n return field.names as any[];\n });\n\n const add = useCallback(\n (...args: any[]) => {\n const field = form.getField(name as any) as any;\n field.add(...args);\n },\n [form],\n );\n\n const remove = useCallback(\n (key: any) => {\n const field = form.getField(name as any) as any;\n field.remove(key);\n },\n [form],\n );\n\n const setValue = useCallback(\n (value: Value<TDraft, TPath> | ((value: Value<TDraft, TPath>) => Value<TDraft, TPath>)) => {\n const field = form.getField(name as any) as any;\n field.setValue(value);\n },\n [form],\n );\n\n return (\n <>\n {renderElement &&\n names.map((name, index) => {\n const key = name.split('.').pop();\n\n return (\n <Fragment key={key}>\n {renderElement({\n name,\n key,\n index,\n remove: () => remove(key),\n })}\n </Fragment>\n );\n })}\n\n {children?.({\n names,\n add,\n remove,\n setValue,\n } as any)}\n </>\n );\n}\n","import type { Duration } from '@core';\nimport { calcDuration } from '@lib/calcDuration';\nimport { debounce } from '@lib/debounce';\nimport { deepEqual } from '@lib/equals';\nimport type { MaybePromise } from '@lib/maybePromise';\nimport { queue } from '@lib/queue';\nimport { useEffect, useMemo, useRef } from 'react';\nimport type { FormContext } from './form';\n\nexport interface FormAutosaveOptions<TDraft, TOriginal> {\n save: (draft: TDraft, form: FormContext<TDraft, TOriginal>) => MaybePromise<void>;\n debounce?: Duration;\n resetAfterSave?: boolean;\n}\n\nexport function useFormAutosave<TDraft, TOriginal extends TDraft>(\n form: FormContext<TDraft, TOriginal>,\n): void {\n const { formState, options, getDraft } = form;\n const debounceTime = calcDuration(options.autoSave?.debounce ?? 2_000);\n const latestRef = useRef({ options });\n const lastValue = useRef<TDraft | undefined>(undefined);\n const q = useMemo(() => queue(), []);\n\n const run = useMemo(\n () =>\n debounce(async () => {\n const { options } = latestRef.current;\n const save = options.autoSave?.save;\n const draft = getDraft();\n\n lastValue.current = draft;\n\n q.clear();\n\n q(async () => {\n try {\n formState.set('saveInProgress', true);\n await save?.(draft, form);\n\n if (q.size === 0 && options.autoSave?.resetAfterSave) {\n form.reset();\n }\n } finally {\n formState.set('saveInProgress', false);\n\n if (q.size === 0) {\n formState.set('saveScheduled', false);\n }\n }\n });\n }, debounceTime),\n [formState, debounceTime],\n );\n\n useEffect(() => {\n if (!options.autoSave?.save) {\n return;\n }\n\n return formState\n .map((state) => state.draft)\n .subscribe(\n () => {\n if (deepEqual(getDraft(), lastValue.current)) {\n return;\n }\n\n run();\n formState.set('saveScheduled', true);\n },\n { runNow: false },\n );\n }, [formState]);\n\n useEffect(() => {\n latestRef.current = { options };\n });\n}\n","import { createStore, type Store, type Update } from '@core';\nimport { autobind } from '@lib/autobind';\nimport { deepEqual } from '@lib/equals';\nimport { isObject } from '@lib/helpers';\nimport {\n type PathAsString,\n type Value,\n type WildcardPathAsString,\n type WildcardValue,\n} from '@lib/path';\nimport { get, join, set } from '@lib/propAccess';\nimport type { Object_ } from '@lib/typeHelpers';\nimport { getWildCardMatches } from '@lib/wildcardMatch';\nimport {\n createContext,\n useContext,\n useEffect,\n useMemo,\n useRef,\n type Context,\n type FormEvent,\n type FunctionComponent,\n type HTMLProps,\n type ReactNode,\n} from 'react';\nimport { useStore, type UseStoreOptions } from '../useStore';\nimport {\n FormField,\n type FormFieldComponent,\n type FormFieldPropsWithComponent,\n type FormFieldPropsWithRender,\n} from './formField';\nimport { FormForEach, type ElementName, type FormForEachProps } from './formForEach';\nimport { useFormAutosave, type FormAutosaveOptions } from './useFormAutosave';\n\n/// /////////////////////////////////////////////////////////////////////////////\n// Form types\n/// /////////////////////////////////////////////////////////////////////////////\n\nexport interface Transform<TDraft> {\n (value: TDraft, store: Store<TDraft>): void | TDraft;\n}\n\nexport interface FormOptions<TDraft, TOriginal> {\n defaultValue: TDraft;\n validations?: Validations<TDraft, TOriginal>;\n localizeError?: (error: string, field: string) => string | undefined;\n autoSave?: FormAutosaveOptions<TDraft, TOriginal>;\n transform?: Transform<TDraft>;\n validatedClass?: string;\n}\n\nexport type Validations<TDraft, TOriginal> = {\n [TPath in WildcardPathAsString<TDraft>]?: Record<string, Validation<TDraft, TOriginal, TPath>>;\n} & Record<string, Record<string, Validation<TDraft, TOriginal, any>>>;\n\nexport type Validation<TDraft, TOriginal, TPath> = (\n value: WildcardValue<TDraft, TPath>,\n context: {\n draft: TDraft;\n original: TOriginal;\n field: PathAsString<TDraft> | '';\n },\n) => boolean;\n\nexport type Field<TDraft, TOriginal, TPath extends string> = {\n originalValue: Value<TOriginal, TPath> | undefined;\n value: Value<TDraft, TPath>;\n setValue: (value: Update<Value<TDraft, TPath>>) => void;\n removeValue: () => void;\n hasChange: boolean;\n errors: string[];\n} & (Value<TDraft, TPath> extends Object_ ? FieldHelperMethods<TDraft, TPath> : {});\n\nexport type FieldHelperMethods<TDraft, TPath extends string> = {\n names: ElementName<TDraft, TPath>[];\n add: NonNullable<Value<TDraft, TPath>> extends readonly (infer T)[]\n ? (element: T) => void\n : NonNullable<Value<TDraft, TPath>> extends Record<infer K, infer V>\n ? (key: K, value: V) => void\n : never;\n remove: Value<TDraft, TPath> extends readonly any[]\n ? (index: number) => void\n : (key: string) => void;\n};\n\nexport interface FormState<TDraft> {\n draft: TDraft | undefined;\n hasTriggeredValidations: boolean;\n saveScheduled: boolean;\n saveInProgress: boolean;\n}\n\nexport interface FormDerivedState<TDraft> {\n draft: TDraft;\n hasTriggeredValidations: boolean;\n saveScheduled: boolean;\n saveInProgress: boolean;\n hasChanges: boolean;\n errors: Map<string, string[]>;\n isValid: boolean;\n}\n\nexport interface FormContext<TDraft, TOriginal> {\n formState: Store<FormState<TDraft>>;\n options: FormOptions<TDraft, TOriginal>;\n original: TOriginal | undefined;\n getField: <TPath extends string>(path: TPath) => Field<TDraft, TOriginal, TPath>;\n getDraft: () => TDraft;\n hasTriggeredValidations: () => boolean;\n saveScheduled: () => boolean;\n saveInProgress: () => boolean;\n hasChanges: () => boolean;\n getErrors: () => Map<string, string[]>;\n isValid: () => boolean;\n validate: () => boolean;\n reset: () => void;\n}\n\nexport interface FormInstance<TDraft, TOriginal>\n extends FormDerivedState<TDraft>,\n Pick<\n FormContext<TDraft, TOriginal>,\n 'options' | 'original' | 'getField' | 'validate' | 'reset'\n > {}\n\n/// /////////////////////////////////////////////////////////////////////////////\n// Implementation\n/// /////////////////////////////////////////////////////////////////////////////\n\nfunction FormContainer({\n form,\n ...formProps\n}: {\n form: Form<any, any>;\n onSubmit?: (\n event: FormEvent<HTMLFormElement>,\n form: FormInstance<any, any>,\n ) => void | Promise<void>;\n} & Omit<HTMLProps<HTMLFormElement>, 'form' | 'onSubmit'>) {\n const formInstance = form.useForm();\n const hasTriggeredValidations = form.useFormState((state) => state.hasTriggeredValidations);\n\n const formRef = useRef<HTMLFormElement>(null);\n\n function updateValidity(errors: Map<string, string[]>, buttonElement?: HTMLButtonElement) {\n const formElement = formRef.current;\n if (!formElement) {\n return;\n }\n\n const localizedErrors = new Map(\n [...errors.entries()].map(\n ([field, errors]) =>\n [\n field,\n errors.map((error) => formInstance.options.localizeError?.(error, field) ?? error),\n ] as const,\n ),\n );\n\n for (const element of Array.from(formElement.elements)) {\n if ('name' in element && 'setCustomValidity' in element) {\n (element as HTMLObjectElement).setCustomValidity(\n localizedErrors.get((element as HTMLObjectElement).name)?.join('\\n') ?? '',\n );\n }\n }\n\n if (buttonElement && 'setCustomValidity' in buttonElement) {\n const errorString = [...errors.values()].flat().join('\\n');\n\n buttonElement.setCustomValidity(errorString);\n }\n }\n\n useEffect(() => {\n return formInstance.formState\n .map(() => formInstance.getErrors())\n .subscribe((errors) => updateValidity(errors));\n }, []);\n\n return (\n <form\n ref={formRef}\n noValidate\n {...formProps}\n className={[\n formProps.className,\n hasTriggeredValidations ? (formInstance.options.validatedClass ?? 'validated') : undefined,\n ]\n .filter(Boolean)\n .join(' ')}\n onSubmit={async (event) => {\n if (formInstance.saveInProgress()) {\n return;\n }\n\n try {\n formInstance.formState.set('saveInProgress', true);\n event.preventDefault();\n\n const formElement = event.currentTarget;\n const buttonElement =\n event.nativeEvent instanceof SubmitEvent &&\n event.nativeEvent.submitter instanceof HTMLButtonElement\n ? event.nativeEvent.submitter\n : undefined;\n\n updateValidity(formInstance.getErrors(), buttonElement);\n\n formElement.reportValidity();\n\n const isValid = formInstance.validate();\n if (isValid) {\n await formProps.onSubmit?.(event, {\n ...formInstance,\n ...getDerivedState(formInstance),\n });\n }\n } finally {\n formInstance.formState.set('saveInProgress', false);\n }\n }}\n />\n );\n}\n\nfunction getField<TDraft, TOriginal extends TDraft, TPath extends string>(\n form: FormContext<TDraft, TOriginal>,\n path: TPath,\n): Field<TDraft, TOriginal, TPath> {\n const field = {\n get originalValue() {\n return form.original !== undefined ? get(form.original as any, path as any) : undefined;\n },\n\n get value() {\n const draft = form.getDraft();\n return get(draft ?? form.original ?? form.options.defaultValue, path as any);\n },\n\n setValue(update: Update<Value<TDraft, TPath>>) {\n form.formState.set('draft', (draft = form.original ?? form.options.defaultValue) => {\n if (update instanceof Function) {\n update = update(get(draft, path as any) as Value<TDraft, TPath>);\n }\n\n return set(draft, path as any, update as any);\n });\n },\n\n get hasChange() {\n return !deepEqual(this.originalValue, this.value, { undefinedEqualsAbsent: true });\n },\n\n get errors() {\n const errors = form.getErrors();\n return errors.get(path) ?? [];\n },\n\n get names(): any {\n const { value } = this;\n\n if (Array.isArray(value)) {\n return value.map((_, index) => join(path, String(index)));\n }\n\n if (isObject(value)) {\n return Object.keys(value).map((key) => join(path, key));\n }\n\n return [];\n },\n\n add(...args: any[]) {\n this.setValue((value): any => {\n if (!value) {\n throw new Error(`Cannot add element to ${JSON.stringify(value)}`);\n }\n\n if (Array.isArray(value)) {\n return [...(value ?? []), args[0]];\n }\n\n if (isObject(value)) {\n return {\n ...value,\n [args[0]]: args[1],\n };\n }\n\n throw new Error(`Cannot add element to ${JSON.stringify(value)}`);\n });\n },\n\n remove(key: string | number) {\n this.setValue((value): any => {\n if (!value) {\n throw new Error(`Cannot remove element from ${JSON.stringify(value)}`);\n }\n\n if (Array.isArray(value)) {\n return value.filter((_, index) => index !== Number(key));\n }\n\n if (isObject(value)) {\n const { [key]: _, ...rest } = value as Record<string | number, unknown>;\n return rest;\n }\n\n throw new Error(`Cannot remove element from ${JSON.stringify(value)}`);\n });\n },\n };\n\n return field as any;\n}\n\nfunction getErrors<TDraft, TOriginal>(\n draft: TDraft,\n original: TOriginal | undefined,\n validations: FormOptions<TDraft, TOriginal>['validations'],\n) {\n const errors = new Map<string, string[]>();\n\n for (const [path, block] of Object.entries(validations ?? {})) {\n for (const [validationName, validate] of Object.entries(\n block as Record<string, Validation<any, any, any>>,\n )) {\n let matched = false;\n\n for (const [field, value] of Object.entries(getWildCardMatches(draft, path))) {\n matched = true;\n if (!validate(value, { draft, original, field })) {\n const fieldErrors = errors.get(field) ?? [];\n fieldErrors.push(validationName);\n errors.set(field, fieldErrors);\n }\n }\n\n if (!matched && !path.includes('*')) {\n if (!validate(undefined, { draft, original, field: path })) {\n const fieldErrors = errors.get(path) ?? [];\n fieldErrors.push(validationName);\n errors.set(path, fieldErrors);\n }\n }\n }\n }\n\n return errors;\n}\n\nexport function getDerivedState<TDraft>(\n instance: FormContext<TDraft, any>,\n): FormDerivedState<TDraft> {\n return {\n draft: instance.getDraft(),\n hasTriggeredValidations: instance.hasTriggeredValidations(),\n saveScheduled: instance.saveScheduled(),\n saveInProgress: instance.saveInProgress(),\n hasChanges: instance.hasChanges(),\n errors: instance.getErrors(),\n isValid: instance.isValid(),\n };\n}\n\nexport class Form<TDraft, TOriginal extends TDraft = TDraft> {\n context: Context<FormContext<TDraft, TOriginal> | null> = createContext<FormContext<\n TDraft,\n TOriginal\n > | null>(null);\n\n constructor(public readonly options: FormOptions<TDraft, TOriginal>) {\n autobind(Form);\n }\n\n useForm(): FormContext<TDraft, TOriginal> {\n const context = useContext(this.context);\n\n if (!context) {\n throw new Error('Form context not found');\n }\n\n return context;\n }\n\n useFormState<S>(\n selector: (state: FormInstance<TDraft, TOriginal>) => S,\n useStoreOptions?: UseStoreOptions<S>,\n ): S {\n const form = this.useForm();\n\n return useStore(\n form.formState,\n () =>\n selector({\n ...form,\n ...getDerivedState(form),\n }),\n\n useStoreOptions,\n );\n }\n\n useField<TPath extends string>(\n path: TPath,\n useStoreOptions?: UseStoreOptions<any>,\n ): Field<TDraft, TOriginal, TPath> {\n const form = this.useForm();\n this.useFormState((form) => [form.getField(path).value, form.original], useStoreOptions);\n return form.getField(path);\n }\n\n // ///////////////////////////////////////////////////////////////////////////\n // React Components\n // ///////////////////////////////////////////////////////////////////////////\n\n Form({\n original,\n defaultValue,\n validations,\n localizeError,\n autoSave,\n transform,\n validatedClass,\n ...formProps\n }: {\n original?: TOriginal;\n onSubmit?: (event: FormEvent<HTMLFormElement>, form: FormInstance<TDraft, TOriginal>) => void;\n } & Partial<FormOptions<TDraft, TOriginal>> &\n Omit<HTMLProps<HTMLFormElement>, 'defaultValue' | 'autoSave' | 'onSubmit'>): React.JSX.Element {\n const options: FormOptions<TDraft, TOriginal> = {\n defaultValue: { ...this.options.defaultValue, ...defaultValue },\n validations: { ...this.options.validations, ...validations } as Validations<\n TDraft,\n TOriginal\n >,\n localizeError: localizeError ?? this.options.localizeError,\n autoSave: autoSave ?? this.options.autoSave,\n transform: transform ?? this.options.transform,\n validatedClass: validatedClass ?? this.options.validatedClass,\n };\n\n const formState = useMemo(() => {\n return createStore<FormState<TDraft>>({\n draft: undefined,\n hasTriggeredValidations: false,\n saveScheduled: false,\n saveInProgress: false,\n });\n }, []);\n\n let lastDraft: TDraft | undefined;\n const cache = new Map<string, unknown>();\n function lazy<T>(key: string, fn: () => T): T {\n if (lastDraft !== formState.get().draft) {\n cache.clear();\n lastDraft = formState.get().draft;\n }\n\n let value = cache.get(key);\n if (!cache.has(key)) {\n value = fn();\n cache.set(key, value);\n }\n\n return value as T;\n }\n\n const context: FormContext<TDraft, TOriginal> = {\n formState,\n options,\n original,\n\n getField() {\n throw new Error('Not implemented');\n },\n\n getDraft() {\n return formState.get().draft ?? original ?? options.defaultValue;\n },\n\n hasTriggeredValidations() {\n return formState.get().hasTriggeredValidations;\n },\n\n saveScheduled() {\n return formState.get().saveScheduled;\n },\n\n saveInProgress() {\n return formState.get().saveInProgress;\n },\n\n hasChanges() {\n return lazy(\n 'hasChanges',\n () =>\n !deepEqual(this.getDraft(), original ?? options.defaultValue, {\n undefinedEqualsAbsent: true,\n }),\n );\n },\n\n getErrors() {\n return lazy('getErrors', () => getErrors(this.getDraft(), original, options.validations));\n },\n\n isValid() {\n return lazy('isValid', () => this.getErrors().size === 0);\n },\n\n validate() {\n formState.set('hasTriggeredValidations', true);\n return this.isValid();\n },\n\n reset() {\n formState.set('draft', undefined);\n formState.set('hasTriggeredValidations', false);\n },\n };\n\n context.getField = (path) => lazy(path, () => getField(context, path));\n\n useEffect(() => {\n const transform = options.transform;\n if (!transform) {\n return;\n }\n\n const store = formState.map(\n (state) => state.draft ?? original ?? options.defaultValue,\n (draft) => (state) => ({ ...state, draft }),\n );\n\n return store.subscribe((value) => {\n const result = transform(value, store);\n\n if (result !== undefined && !deepEqual(result, value)) {\n store.set(result);\n }\n });\n }, [original, defaultValue, options.transform]);\n\n useFormAutosave(context);\n\n return (\n <this.context.Provider value={context}>\n <FormContainer {...formProps} form={this} />\n </this.context.Provider>\n );\n }\n\n FormState<S>({\n selector,\n children,\n }: {\n selector: (form: FormInstance<TDraft, TOriginal>) => S;\n children: (selectedState: S) => ReactNode;\n }): React.JSX.Element {\n const selectedState = this.useFormState(selector);\n return <>{children(selectedState)}</>;\n }\n\n Field<const TPath extends string>(\n props: FormFieldPropsWithRender<TDraft, TOriginal, TPath>,\n ): React.JSX.Element;\n\n Field<const TPath extends string, const TComponent extends FormFieldComponent = 'input'>(\n props: FormFieldPropsWithComponent<TDraft, TOriginal, TPath, TComponent>,\n ): React.JSX.Element;\n\n Field(props: any): React.JSX.Element {\n return Reflect.apply(FormField, this, [{ component: 'input', ...props }]);\n }\n\n ForEach<const TPath extends string>(props: FormForEachProps<TDraft, TPath>): React.JSX.Element {\n return Reflect.apply(FormForEach, this, [props]);\n }\n\n withForm<TProps extends Record<string, unknown>>(\n Component: React.ComponentType<TProps>,\n formProps?: Parameters<this['Form']>[0],\n ): FunctionComponent<TProps> {\n const { Form } = this;\n return function FormWrapper(props: TProps) {\n return (\n <Form {...formProps}>\n <Component {...props} />\n </Form>\n );\n };\n }\n}\n\nexport function createForm<TDraft, TOriginal extends TDraft = TDraft>(\n options: FormOptions<TDraft, TOriginal>,\n): Form<TDraft, TOriginal> {\n return new Form(options);\n}\n","import React, { createContext, useContext, type Context, type ReactNode } from 'react';\n\nexport type Location = string | { pathname: string; search: string; hash: string };\n\nexport interface UrlContextType {\n location: Location;\n navigate: (navigate: (from: Location) => string) => void;\n}\n\nexport type UrlContextProviderProps = { children?: ReactNode } & (\n | { location: UrlContextType['location'] }\n | { locationHook: () => UrlContextType['location'] }\n) &\n ({ navigate: UrlContextType['navigate'] } | { navigateHook: () => UrlContextType['navigate'] });\n\nexport const UrlContext: Context<UrlContextType | undefined> = createContext<\n UrlContextType | undefined\n>(undefined);\n\nexport function UrlProvider({ children, ...props }: UrlContextProviderProps): React.JSX.Element {\n const location = 'location' in props ? props.location : props.locationHook();\n const navigate = 'navigate' in props ? props.navigate : props.navigateHook();\n\n return <UrlContext.Provider value={{ location, navigate }}>{children}</UrlContext.Provider>;\n}\n\nexport function useUrlContext(): UrlContextType {\n const context = useContext(UrlContext);\n if (!context) {\n throw new Error('useUrlContext must be used within a UrlContextProvider');\n }\n return context;\n}\n","import { fromExtendedJsonString, toExtendedJsonString } from '@lib/extendedJson';\nimport type { Location } from '@react/url/urlContext';\n\nexport function defaultDeserializer<T>(value: string): T {\n if (value === undefined) {\n return undefined as T;\n }\n\n try {\n return fromExtendedJsonString(value) as T;\n } catch {\n return undefined as T;\n }\n}\n\nexport function defaultSerializer<T>(value: T): string {\n return toExtendedJsonString(value);\n}\n\nexport function parseLocation(location: Location): URL {\n if (typeof location !== 'string') {\n location = `${location.pathname}${location.search}${location.hash}`;\n }\n\n return new URL(location, window.location.origin);\n}\n\nexport function createStorageKey(id: string, key: string) {\n return `cross-state:url:${id}:${key}`;\n}\n","import { defaultDeserializer, defaultSerializer } from '@react/url/urlHelpers';\n\nexport interface UrlOptions<T> {\n key: string;\n type?: 'search' | 'hash';\n serialize?: (value: T) => string;\n deserialize?: (value: string) => T;\n defaultValue: T;\n writeDefaultValue?: boolean;\n onCommit?: (value: T) => void;\n persist?: { id: string } | null;\n}\n\nexport interface UrlOptionsWithoutDefaults<T>\n extends Omit<UrlOptions<T | undefined>, 'defaultValue'> {\n defaultValue?: T | undefined;\n}\n\nexport function createUrlOptions<T>(options: UrlOptions<T>): Required<UrlOptions<T>>;\nexport function createUrlOptions<T>(\n options: UrlOptionsWithoutDefaults<T>,\n): Required<UrlOptions<T | undefined>>;\nexport function createUrlOptions<T>({\n key,\n type = 'hash',\n serialize = defaultSerializer,\n deserialize = defaultDeserializer,\n defaultValue = undefined as T,\n writeDefaultValue = false,\n onCommit = () => undefined,\n persist = null,\n}: UrlOptionsWithoutDefaults<T>): Required<UrlOptionsWithoutDefaults<T>> {\n return {\n key,\n type,\n serialize,\n deserialize,\n defaultValue,\n writeDefaultValue,\n onCommit,\n persist,\n };\n}\n","import type { Update, UpdateFunction } from '@core';\nimport { useUrlContext } from '@react/url/urlContext';\nimport { createStorageKey, parseLocation } from '@react/url/urlHelpers';\nimport {\n createUrlOptions,\n type UrlOptions,\n type UrlOptionsWithoutDefaults,\n} from '@react/url/urlOptions';\nimport type { UrlStore } from '@react/url/urlStore';\nimport { useEffect, useMemo } from 'react';\n\nexport function useUrlParam<T>(store: UrlStore<T>): [T, update: UpdateFunction<T>];\nexport function useUrlParam<T>(options: UrlOptions<T>): [T, update: UpdateFunction<T>];\nexport function useUrlParam<T>(\n options: UrlOptionsWithoutDefaults<T>,\n): [T | undefined, update: UpdateFunction<T | undefined>];\nexport function useUrlParam<T>(\n input: UrlStore<T> | UrlOptionsWithoutDefaults<T>,\n): [T, update: UpdateFunction<T>] {\n const { key, type, serialize, deserialize, defaultValue, writeDefaultValue, onCommit, persist } =\n createUrlOptions('options' in input ? input.options : (input as UrlOptions<T>));\n\n const { location, navigate } = useUrlContext();\n const url = parseLocation(location);\n const params = new URLSearchParams(url[type].slice(1));\n const urlValue = params.get(key);\n\n const storageKey = persist && createStorageKey(persist.id, key);\n const storageValue = storageKey ? localStorage.getItem(storageKey) : null;\n\n const value = useMemo(\n () =>\n urlValue !== null\n ? deserialize(urlValue)\n : storageValue !== null\n ? deserialize(storageValue)\n : defaultValue,\n [urlValue],\n );\n\n function commit(value: T) {\n const serializedValue = serialize(value);\n\n navigate((location) => {\n const url = parseLocation(location);\n const params = new URLSearchParams(url[type].slice(1));\n\n if (!writeDefaultValue && serializedValue === serialize(defaultValue)) {\n params.delete(key);\n } else {\n params.set(key, serializedValue);\n }\n\n url[type] = params.toString();\n return url.toString().replace(window.location.origin, '');\n });\n\n if (storageKey) {\n localStorage.setItem(storageKey, serializedValue);\n }\n\n onCommit?.(value);\n }\n\n function update(update: Update<T>) {\n if (update instanceof Function) {\n update = update(value);\n }\n\n commit(update);\n }\n\n useEffect(() => {\n if (urlValue !== null) {\n commit(deserialize(urlValue));\n }\n }, [urlValue]);\n\n useEffect(() => {\n if (urlValue === null && storageValue !== null) {\n commit(deserialize(storageValue));\n } else if (urlValue === null && writeDefaultValue) {\n commit(defaultValue);\n }\n }, []);\n\n return [value, update];\n}\n","import type { UpdateFunction } from '@core';\nimport type { Location } from '@react/url/urlContext';\nimport { parseLocation } from '@react/url/urlHelpers';\nimport {\n createUrlOptions,\n type UrlOptions,\n type UrlOptionsWithoutDefaults,\n} from '@react/url/urlOptions';\nimport { useUrlParam } from '@react/url/useUrlParam';\n\nexport class UrlStore<T> {\n constructor(public readonly options: Required<UrlOptions<T>>) {}\n\n useStore(): T {\n return useUrlParam(this)[0];\n }\n\n useProp(): [T, update: UpdateFunction<T>] {\n return useUrlParam(this);\n }\n\n parse(location: Location): T | undefined {\n const url = parseLocation(location);\n const params = new URLSearchParams(url[this.options.type].slice(1));\n const urlValue = params.get(this.options.key);\n return urlValue !== null ? this.options.deserialize(urlValue) : undefined;\n }\n}\nexport function createUrlStore<T>(options: UrlOptions<T>): UrlStore<T>;\nexport function createUrlStore<T>(options: UrlOptionsWithoutDefaults<T>): UrlStore<T | undefined>;\nexport function createUrlStore<T>(options: UrlOptionsWithoutDefaults<T>) {\n return new UrlStore(createUrlOptions(options));\n}\n","import { startTransition, useEffect, useMemo, useRef, useState } from 'react';\nimport { type Duration } from '@core';\nimport { debounce } from '@lib/debounce';\nimport { simpleHash } from '@lib/hash';\nimport { throttle } from '@lib/throttle';\n\nexport interface UseDecoupledStateOptions<T> {\n debounce?: Duration;\n throttle?: Duration;\n onCommit?: (value: T) => void;\n}\n\nexport function useDecoupledState<T>(\n value: T,\n onChange: (value: T) => void,\n options: UseDecoupledStateOptions<T> = {},\n): [state: T, setState: (value: T) => void] {\n const [dirty, setDirty] = useState<{ v: T }>();\n const ref = useRef({ onChange, onCommit: options.onCommit });\n\n useEffect(() => {\n ref.current = { onChange, onCommit: options.onCommit };\n }, [onChange]);\n\n const update = useMemo(() => {\n const { onChange, onCommit } = ref.current;\n\n const update = (value: T) => {\n onChange(value);\n setDirty(undefined);\n onCommit?.(value);\n };\n\n let delayedUpdate: (value: T) => void;\n\n if (options.debounce) {\n delayedUpdate = debounce(update, options.debounce);\n } else if (options.throttle) {\n delayedUpdate = throttle(update, options.throttle);\n } else {\n delayedUpdate = (value) => startTransition(() => update(value));\n }\n\n return (value: T) => {\n setDirty({ v: value });\n delayedUpdate(value);\n };\n }, [simpleHash([options.debounce, options.throttle])]);\n\n return [dirty ? dirty.v : value, update];\n}\n"],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "cross-state",
3
- "version": "0.55.3",
3
+ "version": "0.55.5",
4
4
  "description": "(React) state library",
5
5
  "license": "ISC",
6
6
  "repository": "schummar/cross-state",