npm - react-magic-search-params - Versions diffs - 0.2.0 → 0.3.0 - Mend

react-magic-search-params 0.2.0 → 0.3.0

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.

Files changed (7) hide show

package/dist/react-magic-search-params.cjs.development.js.map +1 -1
package/dist/react-magic-search-params.cjs.production.min.js.map +1 -1
package/dist/react-magic-search-params.esm.js.map +1 -1
package/dist/useMagicSearchParams.d.ts +1 -1
package/package.json +3 -2
package/src/index.d.ts +2 -0
package/src/useMagicSearchParams.ts +1 -1

package/dist/react-magic-search-params.cjs.development.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"react-magic-search-params.cjs.development.js","sources":["../src/useMagicSearchParams.ts"],"sourcesContent":["import { useSearchParams } from 'react-router-dom'\r\nimport { useMemo, useEffect, useRef, useCallback } from 'react'\r\n\r\n\r\n// Custom hook with advanced techniques to handle search parameters for any pagination\r\n\r\ntype CommonParams = {\r\n page?: number\r\n page_size?: number\r\n}\r\n/\r\nMaps all properties of M (mandatory) as required\r\nand all properties of O (optional) as optional. \r\n/\r\ntype MergeParams<M, O> = {\r\n [K in keyof M]: M[K]\r\n} & {\r\n [K in keyof O]?: O[K]\r\n}\r\n/*\r\n Interface for the configuration object that the hook receives \r\n /\r\ninterface UseMagicSearchParamsOptions<\r\n M extends Record<string, unknown>,\r\n O extends Record<string, unknown>\r\n> {\r\n mandatory: M \r\n optional?: O\r\n defaultParams?: Partial<MergeParams<M, O>>\r\n forceParams?: Partial<MergeParams<M, O>> // transform all to partial to avoid errors\r\n arraySerialization?: 'csv' \| 'repeat' \| 'brackets' // technical to serialize arrays in the URL\r\n omitParamsByValues?: Array<'all' \| 'default' \| 'unknown' \| 'none' \| 'void '> \r\n}\r\n\r\n/* \r\nGeneric hook to handle search parameters in the URL\r\n@param mandatory - Mandatory parameters (e.g., page=1, page_size=10, etc.)\r\n@param optional - Optional parameters (e.g., order, search, etc.)\r\n@param defaultParams - Default parameters sent in the URL on initialization\r\n@param forceParams - Parameters forced into the URL regardless of user input\r\n@param omitParamsByValues - Parameters omitted if they have specific values \r\n/\r\nexport const useMagicSearchParams = <\r\n M extends Record<string, unknown> & CommonParams,\r\n O extends Record<string, unknown>,\r\n>({\r\n mandatory = {} as M,\r\n optional = {} as O,\r\n defaultParams = {} as Partial<MergeParams<M, O>>,\r\n arraySerialization = 'csv',\r\n forceParams = {} as {} as Partial<MergeParams<M, O>>,\r\n omitParamsByValues = [] as Array<'all' \| 'default' \| 'unknown' \| 'none' \| 'void '>\r\n}: UseMagicSearchParamsOptions<M, O>)=> {\r\n\r\n\r\n const [searchParams, setSearchParams] = useSearchParams() \r\n // Ref to store subscriptions: { paramName: [callback1, callback2, ...] }\r\n const subscriptionsRef = useRef<Record<string, Array<() => unknown>>>({}); \r\n const previousParamsRef = useRef<Record<string, unknown>>({})\r\n\r\n const TOTAL_PARAMS_PAGE: MergeParams<M, O> = useMemo(() => {\r\n return { ...mandatory, ...optional };\r\n }, [mandatory, optional]);\r\n\r\n const PARAM_ORDER = useMemo(() => {\r\n return Array.from(Object.keys(TOTAL_PARAMS_PAGE))\r\n }, [TOTAL_PARAMS_PAGE])\r\n\r\n // we get the keys that are arrays according to TOTAL_PARAMS_PAGE since these require special treatment in the URL due to serialization mode\r\n const ARRAY_KEYS = useMemo(() => {\r\n return Object.keys(TOTAL_PARAMS_PAGE).filter(\r\n (key) => Array.isArray(TOTAL_PARAMS_PAGE[key])\r\n );\r\n }, [TOTAL_PARAMS_PAGE])\r\n\r\n const appendArrayValues = (\r\n finallyParams: Record<string, unknown>,\r\n newParams: Record<string, string \| string[] \| unknown>\r\n ): Record<string, unknown> => {\r\n \r\n // Note: We cannot modify the object of the final parameters directly, as immutability must be maintained\r\n const updatedParams = { ...finallyParams };\r\n \r\n\r\n if (ARRAY_KEYS.length === 0) return updatedParams;\r\n \r\n ARRAY_KEYS.forEach((key) => {\r\n // We use the current values directly from searchParams (source of truth)\r\n // This avoids depending on finallyParams in which the arrays have been omitted\r\n let currentValues = []; \r\n switch (arraySerialization) {\r\n case 'csv': {\r\n const raw = searchParams.get(key) \|\| '';\r\n // For csv we expect \"value1,value2,...\" (no prefix)\r\n currentValues = raw.split(',')\r\n .map((v) => v.trim())\r\n .filter(Boolean) as Array<string>\r\n break;\r\n }\r\n case 'repeat': {\r\n // Here we get all ocurrences of key\r\n const urlParams = searchParams.getAll(key) as Array<string>\r\n currentValues = urlParams.length > 0 ? urlParams : []\r\n \r\n console.log({REPEAT: currentValues})\r\n break;\r\n }\r\n case 'brackets': {\r\n // Build URLSearchParams from current parameters (to ensure no serialized values are taken previously)\r\n const urlParams = searchParams.getAll(`${key}[]`) as Array<string>\r\n currentValues = urlParams.length > 0 ? urlParams : []\r\n console.log({BRACKETS: urlParams})\r\n \r\n \r\n break;\r\n }\r\n default: {\r\n // Mode by default works as csv\r\n const raw = searchParams.get(key) ?? '';\r\n currentValues = raw.split(',')\r\n .map((v) => v.trim())\r\n .filter(Boolean);\r\n }\r\n break; \r\n }\r\n // Update array values with new ones\r\n \r\n if (newParams[key] !== undefined) {\r\n const incoming = newParams[key];\r\n let combined: string[] = []\r\n if (typeof incoming === 'string') {\r\n // If it is a string, it is toggled (add/remove)\r\n combined = currentValues.includes(incoming)\r\n ? currentValues.filter((v) => v !== incoming)\r\n : [...currentValues, incoming];\r\n console.log({currentValues})\r\n console.log({incoming})\r\n console.log({CONBINED_STRING: combined})\r\n } else if (Array.isArray(incoming)) {\r\n // if an array is passed, repeated values are merged into a single value\r\n // Note: Set is used to remove duplicates\r\n combined = Array.from(new Set([ ...incoming]));\r\n console.log({incoming})\r\n console.log({combined})\r\n } else {\r\n \r\n combined = currentValues;\r\n }\r\n\r\n updatedParams[key] = combined\r\n\r\n }\r\n });\r\n console.log({updatedParams})\r\n return updatedParams\r\n };\r\n\r\n const transformParamsToURLSearch = (params: Record<string, unknown>): URLSearchParams => {\r\n console.log({PARAMS_RECIBIDOS_TRANSFORM: params})\r\n\r\n const newParam: URLSearchParams = new URLSearchParams()\r\n\r\n const paramsKeys = Object.keys(params)\r\n\r\n for (const key of paramsKeys) {\r\n if (Array.isArray(TOTAL_PARAMS_PAGE[key])) {\r\n const arrayValue = params[key] as unknown[]\r\n console.log({arrayValue})\r\n switch (arraySerialization) {\r\n case 'csv': {\r\n const csvValue = arrayValue.join(',')\r\n // set ensure that the previous value is replaced\r\n newParam.set(key, csvValue)\r\n break\r\n } case 'repeat': {\r\n \r\n for (const item of arrayValue) {\r\n console.log({item})\r\n // add new value to the key, instead of replacing it\r\n newParam.append(key, item as string)\r\n \r\n }\r\n break\r\n } case 'brackets': {\r\n for (const item of arrayValue) {\r\n newParam.append(`${key}[]`, item as string)\r\n }\r\n break\r\n } default: {\r\n const csvValue = arrayValue.join(',')\r\n newParam.set(key, csvValue)\r\n }\r\n }\r\n } else {\r\n newParam.set(key, params[key] as string)\r\n }\r\n }\r\n console.log({FINAL: newParam.toString()})\r\n return newParam\r\n }\r\n // @ts-ignore\r\n const hasForcedParamsValues = ({ paramsForced, compareParams }) => {\r\n\r\n // Iterates over the forced parameters and verifies that they exist in the URL and match their values\r\n // Ej: { page: 1, page_size: 10 } === { page: 1, page_size: 10 } => true\r\n const allParamsMatch = Object.entries(paramsForced).every(\r\n ([key, value]) => compareParams[key] === value\r\n );\r\n\r\n return allParamsMatch;\r\n };\r\n \r\n useEffect(() => {\r\n\r\n const keysDefaultParams: string[] = Object.keys(defaultParams)\r\n const keysForceParams: string[] = Object.keys(forceParams)\r\n if(keysDefaultParams.length === 0 && keysForceParams.length === 0) return\r\n \r\n\r\n function handleStartingParams() {\r\n\r\n const defaultParamsString = transformParamsToURLSearch(defaultParams).toString()\r\n const paramsUrl = getParams()\r\n const paramsUrlString = transformParamsToURLSearch(paramsUrl).toString()\r\n const forceParamsString = transformParamsToURLSearch(forceParams).toString()\r\n\r\n console.log({defaultParamsString})\r\n\r\n const isForcedParams: boolean = hasForcedParamsValues({ paramsForced: forceParams, compareParams: paramsUrl })\r\n\r\n if (!isForcedParams) {\r\n\r\n // In this case, the forced parameters take precedence over the default parameters and the parameters of the current URL (which could have been modified by the user, e.g., page_size=1000)\r\n\r\n updateParams({ newParams: {\r\n ...defaultParams,\r\n ...forceParams\r\n }})\r\n return\r\n }\r\n // In this way it will be validated that the forced parameters keys and values are in the current URL\r\n const isIncludesForcedParams = hasForcedParamsValues({ paramsForced: forceParamsString, compareParams: defaultParams })\r\n\r\n if (keysDefaultParams.length > 0 && isIncludesForcedParams) {\r\n if (defaultParamsString === paramsUrlString) return // this means that the URL already has the default parameters\r\n updateParams({ newParams: defaultParams })\r\n }\r\n\r\n }\r\n handleStartingParams()\r\n\r\n // eslint-disable-next-line react-hooks/exhaustive-deps\r\n }, [])\r\n\r\n /\r\n Convert a string value to its original type (number, boolean, array) according to TOTAL_PARAMS_PAGE\r\n * @param value - Chain obtained from the URL\r\n * @param key - Key of the parameter\r\n /\r\n const convertOriginalType = (value: string, key: string) => {\r\n // Given that the parameters of a URL are recieved as strings, they are converted to their original type\r\n if (typeof TOTAL_PARAMS_PAGE[key] === 'number') {\r\n return parseInt(value)\r\n } else if (typeof TOTAL_PARAMS_PAGE[key] === 'boolean') {\r\n return value === 'true'\r\n } else if (Array.isArray(TOTAL_PARAMS_PAGE[key])) {\r\n // The result will be a valid array represented in the URL ej: tags=tag1,tag2,tag3 to ['tag1', 'tag2', 'tag3'], useful to combine the values of the arrays with the new ones\r\n \r\n if (arraySerialization === 'csv') {\r\n return searchParams.getAll(key).join('').split(',')\r\n } else if (arraySerialization === 'repeat') {\r\n \r\n console.log({SEARCH_PARAMS: searchParams.getAll(key)})\r\n return searchParams.getAll(key)\r\n } else if (arraySerialization === 'brackets') {\r\n return searchParams.getAll(`${key}[]`)\r\n }\r\n \r\n \r\n }\r\n // Note: dates are not converted as it is better to handle them directly in the component that receives them, using a library like < date-fns >\r\n return value\r\n }\r\n \r\n /\r\n Gets the current parameters from the URL and converts them to their original type if desired\r\n * @param convert - If true, converts from string to the inferred type (number, boolean, ...)\r\n */\r\n const getStringUrl = (key: string, paramsUrl: Record<string, unknown>) => {\r\n const isKeyArray = Array.isArray(TOTAL_PARAMS_PAGE[key])\r\n if (isKeyArray) {\r\n\r\n if (arraySerialization === 'brackets') {\r\n\r\n const arrayUrl = searchParams.getAll(`${key}[]`)\r\n const encodedQueryArray = transformParamsToURLSearch({ [key]: arrayUrl }).toString()\r\n // in this way the array of the URL is decoded to its original form ej: tags[]=tag1&tags[]=tag2&tags[]=tag3\r\n const unencodeQuery = decodeURIComponent(encodedQueryArray)\r\n return unencodeQuery\r\n } else if (arraySerialization === 'csv') {\r\n const arrayValue = searchParams.getAll(key)\r\n const encodedQueryArray = transformParamsToURLSearch({ [key]: arrayValue }).toString()\r\n const unencodeQuery = decodeURIComponent(encodedQueryArray)\r\n return unencodeQuery\r\n }\r\n const arrayValue = searchParams.getAll(key)\r\n const stringResult = transformParamsToURLSearch({ [key]: arrayValue }).toString()\r\n return stringResult\r\n } else {\r\n \r\n return paramsUrl[key] as string\r\n }\r\n }\r\n const getParamsObj = (searchParams: URLSearchParams): Record<string, string \| string[]> => {\r\n const paramsObj: Record<string, string \| string[]> = {};\r\n // @ts-ignore\r\n for (const [key, value] of searchParams.entries()) {\r\n if (key.endsWith('[]')) {\r\n const bareKey = key.replace('[]', '');\r\n if (paramsObj[bareKey]) {\r\n (paramsObj[bareKey] as string[]).push(value);\r\n } else {\r\n paramsObj[bareKey] = [value];\r\n }\r\n } else {\r\n // If the key already exists, it is a repeated parameter\r\n if (paramsObj[key]) {\r\n if (Array.isArray(paramsObj[key])) {\r\n (paramsObj[key] as string[]).push(value);\r\n } else {\r\n paramsObj[key] = [paramsObj[key] as string, value];\r\n }\r\n } else {\r\n paramsObj[key] = value;\r\n }\r\n }\r\n }\r\n return paramsObj;\r\n }\r\n // Optimization: While the parameters are not updated, the current parameters of the URL are not recalculated\r\n const CURRENT_PARAMS_URL: Record<string, unknown> = useMemo(() => {\r\n\r\n return arraySerialization === 'brackets' ? getParamsObj(searchParams) : Object.fromEntries(searchParams.entries())\r\n }, [searchParams, arraySerialization])\r\n\r\n const getParams = ({ convert = true } = {}): MergeParams<M, O> => {\r\n // All the paramteres are extracted from the URL and converted into an object\r\n\r\n const params = Object.keys(CURRENT_PARAMS_URL).reduce((acc, key) => {\r\n if (Object.prototype.hasOwnProperty.call(TOTAL_PARAMS_PAGE, key)) {\r\n const realKey = arraySerialization === 'brackets' ? key.replace('[]', '') : key\r\n // @ts-ignore\r\n acc[realKey] = convert === true\r\n ? convertOriginalType(CURRENT_PARAMS_URL[key] as string, key)\r\n : getStringUrl(key, CURRENT_PARAMS_URL)\r\n }\r\n return acc\r\n }, {})\r\n \r\n return params as MergeParams<M, O>\r\n }\r\n type keys = keyof MergeParams<M, O>\r\n // Note: in this way the return of the getParam function is typed dynamically, thus having autocomplete in the IDE (eg: value.split(','))\r\n type TagReturn<T extends boolean> = T extends true ? string[] : string;\r\n const getParam = <T extends boolean>(key: keys, options?: { convert: T }): TagReturn<T> => {\r\n\r\n const keyStr = String(key)\r\n // @ts-ignore\r\n const value = options?.convert === true ? convertOriginalType(searchParams.get(keyStr), keyStr) : getStringUrl(keyStr, CURRENT_PARAMS_URL)\r\n return value as TagReturn<T> \r\n }\r\n \r\n type OptionalParamsFiltered = Partial<O>\r\n\r\n const calculateOmittedParameters = (newParams: Record<string, unknown \| unknown[]>, keepParams: Record<string, boolean>) => {\r\n // Calculate the ommited parameters, that is, the parameters that have not been sent in the request\r\n const params = getParams()\r\n // hasOw\r\n // Note: it will be necessary to omit the parameters that are arrays because the idea is not to replace them but to add or remove some values\r\n const newParamsWithoutArray = Object.entries(newParams).filter(([key,]) => !Array.isArray(TOTAL_PARAMS_PAGE[key]))\r\n const result = Object.assign({\r\n ...params,\r\n ...Object.fromEntries(newParamsWithoutArray),\r\n ...forceParams // the forced parameters will always be sent and will maintain their value\r\n })\r\n const paramsFiltered: OptionalParamsFiltered = Object.keys(result).reduce((acc, key) => {\r\n // for default no parameters are omitted unless specified in the keepParams object\r\n if (Object.prototype.hasOwnProperty.call(keepParams, key) && keepParams[key] === false) {\r\n return acc\r\n // Note: They array of parameters omitted by values (e.g., ['all', 'default']) are omitted since they are usually a default value that is not desired to be sent\r\n } else if (!!result[key] !== false && !omitParamsByValues.includes(result[key])) {\r\n // @ts-ignore\r\n acc[key] = result[key]\r\n }\r\n\r\n return acc\r\n }, {})\r\n\r\n return {\r\n ...mandatory,\r\n ...paramsFiltered\r\n } \r\n }\r\n // @ts-ignore\r\n const sortParameters = (paramsFiltered) => {\r\n // sort the parameters according to the structure so that it persists with each change in the URL, eg: localhost:3000/?page=1&page_size=10\r\n // Note: this visibly improves the user experience\r\n const orderedParams = PARAM_ORDER.reduce((acc, key) => {\r\n if (Object.prototype.hasOwnProperty.call(paramsFiltered, key)) {\r\n // @ts-ignore\r\n acc[key] = paramsFiltered[key]\r\n }\r\n\r\n return acc\r\n }, {})\r\n return orderedParams\r\n }\r\n\r\n const mandatoryParameters = () => {\r\n // Note: in case there are arrays in the URL, they are converted to their original form ej: tags=['tag1', 'tag2'] otherwise the parameters are extracted without converting to optimize performance\r\n const isNecessaryConvert: boolean = ARRAY_KEYS.length > 0 ? true : false\r\n const totalParametros: Record<string, unknown> = getParams({ convert: isNecessaryConvert })\r\n\r\n const paramsUrlFound: Record<string, boolean> = Object.keys(totalParametros).reduce(\r\n (acc, key) => {\r\n if (Object.prototype.hasOwnProperty.call(mandatory, key)) {\r\n // @ts-ignore\r\n acc[key] = totalParametros[key]\r\n }\r\n return acc\r\n },\r\n {}\r\n )\r\n\r\n return paramsUrlFound\r\n }\r\n\r\n const clearParams = ({ keepMandatoryParams = true } = {}): void => {\r\n // for default, the mandatory parameters are not cleared since the current pagination would be lost\r\n const paramsTransformed = transformParamsToURLSearch(\r\n {\r\n ...mandatory,\r\n \r\n ...(keepMandatoryParams && {\r\n ...mandatoryParameters()\r\n }),\r\n ...forceParams \r\n }\r\n )\r\n setSearchParams(paramsTransformed) \r\n }\r\n\r\n // transforms the keys to boolean to know which parameters to keep\r\n type KeepParamsTransformedValuesBoolean = Partial<Record<keyof typeof TOTAL_PARAMS_PAGE, boolean>>\r\n type NewParams = Partial<typeof TOTAL_PARAMS_PAGE> \r\n type KeepParams = KeepParamsTransformedValuesBoolean\r\n const updateParams = ({ newParams = {} as NewParams, keepParams = {} as KeepParams } = {}) => {\r\n\r\n if (\r\n Object.keys(newParams).length === 0 &&\r\n Object.keys(keepParams).length === 0\r\n ) {\r\n clearParams()\r\n return\r\n }\r\n // @ts-ignore\r\n const finallyParamters = calculateOmittedParameters(newParams, keepParams)\r\n\r\n const convertedArrayValues = appendArrayValues(finallyParamters, newParams)\r\n\r\n const paramsSorted = sortParameters(convertedArrayValues)\r\n\r\n setSearchParams(transformParamsToURLSearch(paramsSorted))\r\n\r\n }\r\n\r\n // only for the keys of the parameters to subscribe to changes in the URL to trigger the callback\r\n const onChange = useCallback( (paramName: keys, callbacks: Array<() => void>) => {\r\n const paramNameStr = String(paramName)\r\n // replace the previous callbacks with the new ones so as not to accumulate callbacks\r\n subscriptionsRef.current[paramNameStr] = callbacks;\r\n }, [])\r\n \r\n // each time searchParams changes, we notify the subscribers\r\n useEffect(() => {\r\n\r\n for (const [key, value] of Object.entries(subscriptionsRef.current)) {\r\n\r\n const newValue = CURRENT_PARAMS_URL[key] ?? null \r\n const oldValue = previousParamsRef.current[key] ?? null\r\n if (newValue !== oldValue) {\r\n \r\n for (const callback of value) {\r\n console.log(value)\r\n\r\n callback()\r\n\r\n }\r\n }\r\n // once the callback is executed, the previous value is updated to ensure that the next time the value changes, the callback is executed\r\n previousParamsRef.current[key] = newValue\r\n }\r\n\r\n \r\n }, [CURRENT_PARAMS_URL])\r\n return {\r\n searchParams,\r\n updateParams,\r\n clearParams,\r\n getParams,\r\n getParam,\r\n onChange\r\n }\r\n}\r\n"],"names":["useMagicSearchParams","_ref","mandatory","_ref$mandatory","_ref$optional","optional","_ref$defaultParams","defaultParams","_ref$arraySerializati","arraySerialization","_ref$forceParams","forceParams","_ref$omitParamsByValu","omitParamsByValues","_useSearchParams","useSearchParams","searchParams","setSearchParams","subscriptionsRef","useRef","previousParamsRef","TOTAL_PARAMS_PAGE","useMemo","_extends","PARAM_ORDER","Array","from","Object","keys","ARRAY_KEYS","filter","key","isArray","appendArrayValues","finallyParams","newParams","updatedParams","length","forEach","currentValues","raw","get","split","map","v","trim","Boolean","urlParams","getAll","console","log","REPEAT","BRACKETS","_searchParams$get","undefined","incoming","combined","includes","concat","CONBINED_STRING","Set","transformParamsToURLSearch","params","PARAMS_RECIBIDOS_TRANSFORM","newParam","URLSearchParams","paramsKeys","_i","_paramsKeys","arrayValue","csvValue","join","set","_iterator","_createForOfIteratorHelperLoose","_step","done","item","value","append","_iterator2","_step2","FINAL","toString","hasForcedParamsValues","_ref2","paramsForced","compareParams","allParamsMatch","entries","every","_ref3","useEffect","keysDefaultParams","keysForceParams","handleStartingParams","defaultParamsString","paramsUrl","getParams","paramsUrlString","forceParamsString","isForcedParams","updateParams","isIncludesForcedParams","convertOriginalType","parseInt","SEARCH_PARAMS","getStringUrl","isKeyArray","_transformParamsToURL3","_transformParamsToURL","arrayUrl","encodedQueryArray","unencodeQuery","decodeURIComponent","_transformParamsToURL2","stringResult","getParamsObj","paramsObj","_iterator3","_step3","_step3$value","endsWith","bareKey","replace","push","CURRENT_PARAMS_URL","fromEntries","_temp","_ref4$convert","_ref4","convert","reduce","acc","prototype","hasOwnProperty","call","realKey","getParam","options","keyStr","String","calculateOmittedParameters","keepParams","newParamsWithoutArray","_ref5","result","assign","paramsFiltered","sortParameters","orderedParams","mandatoryParameters","isNecessaryConvert","totalParametros","paramsUrlFound","clearParams","_temp2","_ref6$keepMandatoryPa","_ref6","keepMandatoryParams","paramsTransformed","_temp3","_ref7$newParams","_ref7","_ref7$keepParams","finallyParamters","convertedArrayValues","paramsSorted","onChange","useCallback","paramName","callbacks","paramNameStr","current","_i2","_Object$entries","_CURRENT_PARAMS_URL$k","_previousParamsRef$cu","_Object$entries$_i","newValue","oldValue","_iterator4","_step4","callback"],"mappings":"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"}
1	+ {"version":3,"file":"react-magic-search-params.cjs.development.js","sources":["../src/useMagicSearchParams.ts"],"sourcesContent":["import { useSearchParams } from 'react-router-dom'\r\nimport { useMemo, useEffect, useRef, useCallback } from 'react'\r\n\r\n\r\n// Custom hook with advanced techniques to handle search parameters for any pagination\r\n\r\ntype CommonParams = {\r\n page?: number\r\n page_size?: number\r\n}\r\n/\r\nMaps all properties of M (mandatory) as required\r\nand all properties of O (optional) as optional. \r\n/\r\ntype MergeParams<M, O> = {\r\n [K in keyof M]: M[K]\r\n} & {\r\n [K in keyof O]?: O[K]\r\n}\r\n/*\r\n Interface for the configuration object that the hook receives \r\n /\r\nexport interface UseMagicSearchParamsOptions<\r\n M extends Record<string, unknown>,\r\n O extends Record<string, unknown>\r\n> {\r\n mandatory: M \r\n optional?: O\r\n defaultParams?: Partial<MergeParams<M, O>>\r\n forceParams?: Partial<MergeParams<M, O>> // transform all to partial to avoid errors\r\n arraySerialization?: 'csv' \| 'repeat' \| 'brackets' // technical to serialize arrays in the URL\r\n omitParamsByValues?: Array<'all' \| 'default' \| 'unknown' \| 'none' \| 'void '> \r\n}\r\n\r\n/* \r\nGeneric hook to handle search parameters in the URL\r\n@param mandatory - Mandatory parameters (e.g., page=1, page_size=10, etc.)\r\n@param optional - Optional parameters (e.g., order, search, etc.)\r\n@param defaultParams - Default parameters sent in the URL on initialization\r\n@param forceParams - Parameters forced into the URL regardless of user input\r\n@param omitParamsByValues - Parameters omitted if they have specific values \r\n/\r\nexport const useMagicSearchParams = <\r\n M extends Record<string, unknown> & CommonParams,\r\n O extends Record<string, unknown>,\r\n>({\r\n mandatory = {} as M,\r\n optional = {} as O,\r\n defaultParams = {} as Partial<MergeParams<M, O>>,\r\n arraySerialization = 'csv',\r\n forceParams = {} as {} as Partial<MergeParams<M, O>>,\r\n omitParamsByValues = [] as Array<'all' \| 'default' \| 'unknown' \| 'none' \| 'void '>\r\n}: UseMagicSearchParamsOptions<M, O>)=> {\r\n\r\n\r\n const [searchParams, setSearchParams] = useSearchParams() \r\n // Ref to store subscriptions: { paramName: [callback1, callback2, ...] }\r\n const subscriptionsRef = useRef<Record<string, Array<() => unknown>>>({}); \r\n const previousParamsRef = useRef<Record<string, unknown>>({})\r\n\r\n const TOTAL_PARAMS_PAGE: MergeParams<M, O> = useMemo(() => {\r\n return { ...mandatory, ...optional };\r\n }, [mandatory, optional]);\r\n\r\n const PARAM_ORDER = useMemo(() => {\r\n return Array.from(Object.keys(TOTAL_PARAMS_PAGE))\r\n }, [TOTAL_PARAMS_PAGE])\r\n\r\n // we get the keys that are arrays according to TOTAL_PARAMS_PAGE since these require special treatment in the URL due to serialization mode\r\n const ARRAY_KEYS = useMemo(() => {\r\n return Object.keys(TOTAL_PARAMS_PAGE).filter(\r\n (key) => Array.isArray(TOTAL_PARAMS_PAGE[key])\r\n );\r\n }, [TOTAL_PARAMS_PAGE])\r\n\r\n const appendArrayValues = (\r\n finallyParams: Record<string, unknown>,\r\n newParams: Record<string, string \| string[] \| unknown>\r\n ): Record<string, unknown> => {\r\n \r\n // Note: We cannot modify the object of the final parameters directly, as immutability must be maintained\r\n const updatedParams = { ...finallyParams };\r\n \r\n\r\n if (ARRAY_KEYS.length === 0) return updatedParams;\r\n \r\n ARRAY_KEYS.forEach((key) => {\r\n // We use the current values directly from searchParams (source of truth)\r\n // This avoids depending on finallyParams in which the arrays have been omitted\r\n let currentValues = []; \r\n switch (arraySerialization) {\r\n case 'csv': {\r\n const raw = searchParams.get(key) \|\| '';\r\n // For csv we expect \"value1,value2,...\" (no prefix)\r\n currentValues = raw.split(',')\r\n .map((v) => v.trim())\r\n .filter(Boolean) as Array<string>\r\n break;\r\n }\r\n case 'repeat': {\r\n // Here we get all ocurrences of key\r\n const urlParams = searchParams.getAll(key) as Array<string>\r\n currentValues = urlParams.length > 0 ? urlParams : []\r\n \r\n console.log({REPEAT: currentValues})\r\n break;\r\n }\r\n case 'brackets': {\r\n // Build URLSearchParams from current parameters (to ensure no serialized values are taken previously)\r\n const urlParams = searchParams.getAll(`${key}[]`) as Array<string>\r\n currentValues = urlParams.length > 0 ? urlParams : []\r\n console.log({BRACKETS: urlParams})\r\n \r\n \r\n break;\r\n }\r\n default: {\r\n // Mode by default works as csv\r\n const raw = searchParams.get(key) ?? '';\r\n currentValues = raw.split(',')\r\n .map((v) => v.trim())\r\n .filter(Boolean);\r\n }\r\n break; \r\n }\r\n // Update array values with new ones\r\n \r\n if (newParams[key] !== undefined) {\r\n const incoming = newParams[key];\r\n let combined: string[] = []\r\n if (typeof incoming === 'string') {\r\n // If it is a string, it is toggled (add/remove)\r\n combined = currentValues.includes(incoming)\r\n ? currentValues.filter((v) => v !== incoming)\r\n : [...currentValues, incoming];\r\n console.log({currentValues})\r\n console.log({incoming})\r\n console.log({CONBINED_STRING: combined})\r\n } else if (Array.isArray(incoming)) {\r\n // if an array is passed, repeated values are merged into a single value\r\n // Note: Set is used to remove duplicates\r\n combined = Array.from(new Set([ ...incoming]));\r\n console.log({incoming})\r\n console.log({combined})\r\n } else {\r\n \r\n combined = currentValues;\r\n }\r\n\r\n updatedParams[key] = combined\r\n\r\n }\r\n });\r\n console.log({updatedParams})\r\n return updatedParams\r\n };\r\n\r\n const transformParamsToURLSearch = (params: Record<string, unknown>): URLSearchParams => {\r\n console.log({PARAMS_RECIBIDOS_TRANSFORM: params})\r\n\r\n const newParam: URLSearchParams = new URLSearchParams()\r\n\r\n const paramsKeys = Object.keys(params)\r\n\r\n for (const key of paramsKeys) {\r\n if (Array.isArray(TOTAL_PARAMS_PAGE[key])) {\r\n const arrayValue = params[key] as unknown[]\r\n console.log({arrayValue})\r\n switch (arraySerialization) {\r\n case 'csv': {\r\n const csvValue = arrayValue.join(',')\r\n // set ensure that the previous value is replaced\r\n newParam.set(key, csvValue)\r\n break\r\n } case 'repeat': {\r\n \r\n for (const item of arrayValue) {\r\n console.log({item})\r\n // add new value to the key, instead of replacing it\r\n newParam.append(key, item as string)\r\n \r\n }\r\n break\r\n } case 'brackets': {\r\n for (const item of arrayValue) {\r\n newParam.append(`${key}[]`, item as string)\r\n }\r\n break\r\n } default: {\r\n const csvValue = arrayValue.join(',')\r\n newParam.set(key, csvValue)\r\n }\r\n }\r\n } else {\r\n newParam.set(key, params[key] as string)\r\n }\r\n }\r\n console.log({FINAL: newParam.toString()})\r\n return newParam\r\n }\r\n // @ts-ignore\r\n const hasForcedParamsValues = ({ paramsForced, compareParams }) => {\r\n\r\n // Iterates over the forced parameters and verifies that they exist in the URL and match their values\r\n // Ej: { page: 1, page_size: 10 } === { page: 1, page_size: 10 } => true\r\n const allParamsMatch = Object.entries(paramsForced).every(\r\n ([key, value]) => compareParams[key] === value\r\n );\r\n\r\n return allParamsMatch;\r\n };\r\n \r\n useEffect(() => {\r\n\r\n const keysDefaultParams: string[] = Object.keys(defaultParams)\r\n const keysForceParams: string[] = Object.keys(forceParams)\r\n if(keysDefaultParams.length === 0 && keysForceParams.length === 0) return\r\n \r\n\r\n function handleStartingParams() {\r\n\r\n const defaultParamsString = transformParamsToURLSearch(defaultParams).toString()\r\n const paramsUrl = getParams()\r\n const paramsUrlString = transformParamsToURLSearch(paramsUrl).toString()\r\n const forceParamsString = transformParamsToURLSearch(forceParams).toString()\r\n\r\n console.log({defaultParamsString})\r\n\r\n const isForcedParams: boolean = hasForcedParamsValues({ paramsForced: forceParams, compareParams: paramsUrl })\r\n\r\n if (!isForcedParams) {\r\n\r\n // In this case, the forced parameters take precedence over the default parameters and the parameters of the current URL (which could have been modified by the user, e.g., page_size=1000)\r\n\r\n updateParams({ newParams: {\r\n ...defaultParams,\r\n ...forceParams\r\n }})\r\n return\r\n }\r\n // In this way it will be validated that the forced parameters keys and values are in the current URL\r\n const isIncludesForcedParams = hasForcedParamsValues({ paramsForced: forceParamsString, compareParams: defaultParams })\r\n\r\n if (keysDefaultParams.length > 0 && isIncludesForcedParams) {\r\n if (defaultParamsString === paramsUrlString) return // this means that the URL already has the default parameters\r\n updateParams({ newParams: defaultParams })\r\n }\r\n\r\n }\r\n handleStartingParams()\r\n\r\n // eslint-disable-next-line react-hooks/exhaustive-deps\r\n }, [])\r\n\r\n /\r\n Convert a string value to its original type (number, boolean, array) according to TOTAL_PARAMS_PAGE\r\n * @param value - Chain obtained from the URL\r\n * @param key - Key of the parameter\r\n /\r\n const convertOriginalType = (value: string, key: string) => {\r\n // Given that the parameters of a URL are recieved as strings, they are converted to their original type\r\n if (typeof TOTAL_PARAMS_PAGE[key] === 'number') {\r\n return parseInt(value)\r\n } else if (typeof TOTAL_PARAMS_PAGE[key] === 'boolean') {\r\n return value === 'true'\r\n } else if (Array.isArray(TOTAL_PARAMS_PAGE[key])) {\r\n // The result will be a valid array represented in the URL ej: tags=tag1,tag2,tag3 to ['tag1', 'tag2', 'tag3'], useful to combine the values of the arrays with the new ones\r\n \r\n if (arraySerialization === 'csv') {\r\n return searchParams.getAll(key).join('').split(',')\r\n } else if (arraySerialization === 'repeat') {\r\n \r\n console.log({SEARCH_PARAMS: searchParams.getAll(key)})\r\n return searchParams.getAll(key)\r\n } else if (arraySerialization === 'brackets') {\r\n return searchParams.getAll(`${key}[]`)\r\n }\r\n \r\n \r\n }\r\n // Note: dates are not converted as it is better to handle them directly in the component that receives them, using a library like < date-fns >\r\n return value\r\n }\r\n \r\n /\r\n Gets the current parameters from the URL and converts them to their original type if desired\r\n * @param convert - If true, converts from string to the inferred type (number, boolean, ...)\r\n */\r\n const getStringUrl = (key: string, paramsUrl: Record<string, unknown>) => {\r\n const isKeyArray = Array.isArray(TOTAL_PARAMS_PAGE[key])\r\n if (isKeyArray) {\r\n\r\n if (arraySerialization === 'brackets') {\r\n\r\n const arrayUrl = searchParams.getAll(`${key}[]`)\r\n const encodedQueryArray = transformParamsToURLSearch({ [key]: arrayUrl }).toString()\r\n // in this way the array of the URL is decoded to its original form ej: tags[]=tag1&tags[]=tag2&tags[]=tag3\r\n const unencodeQuery = decodeURIComponent(encodedQueryArray)\r\n return unencodeQuery\r\n } else if (arraySerialization === 'csv') {\r\n const arrayValue = searchParams.getAll(key)\r\n const encodedQueryArray = transformParamsToURLSearch({ [key]: arrayValue }).toString()\r\n const unencodeQuery = decodeURIComponent(encodedQueryArray)\r\n return unencodeQuery\r\n }\r\n const arrayValue = searchParams.getAll(key)\r\n const stringResult = transformParamsToURLSearch({ [key]: arrayValue }).toString()\r\n return stringResult\r\n } else {\r\n \r\n return paramsUrl[key] as string\r\n }\r\n }\r\n const getParamsObj = (searchParams: URLSearchParams): Record<string, string \| string[]> => {\r\n const paramsObj: Record<string, string \| string[]> = {};\r\n // @ts-ignore\r\n for (const [key, value] of searchParams.entries()) {\r\n if (key.endsWith('[]')) {\r\n const bareKey = key.replace('[]', '');\r\n if (paramsObj[bareKey]) {\r\n (paramsObj[bareKey] as string[]).push(value);\r\n } else {\r\n paramsObj[bareKey] = [value];\r\n }\r\n } else {\r\n // If the key already exists, it is a repeated parameter\r\n if (paramsObj[key]) {\r\n if (Array.isArray(paramsObj[key])) {\r\n (paramsObj[key] as string[]).push(value);\r\n } else {\r\n paramsObj[key] = [paramsObj[key] as string, value];\r\n }\r\n } else {\r\n paramsObj[key] = value;\r\n }\r\n }\r\n }\r\n return paramsObj;\r\n }\r\n // Optimization: While the parameters are not updated, the current parameters of the URL are not recalculated\r\n const CURRENT_PARAMS_URL: Record<string, unknown> = useMemo(() => {\r\n\r\n return arraySerialization === 'brackets' ? getParamsObj(searchParams) : Object.fromEntries(searchParams.entries())\r\n }, [searchParams, arraySerialization])\r\n\r\n const getParams = ({ convert = true } = {}): MergeParams<M, O> => {\r\n // All the paramteres are extracted from the URL and converted into an object\r\n\r\n const params = Object.keys(CURRENT_PARAMS_URL).reduce((acc, key) => {\r\n if (Object.prototype.hasOwnProperty.call(TOTAL_PARAMS_PAGE, key)) {\r\n const realKey = arraySerialization === 'brackets' ? key.replace('[]', '') : key\r\n // @ts-ignore\r\n acc[realKey] = convert === true\r\n ? convertOriginalType(CURRENT_PARAMS_URL[key] as string, key)\r\n : getStringUrl(key, CURRENT_PARAMS_URL)\r\n }\r\n return acc\r\n }, {})\r\n \r\n return params as MergeParams<M, O>\r\n }\r\n type keys = keyof MergeParams<M, O>\r\n // Note: in this way the return of the getParam function is typed dynamically, thus having autocomplete in the IDE (eg: value.split(','))\r\n type TagReturn<T extends boolean> = T extends true ? string[] : string;\r\n const getParam = <T extends boolean>(key: keys, options?: { convert: T }): TagReturn<T> => {\r\n\r\n const keyStr = String(key)\r\n // @ts-ignore\r\n const value = options?.convert === true ? convertOriginalType(searchParams.get(keyStr), keyStr) : getStringUrl(keyStr, CURRENT_PARAMS_URL)\r\n return value as TagReturn<T> \r\n }\r\n \r\n type OptionalParamsFiltered = Partial<O>\r\n\r\n const calculateOmittedParameters = (newParams: Record<string, unknown \| unknown[]>, keepParams: Record<string, boolean>) => {\r\n // Calculate the ommited parameters, that is, the parameters that have not been sent in the request\r\n const params = getParams()\r\n // hasOw\r\n // Note: it will be necessary to omit the parameters that are arrays because the idea is not to replace them but to add or remove some values\r\n const newParamsWithoutArray = Object.entries(newParams).filter(([key,]) => !Array.isArray(TOTAL_PARAMS_PAGE[key]))\r\n const result = Object.assign({\r\n ...params,\r\n ...Object.fromEntries(newParamsWithoutArray),\r\n ...forceParams // the forced parameters will always be sent and will maintain their value\r\n })\r\n const paramsFiltered: OptionalParamsFiltered = Object.keys(result).reduce((acc, key) => {\r\n // for default no parameters are omitted unless specified in the keepParams object\r\n if (Object.prototype.hasOwnProperty.call(keepParams, key) && keepParams[key] === false) {\r\n return acc\r\n // Note: They array of parameters omitted by values (e.g., ['all', 'default']) are omitted since they are usually a default value that is not desired to be sent\r\n } else if (!!result[key] !== false && !omitParamsByValues.includes(result[key])) {\r\n // @ts-ignore\r\n acc[key] = result[key]\r\n }\r\n\r\n return acc\r\n }, {})\r\n\r\n return {\r\n ...mandatory,\r\n ...paramsFiltered\r\n } \r\n }\r\n // @ts-ignore\r\n const sortParameters = (paramsFiltered) => {\r\n // sort the parameters according to the structure so that it persists with each change in the URL, eg: localhost:3000/?page=1&page_size=10\r\n // Note: this visibly improves the user experience\r\n const orderedParams = PARAM_ORDER.reduce((acc, key) => {\r\n if (Object.prototype.hasOwnProperty.call(paramsFiltered, key)) {\r\n // @ts-ignore\r\n acc[key] = paramsFiltered[key]\r\n }\r\n\r\n return acc\r\n }, {})\r\n return orderedParams\r\n }\r\n\r\n const mandatoryParameters = () => {\r\n // Note: in case there are arrays in the URL, they are converted to their original form ej: tags=['tag1', 'tag2'] otherwise the parameters are extracted without converting to optimize performance\r\n const isNecessaryConvert: boolean = ARRAY_KEYS.length > 0 ? true : false\r\n const totalParametros: Record<string, unknown> = getParams({ convert: isNecessaryConvert })\r\n\r\n const paramsUrlFound: Record<string, boolean> = Object.keys(totalParametros).reduce(\r\n (acc, key) => {\r\n if (Object.prototype.hasOwnProperty.call(mandatory, key)) {\r\n // @ts-ignore\r\n acc[key] = totalParametros[key]\r\n }\r\n return acc\r\n },\r\n {}\r\n )\r\n\r\n return paramsUrlFound\r\n }\r\n\r\n const clearParams = ({ keepMandatoryParams = true } = {}): void => {\r\n // for default, the mandatory parameters are not cleared since the current pagination would be lost\r\n const paramsTransformed = transformParamsToURLSearch(\r\n {\r\n ...mandatory,\r\n \r\n ...(keepMandatoryParams && {\r\n ...mandatoryParameters()\r\n }),\r\n ...forceParams \r\n }\r\n )\r\n setSearchParams(paramsTransformed) \r\n }\r\n\r\n // transforms the keys to boolean to know which parameters to keep\r\n type KeepParamsTransformedValuesBoolean = Partial<Record<keyof typeof TOTAL_PARAMS_PAGE, boolean>>\r\n type NewParams = Partial<typeof TOTAL_PARAMS_PAGE> \r\n type KeepParams = KeepParamsTransformedValuesBoolean\r\n const updateParams = ({ newParams = {} as NewParams, keepParams = {} as KeepParams } = {}) => {\r\n\r\n if (\r\n Object.keys(newParams).length === 0 &&\r\n Object.keys(keepParams).length === 0\r\n ) {\r\n clearParams()\r\n return\r\n }\r\n // @ts-ignore\r\n const finallyParamters = calculateOmittedParameters(newParams, keepParams)\r\n\r\n const convertedArrayValues = appendArrayValues(finallyParamters, newParams)\r\n\r\n const paramsSorted = sortParameters(convertedArrayValues)\r\n\r\n setSearchParams(transformParamsToURLSearch(paramsSorted))\r\n\r\n }\r\n\r\n // only for the keys of the parameters to subscribe to changes in the URL to trigger the callback\r\n const onChange = useCallback( (paramName: keys, callbacks: Array<() => void>) => {\r\n const paramNameStr = String(paramName)\r\n // replace the previous callbacks with the new ones so as not to accumulate callbacks\r\n subscriptionsRef.current[paramNameStr] = callbacks;\r\n }, [])\r\n \r\n // each time searchParams changes, we notify the subscribers\r\n useEffect(() => {\r\n\r\n for (const [key, value] of Object.entries(subscriptionsRef.current)) {\r\n\r\n const newValue = CURRENT_PARAMS_URL[key] ?? null \r\n const oldValue = previousParamsRef.current[key] ?? null\r\n if (newValue !== oldValue) {\r\n \r\n for (const callback of value) {\r\n console.log(value)\r\n\r\n callback()\r\n\r\n }\r\n }\r\n // once the callback is executed, the previous value is updated to ensure that the next time the value changes, the callback is executed\r\n previousParamsRef.current[key] = newValue\r\n }\r\n\r\n \r\n }, [CURRENT_PARAMS_URL])\r\n return {\r\n searchParams,\r\n updateParams,\r\n clearParams,\r\n getParams,\r\n getParam,\r\n onChange\r\n }\r\n}\r\n"],"names":["useMagicSearchParams","_ref","mandatory","_ref$mandatory","_ref$optional","optional","_ref$defaultParams","defaultParams","_ref$arraySerializati","arraySerialization","_ref$forceParams","forceParams","_ref$omitParamsByValu","omitParamsByValues","_useSearchParams","useSearchParams","searchParams","setSearchParams","subscriptionsRef","useRef","previousParamsRef","TOTAL_PARAMS_PAGE","useMemo","_extends","PARAM_ORDER","Array","from","Object","keys","ARRAY_KEYS","filter","key","isArray","appendArrayValues","finallyParams","newParams","updatedParams","length","forEach","currentValues","raw","get","split","map","v","trim","Boolean","urlParams","getAll","console","log","REPEAT","BRACKETS","_searchParams$get","undefined","incoming","combined","includes","concat","CONBINED_STRING","Set","transformParamsToURLSearch","params","PARAMS_RECIBIDOS_TRANSFORM","newParam","URLSearchParams","paramsKeys","_i","_paramsKeys","arrayValue","csvValue","join","set","_iterator","_createForOfIteratorHelperLoose","_step","done","item","value","append","_iterator2","_step2","FINAL","toString","hasForcedParamsValues","_ref2","paramsForced","compareParams","allParamsMatch","entries","every","_ref3","useEffect","keysDefaultParams","keysForceParams","handleStartingParams","defaultParamsString","paramsUrl","getParams","paramsUrlString","forceParamsString","isForcedParams","updateParams","isIncludesForcedParams","convertOriginalType","parseInt","SEARCH_PARAMS","getStringUrl","isKeyArray","_transformParamsToURL3","_transformParamsToURL","arrayUrl","encodedQueryArray","unencodeQuery","decodeURIComponent","_transformParamsToURL2","stringResult","getParamsObj","paramsObj","_iterator3","_step3","_step3$value","endsWith","bareKey","replace","push","CURRENT_PARAMS_URL","fromEntries","_temp","_ref4$convert","_ref4","convert","reduce","acc","prototype","hasOwnProperty","call","realKey","getParam","options","keyStr","String","calculateOmittedParameters","keepParams","newParamsWithoutArray","_ref5","result","assign","paramsFiltered","sortParameters","orderedParams","mandatoryParameters","isNecessaryConvert","totalParametros","paramsUrlFound","clearParams","_temp2","_ref6$keepMandatoryPa","_ref6","keepMandatoryParams","paramsTransformed","_temp3","_ref7$newParams","_ref7","_ref7$keepParams","finallyParamters","convertedArrayValues","paramsSorted","onChange","useCallback","paramName","callbacks","paramNameStr","current","_i2","_Object$entries","_CURRENT_PARAMS_URL$k","_previousParamsRef$cu","_Object$entries$_i","newValue","oldValue","_iterator4","_step4","callback"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA;;;;;;;;IAQaA,oBAAoB,GAAG,SAAvBA,oBAAoBA,CAAAC,IAAA;4BAI/BC,SAAS;IAATA,SAAS,GAAAC,cAAA,cAAG,EAAO,GAAAA,cAAA;IAAAC,aAAA,GAAAH,IAAA,CACnBI,QAAQ;IAARA,QAAQ,GAAAD,aAAA,cAAG,EAAO,GAAAA,aAAA;IAAAE,kBAAA,GAAAL,IAAA,CAClBM,aAAa;IAAbA,aAAa,GAAAD,kBAAA,cAAG,EAAgC,GAAAA,kBAAA;IAAAE,qBAAA,GAAAP,IAAA,CAChDQ,kBAAkB;IAAlBA,kBAAkB,GAAAD,qBAAA,cAAG,KAAK,GAAAA,qBAAA;IAAAE,gBAAA,GAAAT,IAAA,CAC1BU,WAAW;IAAXA,WAAW,GAAAD,gBAAA,cAAG,EAAuC,GAAAA,gBAAA;IAAAE,qBAAA,GAAAX,IAAA,CACrDY,kBAAkB;IAAlBA,kBAAkB,GAAAD,qBAAA,cAAG,EAA6D,GAAAA,qBAAA;EAIlF,IAAAE,gBAAA,GAAwCC,8BAAe,EAAE;IAAlDC,YAAY,GAAAF,gBAAA;IAAEG,eAAe,GAAAH,gBAAA;;EAEpC,IAAMI,gBAAgB,GAAGC,YAAM,CAAuC,EAAE,CAAC;EACzE,IAAMC,iBAAiB,GAAGD,YAAM,CAA0B,EAAE,CAAC;EAE7D,IAAME,iBAAiB,GAAsBC,aAAO,CAAC;IACnD,OAAAC,QAAA,KAAYrB,SAAS,EAAKG,QAAQ;GACnC,EAAE,CAACH,SAAS,EAAEG,QAAQ,CAAC,CAAC;EAEzB,IAAMmB,WAAW,GAAGF,aAAO,CAAC;IAC1B,OAAOG,KAAK,CAACC,IAAI,CAACC,MAAM,CAACC,IAAI,CAACP,iBAAiB,CAAC,CAAC;GAClD,EAAE,CAACA,iBAAiB,CAAC,CAAC;;EAGvB,IAAMQ,UAAU,GAAGP,aAAO,CAAC;IACzB,OAAOK,MAAM,CAACC,IAAI,CAACP,iBAAiB,CAAC,CAACS,MAAM,CAC1C,UAACC,GAAG;MAAA,OAAKN,KAAK,CAACO,OAAO,CAACX,iBAAiB,CAACU,GAAG,CAAC,CAAC;MAC/C;GACF,EAAE,CAACV,iBAAiB,CAAC,CAAC;EAEvB,IAAMY,iBAAiB,GAAG,SAApBA,iBAAiBA,CACrBC,aAAsC,EACtCC,SAAsD;;IAItD,IAAMC,aAAa,GAAAb,QAAA,KAAQW,aAAa,CAAE;IAG1C,IAAIL,UAAU,CAACQ,MAAM,KAAK,CAAC,EAAE,OAAOD,aAAa;IAEjDP,UAAU,CAACS,OAAO,CAAC,UAACP,GAAG;;;MAGrB,IAAIQ,aAAa,GAAG,EAAE;MACtB,QAAQ9B,kBAAkB;QACxB,KAAK,KAAK;UAAE;YACV,IAAM+B,GAAG,GAAGxB,YAAY,CAACyB,GAAG,CAACV,GAAG,CAAC,IAAI,EAAE;;YAEvCQ,aAAa,GAAGC,GAAG,CAACE,KAAK,CAAC,GAAG,CAAC,CAC3BC,GAAG,CAAC,UAACC,CAAC;cAAA,OAAKA,CAAC,CAACC,IAAI,EAAE;cAAC,CACpBf,MAAM,CAACgB,OAAO,CAAkB;YACnC;;QAEF,KAAK,QAAQ;UAAE;;YAEb,IAAMC,SAAS,GAAG/B,YAAY,CAACgC,MAAM,CAACjB,GAAG,CAAkB;YAC3DQ,aAAa,GAAGQ,SAAS,CAACV,MAAM,GAAG,CAAC,GAAGU,SAAS,GAAG,EAAE;YAErDE,OAAO,CAACC,GAAG,CAAC;cAACC,MAAM,EAAEZ;aAAc,CAAC;YACpC;;QAEF,KAAK,UAAU;UAAE;;YAEb,IAAMQ,UAAS,GAAG/B,YAAY,CAACgC,MAAM,CAAIjB,GAAG,OAAI,CAAkB;YAClEQ,aAAa,GAAGQ,UAAS,CAACV,MAAM,GAAG,CAAC,GAAGU,UAAS,GAAG,EAAE;YACrDE,OAAO,CAACC,GAAG,CAAC;cAACE,QAAQ,EAAEL;aAAU,CAAC;YAGlC;;QAEJ;UAAS;YAAA,IAAAM,iBAAA;;YAEP,IAAMb,IAAG,IAAAa,iBAAA,GAAGrC,YAAY,CAACyB,GAAG,CAACV,GAAG,CAAC,YAAAsB,iBAAA,GAAI,EAAE;YACvCd,aAAa,GAAGC,IAAG,CAACE,KAAK,CAAC,GAAG,CAAC,CAC3BC,GAAG,CAAC,UAACC,CAAC;cAAA,OAAKA,CAAC,CAACC,IAAI,EAAE;cAAC,CACpBf,MAAM,CAACgB,OAAO,CAAC;;UAEpB;;;MAIF,IAAIX,SAAS,CAACJ,GAAG,CAAC,KAAKuB,SAAS,EAAE;QAChC,IAAMC,QAAQ,GAAGpB,SAAS,CAACJ,GAAG,CAAC;QAC/B,IAAIyB,QAAQ,GAAa,EAAE;QAC3B,IAAI,OAAOD,QAAQ,KAAK,QAAQ,EAAE;;UAEhCC,QAAQ,GAAGjB,aAAa,CAACkB,QAAQ,CAACF,QAAQ,CAAC,GACvChB,aAAa,CAACT,MAAM,CAAC,UAACc,CAAC;YAAA,OAAKA,CAAC,KAAKW,QAAQ;YAAC,MAAAG,MAAA,CACvCnB,aAAa,GAAEgB,QAAQ,EAAC;UAChCN,OAAO,CAACC,GAAG,CAAC;YAACX,aAAa,EAAbA;WAAc,CAAC;UAC1BU,OAAO,CAACC,GAAG,CAAC;YAACK,QAAQ,EAARA;WAAS,CAAC;UACzBN,OAAO,CAACC,GAAG,CAAC;YAACS,eAAe,EAAEH;WAAS,CAAC;SACzC,MAAM,IAAI/B,KAAK,CAACO,OAAO,CAACuB,QAAQ,CAAC,EAAE;;;UAGlCC,QAAQ,GAAG/B,KAAK,CAACC,IAAI,CAAC,IAAIkC,GAAG,IAAAF,MAAA,CAAMH,QAAQ,CAAC,CAAC,CAAC;UAC9CN,OAAO,CAACC,GAAG,CAAC;YAACK,QAAQ,EAARA;WAAS,CAAC;UACvBN,OAAO,CAACC,GAAG,CAAC;YAACM,QAAQ,EAARA;WAAS,CAAC;SACxB,MAAM;UAELA,QAAQ,GAAGjB,aAAa;;QAG1BH,aAAa,CAACL,GAAG,CAAC,GAAGyB,QAAQ;;KAGhC,CAAC;IACFP,OAAO,CAACC,GAAG,CAAC;MAACd,aAAa,EAAbA;KAAc,CAAC;IAC5B,OAAOA,aAAa;GACrB;EAED,IAAMyB,0BAA0B,GAAG,SAA7BA,0BAA0BA,CAAIC,MAA+B;IACjEb,OAAO,CAACC,GAAG,CAAC;MAACa,0BAA0B,EAAED;KAAO,CAAC;IAEjD,IAAME,QAAQ,GAAoB,IAAIC,eAAe,EAAE;IAEvD,IAAMC,UAAU,GAAGvC,MAAM,CAACC,IAAI,CAACkC,MAAM,CAAC;IAEtC,SAAAK,EAAA,MAAAC,WAAA,GAAkBF,UAAU,EAAAC,EAAA,GAAAC,WAAA,CAAA/B,MAAA,EAAA8B,EAAA,IAAE;MAAzB,IAAMpC,GAAG,GAAAqC,WAAA,CAAAD,EAAA;MACZ,IAAI1C,KAAK,CAACO,OAAO,CAACX,iBAAiB,CAACU,GAAG,CAAC,CAAC,EAAE;QACzC,IAAMsC,UAAU,GAAGP,MAAM,CAAC/B,GAAG,CAAc;QAC3CkB,OAAO,CAACC,GAAG,CAAC;UAACmB,UAAU,EAAVA;SAAW,CAAC;QACzB,QAAQ5D,kBAAkB;UACxB,KAAK,KAAK;YAAE;cACV,IAAM6D,QAAQ,GAAGD,UAAU,CAACE,IAAI,CAAC,GAAG,CAAC;;cAErCP,QAAQ,CAACQ,GAAG,CAACzC,GAAG,EAAEuC,QAAQ,CAAC;cAC3B;;UACA,KAAK,QAAQ;YAAE;cAEf,SAAAG,SAAA,GAAAC,+BAAA,CAAmBL,UAAU,GAAAM,KAAA,IAAAA,KAAA,GAAAF,SAAA,IAAAG,IAAA,GAAE;gBAAA,IAApBC,IAAI,GAAAF,KAAA,CAAAG,KAAA;gBACb7B,OAAO,CAACC,GAAG,CAAC;kBAAC2B,IAAI,EAAJA;iBAAK,CAAC;;gBAEnBb,QAAQ,CAACe,MAAM,CAAChD,GAAG,EAAE8C,IAAc,CAAC;;cAGtC;;UACA,KAAK,UAAU;YAAE;cACjB,SAAAG,UAAA,GAAAN,+BAAA,CAAmBL,UAAU,GAAAY,MAAA,IAAAA,MAAA,GAAAD,UAAA,IAAAJ,IAAA,GAAE;gBAAA,IAApBC,KAAI,GAAAI,MAAA,CAAAH,KAAA;gBACbd,QAAQ,CAACe,MAAM,CAAIhD,GAAG,SAAM8C,KAAc,CAAC;;cAE7C;;UACA;YAAS;cACT,IAAMP,SAAQ,GAAGD,UAAU,CAACE,IAAI,CAAC,GAAG,CAAC;cACrCP,QAAQ,CAACQ,GAAG,CAACzC,GAAG,EAAEuC,SAAQ,CAAC;;;OAGhC,MAAM;QACLN,QAAQ,CAACQ,GAAG,CAACzC,GAAG,EAAE+B,MAAM,CAAC/B,GAAG,CAAW,CAAC;;;IAG5CkB,OAAO,CAACC,GAAG,CAAC;MAACgC,KAAK,EAAElB,QAAQ,CAACmB,QAAQ;KAAG,CAAC;IACzC,OAAOnB,QAAQ;GAChB;;EAED,IAAMoB,qBAAqB,GAAG,SAAxBA,qBAAqBA,CAAAC,KAAA;QAAMC,YAAY,GAAAD,KAAA,CAAZC,YAAY;MAAEC,aAAa,GAAAF,KAAA,CAAbE,aAAa;;;IAI1D,IAAMC,cAAc,GAAG7D,MAAM,CAAC8D,OAAO,CAACH,YAAY,CAAC,CAACI,KAAK,CACvD,UAAAC,KAAA;MAAA,IAAE5D,GAAG,GAAA4D,KAAA;QAAEb,KAAK,GAAAa,KAAA;MAAA,OAAMJ,aAAa,CAACxD,GAAG,CAAC,KAAK+C,KAAK;MAC/C;IAED,OAAOU,cAAc;GACtB;EAEDI,eAAS,CAAC;IAER,IAAMC,iBAAiB,GAAalE,MAAM,CAACC,IAAI,CAACrB,aAAa,CAAC;IAC9D,IAAMuF,eAAe,GAAanE,MAAM,CAACC,IAAI,CAACjB,WAAW,CAAC;IAC1D,IAAGkF,iBAAiB,CAACxD,MAAM,KAAK,CAAC,IAAIyD,eAAe,CAACzD,MAAM,KAAK,CAAC,EAAE;IAGnE,SAAS0D,oBAAoBA;MAE3B,IAAMC,mBAAmB,GAAInC,0BAA0B,CAACtD,aAAa,CAAC,CAAC4E,QAAQ,EAAE;MACjF,IAAMc,SAAS,GAAGC,SAAS,EAAE;MAC7B,IAAMC,eAAe,GAAGtC,0BAA0B,CAACoC,SAAS,CAAC,CAACd,QAAQ,EAAE;MACxE,IAAMiB,iBAAiB,GAAGvC,0BAA0B,CAAClD,WAAW,CAAC,CAACwE,QAAQ,EAAE;MAE5ElC,OAAO,CAACC,GAAG,CAAC;QAAC8C,mBAAmB,EAAnBA;OAAoB,CAAC;MAElC,IAAMK,cAAc,GAAYjB,qBAAqB,CAAC;QAAEE,YAAY,EAAE3E,WAAW;QAAE4E,aAAa,EAAEU;OAAW,CAAC;MAE9G,IAAI,CAACI,cAAc,EAAE;;QAInBC,YAAY,CAAC;UAAEnE,SAAS,EAAAZ,QAAA,KACnBhB,aAAa,EACbI,WAAW;SACd,CAAC;QACH;;;MAGF,IAAM4F,sBAAsB,GAAGnB,qBAAqB,CAAC;QAAEE,YAAY,EAAEc,iBAAiB;QAAEb,aAAa,EAAEhF;OAAe,CAAC;MAEvH,IAAIsF,iBAAiB,CAACxD,MAAM,GAAG,CAAC,IAAIkE,sBAAsB,EAAE;QAC1D,IAAIP,mBAAmB,KAAKG,eAAe,EAAE,OAAM;QACnDG,YAAY,CAAC;UAAEnE,SAAS,EAAE5B;SAAe,CAAC;;;IAI9CwF,oBAAoB,EAAE;;GAGvB,EAAE,EAAE,CAAC;;;;;;EAON,IAAMS,mBAAmB,GAAG,SAAtBA,mBAAmBA,CAAI1B,KAAa,EAAE/C,GAAW;;IAErD,IAAI,OAAOV,iBAAiB,CAACU,GAAG,CAAC,KAAK,QAAQ,EAAE;MAC9C,OAAO0E,QAAQ,CAAC3B,KAAK,CAAC;KACvB,MAAM,IAAI,OAAOzD,iBAAiB,CAACU,GAAG,CAAC,KAAK,SAAS,EAAE;MACtD,OAAO+C,KAAK,KAAK,MAAM;KACxB,MAAM,IAAIrD,KAAK,CAACO,OAAO,CAACX,iBAAiB,CAACU,GAAG,CAAC,CAAC,EAAE;;MAGhD,IAAItB,kBAAkB,KAAK,KAAK,EAAE;QAChC,OAAOO,YAAY,CAACgC,MAAM,CAACjB,GAAG,CAAC,CAACwC,IAAI,CAAC,EAAE,CAAC,CAAC7B,KAAK,CAAC,GAAG,CAAC;OACpD,MAAM,IAAIjC,kBAAkB,KAAK,QAAQ,EAAE;QAE1CwC,OAAO,CAACC,GAAG,CAAC;UAACwD,aAAa,EAAE1F,YAAY,CAACgC,MAAM,CAACjB,GAAG;SAAE,CAAC;QACtD,OAAOf,YAAY,CAACgC,MAAM,CAACjB,GAAG,CAAC;OAChC,MAAM,IAAItB,kBAAkB,KAAK,UAAU,EAAE;QAC5C,OAAOO,YAAY,CAACgC,MAAM,CAAIjB,GAAG,OAAI,CAAC;;;;IAM1C,OAAO+C,KAAK;GACb;;;;;EAMC,IAAM6B,YAAY,GAAG,SAAfA,YAAYA,CAAI5E,GAAW,EAAEkE,SAAkC;IACnE,IAAMW,UAAU,GAAGnF,KAAK,CAACO,OAAO,CAACX,iBAAiB,CAACU,GAAG,CAAC,CAAC;IACxD,IAAI6E,UAAU,EAAE;MAAA,IAAAC,sBAAA;MAEd,IAAIpG,kBAAkB,KAAK,UAAU,EAAE;QAAA,IAAAqG,qBAAA;QAErC,IAAMC,QAAQ,GAAG/F,YAAY,CAACgC,MAAM,CAAIjB,GAAG,OAAI,CAAC;QAChD,IAAMiF,iBAAiB,GAAGnD,0BAA0B,EAAAiD,qBAAA,OAAAA,qBAAA,CAAI/E,GAAG,IAAGgF,QAAQ,EAAAD,qBAAA,EAAG,CAAC3B,QAAQ,EAAE;;QAEpF,IAAM8B,aAAa,GAAGC,kBAAkB,CAACF,iBAAiB,CAAC;QAC3D,OAAOC,aAAa;OACrB,MAAM,IAAIxG,kBAAkB,KAAK,KAAK,EAAE;QAAA,IAAA0G,sBAAA;QACvC,IAAM9C,WAAU,GAAGrD,YAAY,CAACgC,MAAM,CAACjB,GAAG,CAAC;QAC3C,IAAMiF,kBAAiB,GAAGnD,0BAA0B,EAAAsD,sBAAA,OAAAA,sBAAA,CAAIpF,GAAG,IAAGsC,WAAU,EAAA8C,sBAAA,EAAG,CAAChC,QAAQ,EAAE;QACtF,IAAM8B,cAAa,GAAGC,kBAAkB,CAACF,kBAAiB,CAAC;QAC3D,OAAOC,cAAa;;MAEtB,IAAM5C,UAAU,GAAGrD,YAAY,CAACgC,MAAM,CAACjB,GAAG,CAAC;MAC3C,IAAMqF,YAAY,GAAGvD,0BAA0B,EAAAgD,sBAAA,OAAAA,sBAAA,CAAI9E,GAAG,IAAGsC,UAAU,EAAAwC,sBAAA,EAAG,CAAC1B,QAAQ,EAAE;MACjF,OAAOiC,YAAY;KACpB,MAAM;MAEL,OAAOnB,SAAS,CAAClE,GAAG,CAAW;;GAEjC;EACD,IAAMsF,YAAY,GAAG,SAAfA,YAAYA,CAAIrG,YAA6B;IAClD,IAAMsG,SAAS,GAAsC,EAAE;;IAEvD,SAAAC,UAAA,GAAA7C,+BAAA,CAA2B1D,YAAY,CAACyE,OAAO,EAAE,GAAA+B,MAAA,IAAAA,MAAA,GAAAD,UAAA,IAAA3C,IAAA,GAAE;MAAA,IAAA6C,YAAA,GAAAD,MAAA,CAAA1C,KAAA;QAAvC/C,GAAG,GAAA0F,YAAA;QAAE3C,KAAK,GAAA2C,YAAA;MACpB,IAAI1F,GAAG,CAAC2F,QAAQ,CAAC,IAAI,CAAC,EAAE;QACtB,IAAMC,OAAO,GAAG5F,GAAG,CAAC6F,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACrC,IAAIN,SAAS,CAACK,OAAO,CAAC,EAAE;UACrBL,SAAS,CAACK,OAAO,CAAc,CAACE,IAAI,CAAC/C,KAAK,CAAC;SAC7C,MAAM;UACLwC,SAAS,CAACK,OAAO,CAAC,GAAG,CAAC7C,KAAK,CAAC;;OAE/B,MAAM;;QAEL,IAAIwC,SAAS,CAACvF,GAAG,CAAC,EAAE;UAClB,IAAIN,KAAK,CAACO,OAAO,CAACsF,SAAS,CAACvF,GAAG,CAAC,CAAC,EAAE;YAChCuF,SAAS,CAACvF,GAAG,CAAc,CAAC8F,IAAI,CAAC/C,KAAK,CAAC;WACzC,MAAM;YACLwC,SAAS,CAACvF,GAAG,CAAC,GAAG,CAACuF,SAAS,CAACvF,GAAG,CAAW,EAAE+C,KAAK,CAAC;;SAErD,MAAM;UACLwC,SAAS,CAACvF,GAAG,CAAC,GAAG+C,KAAK;;;;IAI5B,OAAOwC,SAAS;GAChB;;EAEF,IAAMQ,kBAAkB,GAA4BxG,aAAO,CAAC;IAE1D,OAAOb,kBAAkB,KAAK,UAAU,GAAG4G,YAAY,CAACrG,YAAY,CAAC,GAAGW,MAAM,CAACoG,WAAW,CAAC/G,YAAY,CAACyE,OAAO,EAAE,CAAC;GACnH,EAAE,CAACzE,YAAY,EAAEP,kBAAkB,CAAC,CAAC;EAEtC,IAAMyF,SAAS,GAAG,SAAZA,SAASA,CAAA8B,KAAA;mCAAyB,EAAE,GAAAA,KAAA;MAAAC,aAAA,GAAAC,KAAA,CAArBC,OAAO;MAAPA,OAAO,GAAAF,aAAA,cAAG,IAAI,GAAAA,aAAA;;IAGjC,IAAMnE,MAAM,GAAGnC,MAAM,CAACC,IAAI,CAACkG,kBAAkB,CAAC,CAACM,MAAM,CAAC,UAACC,GAAG,EAAEtG,GAAG;MAC7D,IAAIJ,MAAM,CAAC2G,SAAS,CAACC,cAAc,CAACC,IAAI,CAACnH,iBAAiB,EAAEU,GAAG,CAAC,EAAE;QAChE,IAAM0G,OAAO,GAAGhI,kBAAkB,KAAK,UAAU,GAAGsB,GAAG,CAAC6F,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG7F,GAAG;;QAE/EsG,GAAG,CAACI,OAAO,CAAC,GAAGN,OAAO,KAAK,IAAI,GAC3B3B,mBAAmB,CAACsB,kBAAkB,CAAC/F,GAAG,CAAW,EAAEA,GAAG,CAAC,GAC1D4E,YAAY,CAAC5E,GAAG,EAAE+F,kBAAkB,CAAC;;MAE5C,OAAOO,GAAG;KACX,EAAE,EAAE,CAAC;IAEN,OAAOvE,MAA2B;GACnC;EAIH,IAAM4E,QAAQ,GAAG,SAAXA,QAAQA,CAAuB3G,GAAS,EAAE4G,OAAwB;IAEtE,IAAMC,MAAM,GAAGC,MAAM,CAAC9G,GAAG,CAAC;;IAE1B,IAAM+C,KAAK,GAAG,CAAA6D,OAAO,oBAAPA,OAAO,CAAER,OAAO,MAAK,IAAI,GAAG3B,mBAAmB,CAACxF,YAAY,CAACyB,GAAG,CAACmG,MAAM,CAAC,EAAEA,MAAM,CAAC,GAAGjC,YAAY,CAACiC,MAAM,EAAGd,kBAAkB,CAAC;IAC3I,OAAOhD,KAAqB;GAC7B;EAID,IAAMgE,0BAA0B,GAAG,SAA7BA,0BAA0BA,CAAI3G,SAA8C,EAAE4G,UAAmC;;IAErH,IAAMjF,MAAM,GAAGoC,SAAS,EAAE;;;IAG1B,IAAM8C,qBAAqB,GAAGrH,MAAM,CAAC8D,OAAO,CAACtD,SAAS,CAAC,CAACL,MAAM,CAAC,UAAAmH,KAAA;MAAA,IAAElH,GAAG,GAAAkH,KAAA;MAAA,OAAO,CAACxH,KAAK,CAACO,OAAO,CAACX,iBAAiB,CAACU,GAAG,CAAC,CAAC;MAAC;IAClH,IAAMmH,MAAM,GAAGvH,MAAM,CAACwH,MAAM,CAAA5H,QAAA,KACvBuC,MAAM,EACNnC,MAAM,CAACoG,WAAW,CAACiB,qBAAqB,CAAC,EACzCrI,WAAW,CACf,CAAC;IACF,IAAMyI,cAAc,GAA2BzH,MAAM,CAACC,IAAI,CAACsH,MAAM,CAAC,CAACd,MAAM,CAAC,UAACC,GAAG,EAAEtG,GAAG;;MAEjF,IAAIJ,MAAM,CAAC2G,SAAS,CAACC,cAAc,CAACC,IAAI,CAACO,UAAU,EAAEhH,GAAG,CAAC,IAAIgH,UAAU,CAAChH,GAAG,CAAC,KAAK,KAAK,EAAE;QACtF,OAAOsG,GAAG;;OAEX,MAAM,IAAI,CAAC,CAACa,MAAM,CAACnH,GAAG,CAAC,KAAK,KAAK,IAAI,CAAClB,kBAAkB,CAAC4C,QAAQ,CAACyF,MAAM,CAACnH,GAAG,CAAC,CAAC,EAAE;;QAE/EsG,GAAG,CAACtG,GAAG,CAAC,GAAGmH,MAAM,CAACnH,GAAG,CAAC;;MAGxB,OAAOsG,GAAG;KACX,EAAE,EAAE,CAAC;IAEN,OAAA9G,QAAA,KACKrB,SAAS,EACTkJ,cAAc;GAEpB;;EAED,IAAMC,cAAc,GAAG,SAAjBA,cAAcA,CAAID,cAAc;;;IAGpC,IAAME,aAAa,GAAG9H,WAAW,CAAC4G,MAAM,CAAC,UAACC,GAAG,EAAEtG,GAAG;MAChD,IAAIJ,MAAM,CAAC2G,SAAS,CAACC,cAAc,CAACC,IAAI,CAACY,cAAc,EAAErH,GAAG,CAAC,EAAE;;QAE7DsG,GAAG,CAACtG,GAAG,CAAC,GAAGqH,cAAc,CAACrH,GAAG,CAAC;;MAGhC,OAAOsG,GAAG;KACX,EAAE,EAAE,CAAC;IACN,OAAOiB,aAAa;GACrB;EAED,IAAMC,mBAAmB,GAAG,SAAtBA,mBAAmBA;;IAEvB,IAAMC,kBAAkB,GAAY3H,UAAU,CAACQ,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,KAAK;IACxE,IAAMoH,eAAe,GAA6BvD,SAAS,CAAC;MAAEiC,OAAO,EAAEqB;KAAoB,CAAC;IAE5F,IAAME,cAAc,GAA4B/H,MAAM,CAACC,IAAI,CAAC6H,eAAe,CAAC,CAACrB,MAAM,CACjF,UAACC,GAAG,EAAEtG,GAAG;MACP,IAAIJ,MAAM,CAAC2G,SAAS,CAACC,cAAc,CAACC,IAAI,CAACtI,SAAS,EAAE6B,GAAG,CAAC,EAAE;;QAExDsG,GAAG,CAACtG,GAAG,CAAC,GAAG0H,eAAe,CAAC1H,GAAG,CAAC;;MAEjC,OAAOsG,GAAG;KACX,EACD,EAAE,CACH;IAED,OAAOqB,cAAc;GACtB;EAED,IAAMC,WAAW,GAAG,SAAdA,WAAWA,CAAAC,MAAA;oCAAqC,EAAE,GAAAA,MAAA;MAAAC,qBAAA,GAAAC,KAAA,CAAjCC,mBAAmB;MAAnBA,mBAAmB,GAAAF,qBAAA,cAAG,IAAI,GAAAA,qBAAA;;IAE/C,IAAMG,iBAAiB,GAAGnG,0BAA0B,CAAAtC,QAAA,KAE7CrB,SAAS,EAEP6J,mBAAmB,IAAAxI,QAAA,KACnBgI,mBAAmB,EAAE,CACzB,EACE5I,WAAW,CACf,CACF;IACDM,eAAe,CAAC+I,iBAAiB,CAAC;GACnC;EAMD,IAAM1D,YAAY,GAAG,SAAfA,YAAYA,CAAA2D,MAAA;oCAAqE,EAAE,GAAAA,MAAA;MAAAC,eAAA,GAAAC,KAAA,CAAjEhI,SAAS;MAATA,SAAS,GAAA+H,eAAA,cAAG,EAAe,GAAAA,eAAA;MAAAE,gBAAA,GAAAD,KAAA,CAAEpB,UAAU;MAAVA,UAAU,GAAAqB,gBAAA,cAAG,EAAgB,GAAAA,gBAAA;IAEhF,IACEzI,MAAM,CAACC,IAAI,CAACO,SAAS,CAAC,CAACE,MAAM,KAAK,CAAC,IACnCV,MAAM,CAACC,IAAI,CAACmH,UAAU,CAAC,CAAC1G,MAAM,KAAK,CAAC,EACpC;MACAsH,WAAW,EAAE;MACb;;;IAGF,IAAMU,gBAAgB,GAAGvB,0BAA0B,CAAC3G,SAAS,EAAE4G,UAAU,CAAC;IAE1E,IAAMuB,oBAAoB,GAAGrI,iBAAiB,CAACoI,gBAAgB,EAAElI,SAAS,CAAC;IAE3E,IAAMoI,YAAY,GAAGlB,cAAc,CAACiB,oBAAoB,CAAC;IAEzDrJ,eAAe,CAAC4C,0BAA0B,CAAC0G,YAAY,CAAC,CAAC;GAE1D;;EAGC,IAAMC,QAAQ,GAAGC,iBAAW,CAAE,UAACC,SAAe,EAAEC,SAA4B;IAC1E,IAAMC,YAAY,GAAG/B,MAAM,CAAC6B,SAAS,CAAC;;IAEtCxJ,gBAAgB,CAAC2J,OAAO,CAACD,YAAY,CAAC,GAAGD,SAAS;GACnD,EAAE,EAAE,CAAC;;EAGN/E,eAAS,CAAC;IAER,SAAAkF,GAAA,MAAAC,eAAA,GAA2BpJ,MAAM,CAAC8D,OAAO,CAACvE,gBAAgB,CAAC2J,OAAO,CAAC,EAAAC,GAAA,GAAAC,eAAA,CAAA1I,MAAA,EAAAyI,GAAA,IAAE;MAAA,IAAAE,qBAAA,EAAAC,qBAAA;MAAhE,IAAAC,kBAAA,GAAAH,eAAA,CAAAD,GAAA;QAAO/I,GAAG,GAAAmJ,kBAAA;QAAEpG,KAAK,GAAAoG,kBAAA;MAEpB,IAAMC,QAAQ,IAAAH,qBAAA,GAAGlD,kBAAkB,CAAC/F,GAAG,CAAC,YAAAiJ,qBAAA,GAAI,IAAI;MAChD,IAAMI,QAAQ,IAAAH,qBAAA,GAAG7J,iBAAiB,CAACyJ,OAAO,CAAC9I,GAAG,CAAC,YAAAkJ,qBAAA,GAAI,IAAI;MACvD,IAAIE,QAAQ,KAAKC,QAAQ,EAAE;QAEzB,SAAAC,UAAA,GAAA3G,+BAAA,CAAuBI,KAAK,GAAAwG,MAAA,IAAAA,MAAA,GAAAD,UAAA,IAAAzG,IAAA,GAAE;UAAA,IAAnB2G,QAAQ,GAAAD,MAAA,CAAAxG,KAAA;UACjB7B,OAAO,CAACC,GAAG,CAAC4B,KAAK,CAAC;UAElByG,QAAQ,EAAE;;;;MAKdnK,iBAAiB,CAACyJ,OAAO,CAAC9I,GAAG,CAAC,GAAGoJ,QAAQ;;GAI5C,EAAE,CAACrD,kBAAkB,CAAC,CAAC;EAC1B,OAAO;IACL9G,YAAY,EAAZA,YAAY;IACZsF,YAAY,EAAZA,YAAY;IACZqD,WAAW,EAAXA,WAAW;IACXzD,SAAS,EAATA,SAAS;IACTwC,QAAQ,EAARA,QAAQ;IACR8B,QAAQ,EAARA;GACD;AACH;;;;"}

package/dist/react-magic-search-params.cjs.production.min.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"react-magic-search-params.cjs.production.min.js","sources":["../src/useMagicSearchParams.ts"],"sourcesContent":["import { useSearchParams } from 'react-router-dom'\r\nimport { useMemo, useEffect, useRef, useCallback } from 'react'\r\n\r\n\r\n// Custom hook with advanced techniques to handle search parameters for any pagination\r\n\r\ntype CommonParams = {\r\n page?: number\r\n page_size?: number\r\n}\r\n/\r\nMaps all properties of M (mandatory) as required\r\nand all properties of O (optional) as optional. \r\n/\r\ntype MergeParams<M, O> = {\r\n [K in keyof M]: M[K]\r\n} & {\r\n [K in keyof O]?: O[K]\r\n}\r\n/*\r\n Interface for the configuration object that the hook receives \r\n /\r\ninterface UseMagicSearchParamsOptions<\r\n M extends Record<string, unknown>,\r\n O extends Record<string, unknown>\r\n> {\r\n mandatory: M \r\n optional?: O\r\n defaultParams?: Partial<MergeParams<M, O>>\r\n forceParams?: Partial<MergeParams<M, O>> // transform all to partial to avoid errors\r\n arraySerialization?: 'csv' \| 'repeat' \| 'brackets' // technical to serialize arrays in the URL\r\n omitParamsByValues?: Array<'all' \| 'default' \| 'unknown' \| 'none' \| 'void '> \r\n}\r\n\r\n/* \r\nGeneric hook to handle search parameters in the URL\r\n@param mandatory - Mandatory parameters (e.g., page=1, page_size=10, etc.)\r\n@param optional - Optional parameters (e.g., order, search, etc.)\r\n@param defaultParams - Default parameters sent in the URL on initialization\r\n@param forceParams - Parameters forced into the URL regardless of user input\r\n@param omitParamsByValues - Parameters omitted if they have specific values \r\n/\r\nexport const useMagicSearchParams = <\r\n M extends Record<string, unknown> & CommonParams,\r\n O extends Record<string, unknown>,\r\n>({\r\n mandatory = {} as M,\r\n optional = {} as O,\r\n defaultParams = {} as Partial<MergeParams<M, O>>,\r\n arraySerialization = 'csv',\r\n forceParams = {} as {} as Partial<MergeParams<M, O>>,\r\n omitParamsByValues = [] as Array<'all' \| 'default' \| 'unknown' \| 'none' \| 'void '>\r\n}: UseMagicSearchParamsOptions<M, O>)=> {\r\n\r\n\r\n const [searchParams, setSearchParams] = useSearchParams() \r\n // Ref to store subscriptions: { paramName: [callback1, callback2, ...] }\r\n const subscriptionsRef = useRef<Record<string, Array<() => unknown>>>({}); \r\n const previousParamsRef = useRef<Record<string, unknown>>({})\r\n\r\n const TOTAL_PARAMS_PAGE: MergeParams<M, O> = useMemo(() => {\r\n return { ...mandatory, ...optional };\r\n }, [mandatory, optional]);\r\n\r\n const PARAM_ORDER = useMemo(() => {\r\n return Array.from(Object.keys(TOTAL_PARAMS_PAGE))\r\n }, [TOTAL_PARAMS_PAGE])\r\n\r\n // we get the keys that are arrays according to TOTAL_PARAMS_PAGE since these require special treatment in the URL due to serialization mode\r\n const ARRAY_KEYS = useMemo(() => {\r\n return Object.keys(TOTAL_PARAMS_PAGE).filter(\r\n (key) => Array.isArray(TOTAL_PARAMS_PAGE[key])\r\n );\r\n }, [TOTAL_PARAMS_PAGE])\r\n\r\n const appendArrayValues = (\r\n finallyParams: Record<string, unknown>,\r\n newParams: Record<string, string \| string[] \| unknown>\r\n ): Record<string, unknown> => {\r\n \r\n // Note: We cannot modify the object of the final parameters directly, as immutability must be maintained\r\n const updatedParams = { ...finallyParams };\r\n \r\n\r\n if (ARRAY_KEYS.length === 0) return updatedParams;\r\n \r\n ARRAY_KEYS.forEach((key) => {\r\n // We use the current values directly from searchParams (source of truth)\r\n // This avoids depending on finallyParams in which the arrays have been omitted\r\n let currentValues = []; \r\n switch (arraySerialization) {\r\n case 'csv': {\r\n const raw = searchParams.get(key) \|\| '';\r\n // For csv we expect \"value1,value2,...\" (no prefix)\r\n currentValues = raw.split(',')\r\n .map((v) => v.trim())\r\n .filter(Boolean) as Array<string>\r\n break;\r\n }\r\n case 'repeat': {\r\n // Here we get all ocurrences of key\r\n const urlParams = searchParams.getAll(key) as Array<string>\r\n currentValues = urlParams.length > 0 ? urlParams : []\r\n \r\n console.log({REPEAT: currentValues})\r\n break;\r\n }\r\n case 'brackets': {\r\n // Build URLSearchParams from current parameters (to ensure no serialized values are taken previously)\r\n const urlParams = searchParams.getAll(`${key}[]`) as Array<string>\r\n currentValues = urlParams.length > 0 ? urlParams : []\r\n console.log({BRACKETS: urlParams})\r\n \r\n \r\n break;\r\n }\r\n default: {\r\n // Mode by default works as csv\r\n const raw = searchParams.get(key) ?? '';\r\n currentValues = raw.split(',')\r\n .map((v) => v.trim())\r\n .filter(Boolean);\r\n }\r\n break; \r\n }\r\n // Update array values with new ones\r\n \r\n if (newParams[key] !== undefined) {\r\n const incoming = newParams[key];\r\n let combined: string[] = []\r\n if (typeof incoming === 'string') {\r\n // If it is a string, it is toggled (add/remove)\r\n combined = currentValues.includes(incoming)\r\n ? currentValues.filter((v) => v !== incoming)\r\n : [...currentValues, incoming];\r\n console.log({currentValues})\r\n console.log({incoming})\r\n console.log({CONBINED_STRING: combined})\r\n } else if (Array.isArray(incoming)) {\r\n // if an array is passed, repeated values are merged into a single value\r\n // Note: Set is used to remove duplicates\r\n combined = Array.from(new Set([ ...incoming]));\r\n console.log({incoming})\r\n console.log({combined})\r\n } else {\r\n \r\n combined = currentValues;\r\n }\r\n\r\n updatedParams[key] = combined\r\n\r\n }\r\n });\r\n console.log({updatedParams})\r\n return updatedParams\r\n };\r\n\r\n const transformParamsToURLSearch = (params: Record<string, unknown>): URLSearchParams => {\r\n console.log({PARAMS_RECIBIDOS_TRANSFORM: params})\r\n\r\n const newParam: URLSearchParams = new URLSearchParams()\r\n\r\n const paramsKeys = Object.keys(params)\r\n\r\n for (const key of paramsKeys) {\r\n if (Array.isArray(TOTAL_PARAMS_PAGE[key])) {\r\n const arrayValue = params[key] as unknown[]\r\n console.log({arrayValue})\r\n switch (arraySerialization) {\r\n case 'csv': {\r\n const csvValue = arrayValue.join(',')\r\n // set ensure that the previous value is replaced\r\n newParam.set(key, csvValue)\r\n break\r\n } case 'repeat': {\r\n \r\n for (const item of arrayValue) {\r\n console.log({item})\r\n // add new value to the key, instead of replacing it\r\n newParam.append(key, item as string)\r\n \r\n }\r\n break\r\n } case 'brackets': {\r\n for (const item of arrayValue) {\r\n newParam.append(`${key}[]`, item as string)\r\n }\r\n break\r\n } default: {\r\n const csvValue = arrayValue.join(',')\r\n newParam.set(key, csvValue)\r\n }\r\n }\r\n } else {\r\n newParam.set(key, params[key] as string)\r\n }\r\n }\r\n console.log({FINAL: newParam.toString()})\r\n return newParam\r\n }\r\n // @ts-ignore\r\n const hasForcedParamsValues = ({ paramsForced, compareParams }) => {\r\n\r\n // Iterates over the forced parameters and verifies that they exist in the URL and match their values\r\n // Ej: { page: 1, page_size: 10 } === { page: 1, page_size: 10 } => true\r\n const allParamsMatch = Object.entries(paramsForced).every(\r\n ([key, value]) => compareParams[key] === value\r\n );\r\n\r\n return allParamsMatch;\r\n };\r\n \r\n useEffect(() => {\r\n\r\n const keysDefaultParams: string[] = Object.keys(defaultParams)\r\n const keysForceParams: string[] = Object.keys(forceParams)\r\n if(keysDefaultParams.length === 0 && keysForceParams.length === 0) return\r\n \r\n\r\n function handleStartingParams() {\r\n\r\n const defaultParamsString = transformParamsToURLSearch(defaultParams).toString()\r\n const paramsUrl = getParams()\r\n const paramsUrlString = transformParamsToURLSearch(paramsUrl).toString()\r\n const forceParamsString = transformParamsToURLSearch(forceParams).toString()\r\n\r\n console.log({defaultParamsString})\r\n\r\n const isForcedParams: boolean = hasForcedParamsValues({ paramsForced: forceParams, compareParams: paramsUrl })\r\n\r\n if (!isForcedParams) {\r\n\r\n // In this case, the forced parameters take precedence over the default parameters and the parameters of the current URL (which could have been modified by the user, e.g., page_size=1000)\r\n\r\n updateParams({ newParams: {\r\n ...defaultParams,\r\n ...forceParams\r\n }})\r\n return\r\n }\r\n // In this way it will be validated that the forced parameters keys and values are in the current URL\r\n const isIncludesForcedParams = hasForcedParamsValues({ paramsForced: forceParamsString, compareParams: defaultParams })\r\n\r\n if (keysDefaultParams.length > 0 && isIncludesForcedParams) {\r\n if (defaultParamsString === paramsUrlString) return // this means that the URL already has the default parameters\r\n updateParams({ newParams: defaultParams })\r\n }\r\n\r\n }\r\n handleStartingParams()\r\n\r\n // eslint-disable-next-line react-hooks/exhaustive-deps\r\n }, [])\r\n\r\n /\r\n Convert a string value to its original type (number, boolean, array) according to TOTAL_PARAMS_PAGE\r\n * @param value - Chain obtained from the URL\r\n * @param key - Key of the parameter\r\n /\r\n const convertOriginalType = (value: string, key: string) => {\r\n // Given that the parameters of a URL are recieved as strings, they are converted to their original type\r\n if (typeof TOTAL_PARAMS_PAGE[key] === 'number') {\r\n return parseInt(value)\r\n } else if (typeof TOTAL_PARAMS_PAGE[key] === 'boolean') {\r\n return value === 'true'\r\n } else if (Array.isArray(TOTAL_PARAMS_PAGE[key])) {\r\n // The result will be a valid array represented in the URL ej: tags=tag1,tag2,tag3 to ['tag1', 'tag2', 'tag3'], useful to combine the values of the arrays with the new ones\r\n \r\n if (arraySerialization === 'csv') {\r\n return searchParams.getAll(key).join('').split(',')\r\n } else if (arraySerialization === 'repeat') {\r\n \r\n console.log({SEARCH_PARAMS: searchParams.getAll(key)})\r\n return searchParams.getAll(key)\r\n } else if (arraySerialization === 'brackets') {\r\n return searchParams.getAll(`${key}[]`)\r\n }\r\n \r\n \r\n }\r\n // Note: dates are not converted as it is better to handle them directly in the component that receives them, using a library like < date-fns >\r\n return value\r\n }\r\n \r\n /\r\n Gets the current parameters from the URL and converts them to their original type if desired\r\n * @param convert - If true, converts from string to the inferred type (number, boolean, ...)\r\n */\r\n const getStringUrl = (key: string, paramsUrl: Record<string, unknown>) => {\r\n const isKeyArray = Array.isArray(TOTAL_PARAMS_PAGE[key])\r\n if (isKeyArray) {\r\n\r\n if (arraySerialization === 'brackets') {\r\n\r\n const arrayUrl = searchParams.getAll(`${key}[]`)\r\n const encodedQueryArray = transformParamsToURLSearch({ [key]: arrayUrl }).toString()\r\n // in this way the array of the URL is decoded to its original form ej: tags[]=tag1&tags[]=tag2&tags[]=tag3\r\n const unencodeQuery = decodeURIComponent(encodedQueryArray)\r\n return unencodeQuery\r\n } else if (arraySerialization === 'csv') {\r\n const arrayValue = searchParams.getAll(key)\r\n const encodedQueryArray = transformParamsToURLSearch({ [key]: arrayValue }).toString()\r\n const unencodeQuery = decodeURIComponent(encodedQueryArray)\r\n return unencodeQuery\r\n }\r\n const arrayValue = searchParams.getAll(key)\r\n const stringResult = transformParamsToURLSearch({ [key]: arrayValue }).toString()\r\n return stringResult\r\n } else {\r\n \r\n return paramsUrl[key] as string\r\n }\r\n }\r\n const getParamsObj = (searchParams: URLSearchParams): Record<string, string \| string[]> => {\r\n const paramsObj: Record<string, string \| string[]> = {};\r\n // @ts-ignore\r\n for (const [key, value] of searchParams.entries()) {\r\n if (key.endsWith('[]')) {\r\n const bareKey = key.replace('[]', '');\r\n if (paramsObj[bareKey]) {\r\n (paramsObj[bareKey] as string[]).push(value);\r\n } else {\r\n paramsObj[bareKey] = [value];\r\n }\r\n } else {\r\n // If the key already exists, it is a repeated parameter\r\n if (paramsObj[key]) {\r\n if (Array.isArray(paramsObj[key])) {\r\n (paramsObj[key] as string[]).push(value);\r\n } else {\r\n paramsObj[key] = [paramsObj[key] as string, value];\r\n }\r\n } else {\r\n paramsObj[key] = value;\r\n }\r\n }\r\n }\r\n return paramsObj;\r\n }\r\n // Optimization: While the parameters are not updated, the current parameters of the URL are not recalculated\r\n const CURRENT_PARAMS_URL: Record<string, unknown> = useMemo(() => {\r\n\r\n return arraySerialization === 'brackets' ? getParamsObj(searchParams) : Object.fromEntries(searchParams.entries())\r\n }, [searchParams, arraySerialization])\r\n\r\n const getParams = ({ convert = true } = {}): MergeParams<M, O> => {\r\n // All the paramteres are extracted from the URL and converted into an object\r\n\r\n const params = Object.keys(CURRENT_PARAMS_URL).reduce((acc, key) => {\r\n if (Object.prototype.hasOwnProperty.call(TOTAL_PARAMS_PAGE, key)) {\r\n const realKey = arraySerialization === 'brackets' ? key.replace('[]', '') : key\r\n // @ts-ignore\r\n acc[realKey] = convert === true\r\n ? convertOriginalType(CURRENT_PARAMS_URL[key] as string, key)\r\n : getStringUrl(key, CURRENT_PARAMS_URL)\r\n }\r\n return acc\r\n }, {})\r\n \r\n return params as MergeParams<M, O>\r\n }\r\n type keys = keyof MergeParams<M, O>\r\n // Note: in this way the return of the getParam function is typed dynamically, thus having autocomplete in the IDE (eg: value.split(','))\r\n type TagReturn<T extends boolean> = T extends true ? string[] : string;\r\n const getParam = <T extends boolean>(key: keys, options?: { convert: T }): TagReturn<T> => {\r\n\r\n const keyStr = String(key)\r\n // @ts-ignore\r\n const value = options?.convert === true ? convertOriginalType(searchParams.get(keyStr), keyStr) : getStringUrl(keyStr, CURRENT_PARAMS_URL)\r\n return value as TagReturn<T> \r\n }\r\n \r\n type OptionalParamsFiltered = Partial<O>\r\n\r\n const calculateOmittedParameters = (newParams: Record<string, unknown \| unknown[]>, keepParams: Record<string, boolean>) => {\r\n // Calculate the ommited parameters, that is, the parameters that have not been sent in the request\r\n const params = getParams()\r\n // hasOw\r\n // Note: it will be necessary to omit the parameters that are arrays because the idea is not to replace them but to add or remove some values\r\n const newParamsWithoutArray = Object.entries(newParams).filter(([key,]) => !Array.isArray(TOTAL_PARAMS_PAGE[key]))\r\n const result = Object.assign({\r\n ...params,\r\n ...Object.fromEntries(newParamsWithoutArray),\r\n ...forceParams // the forced parameters will always be sent and will maintain their value\r\n })\r\n const paramsFiltered: OptionalParamsFiltered = Object.keys(result).reduce((acc, key) => {\r\n // for default no parameters are omitted unless specified in the keepParams object\r\n if (Object.prototype.hasOwnProperty.call(keepParams, key) && keepParams[key] === false) {\r\n return acc\r\n // Note: They array of parameters omitted by values (e.g., ['all', 'default']) are omitted since they are usually a default value that is not desired to be sent\r\n } else if (!!result[key] !== false && !omitParamsByValues.includes(result[key])) {\r\n // @ts-ignore\r\n acc[key] = result[key]\r\n }\r\n\r\n return acc\r\n }, {})\r\n\r\n return {\r\n ...mandatory,\r\n ...paramsFiltered\r\n } \r\n }\r\n // @ts-ignore\r\n const sortParameters = (paramsFiltered) => {\r\n // sort the parameters according to the structure so that it persists with each change in the URL, eg: localhost:3000/?page=1&page_size=10\r\n // Note: this visibly improves the user experience\r\n const orderedParams = PARAM_ORDER.reduce((acc, key) => {\r\n if (Object.prototype.hasOwnProperty.call(paramsFiltered, key)) {\r\n // @ts-ignore\r\n acc[key] = paramsFiltered[key]\r\n }\r\n\r\n return acc\r\n }, {})\r\n return orderedParams\r\n }\r\n\r\n const mandatoryParameters = () => {\r\n // Note: in case there are arrays in the URL, they are converted to their original form ej: tags=['tag1', 'tag2'] otherwise the parameters are extracted without converting to optimize performance\r\n const isNecessaryConvert: boolean = ARRAY_KEYS.length > 0 ? true : false\r\n const totalParametros: Record<string, unknown> = getParams({ convert: isNecessaryConvert })\r\n\r\n const paramsUrlFound: Record<string, boolean> = Object.keys(totalParametros).reduce(\r\n (acc, key) => {\r\n if (Object.prototype.hasOwnProperty.call(mandatory, key)) {\r\n // @ts-ignore\r\n acc[key] = totalParametros[key]\r\n }\r\n return acc\r\n },\r\n {}\r\n )\r\n\r\n return paramsUrlFound\r\n }\r\n\r\n const clearParams = ({ keepMandatoryParams = true } = {}): void => {\r\n // for default, the mandatory parameters are not cleared since the current pagination would be lost\r\n const paramsTransformed = transformParamsToURLSearch(\r\n {\r\n ...mandatory,\r\n \r\n ...(keepMandatoryParams && {\r\n ...mandatoryParameters()\r\n }),\r\n ...forceParams \r\n }\r\n )\r\n setSearchParams(paramsTransformed) \r\n }\r\n\r\n // transforms the keys to boolean to know which parameters to keep\r\n type KeepParamsTransformedValuesBoolean = Partial<Record<keyof typeof TOTAL_PARAMS_PAGE, boolean>>\r\n type NewParams = Partial<typeof TOTAL_PARAMS_PAGE> \r\n type KeepParams = KeepParamsTransformedValuesBoolean\r\n const updateParams = ({ newParams = {} as NewParams, keepParams = {} as KeepParams } = {}) => {\r\n\r\n if (\r\n Object.keys(newParams).length === 0 &&\r\n Object.keys(keepParams).length === 0\r\n ) {\r\n clearParams()\r\n return\r\n }\r\n // @ts-ignore\r\n const finallyParamters = calculateOmittedParameters(newParams, keepParams)\r\n\r\n const convertedArrayValues = appendArrayValues(finallyParamters, newParams)\r\n\r\n const paramsSorted = sortParameters(convertedArrayValues)\r\n\r\n setSearchParams(transformParamsToURLSearch(paramsSorted))\r\n\r\n }\r\n\r\n // only for the keys of the parameters to subscribe to changes in the URL to trigger the callback\r\n const onChange = useCallback( (paramName: keys, callbacks: Array<() => void>) => {\r\n const paramNameStr = String(paramName)\r\n // replace the previous callbacks with the new ones so as not to accumulate callbacks\r\n subscriptionsRef.current[paramNameStr] = callbacks;\r\n }, [])\r\n \r\n // each time searchParams changes, we notify the subscribers\r\n useEffect(() => {\r\n\r\n for (const [key, value] of Object.entries(subscriptionsRef.current)) {\r\n\r\n const newValue = CURRENT_PARAMS_URL[key] ?? null \r\n const oldValue = previousParamsRef.current[key] ?? null\r\n if (newValue !== oldValue) {\r\n \r\n for (const callback of value) {\r\n console.log(value)\r\n\r\n callback()\r\n\r\n }\r\n }\r\n // once the callback is executed, the previous value is updated to ensure that the next time the value changes, the callback is executed\r\n previousParamsRef.current[key] = newValue\r\n }\r\n\r\n \r\n }, [CURRENT_PARAMS_URL])\r\n return {\r\n searchParams,\r\n updateParams,\r\n clearParams,\r\n getParams,\r\n getParam,\r\n onChange\r\n }\r\n}\r\n"],"names":["_ref","mandatory","_ref$mandatory","_ref$optional","optional","_ref$defaultParams","defaultParams","_ref$arraySerializati","arraySerialization","_ref$forceParams","forceParams","_ref$omitParamsByValu","omitParamsByValues","_useSearchParams","useSearchParams","searchParams","setSearchParams","subscriptionsRef","useRef","previousParamsRef","TOTAL_PARAMS_PAGE","useMemo","_extends","PARAM_ORDER","Array","from","Object","keys","ARRAY_KEYS","filter","key","isArray","transformParamsToURLSearch","params","console","log","PARAMS_RECIBIDOS_TRANSFORM","newParam","URLSearchParams","_i","_paramsKeys","length","arrayValue","csvValue","join","set","_step","_iterator","_createForOfIteratorHelperLoose","done","item","value","append","_step2","_iterator2","FINAL","toString","hasForcedParamsValues","_ref2","compareParams","entries","paramsForced","every","_ref3","useEffect","keysDefaultParams","keysForceParams","defaultParamsString","paramsUrl","getParams","paramsUrlString","forceParamsString","isIncludesForcedParams","updateParams","newParams","handleStartingParams","convertOriginalType","parseInt","getAll","split","SEARCH_PARAMS","getStringUrl","_transformParamsToURL3","_transformParamsToURL","arrayUrl","encodedQueryArray","decodeURIComponent","_transformParamsToURL2","CURRENT_PARAMS_URL","_step3","paramsObj","_iterator3","_step3$value","endsWith","bareKey","replace","push","getParamsObj","fromEntries","_temp","_ref4$convert","convert","reduce","acc","prototype","hasOwnProperty","call","clearParams","_temp2","totalParametros","_ref6$keepMandatoryPa","keepMandatoryParams","paramsTransformed","_temp3","_ref7$newParams","_ref7","_ref7$keepParams","keepParams","paramsFiltered","convertedArrayValues","finallyParams","updatedParams","forEach","currentValues","get","map","v","trim","Boolean","urlParams","REPEAT","BRACKETS","_searchParams$get","undefined","incoming","combined","includes","concat","CONBINED_STRING","Set","appendArrayValues","newParamsWithoutArray","_ref5","result","assign","calculateOmittedParameters","paramsSorted","onChange","useCallback","paramName","callbacks","paramNameStr","String","current","_i2","_Object$entries","_CURRENT_PARAMS_URL$k","_previousParamsRef$cu","_Object$entries$_i","newValue","_step4","_iterator4","callback","getParam","options","keyStr"],"mappings":"ipCA0CoC,SAAHA,WAI/BC,UAAAA,WAASC,EAAG,GAAOA,EAAAC,EAAAH,EACnBI,SAAAA,WAAQD,EAAG,GAAOA,EAAAE,EAAAL,EAClBM,cAAAA,WAAaD,EAAG,GAAgCA,EAAAE,EAAAP,EAChDQ,mBAAAA,WAAkBD,EAAG,MAAKA,EAAAE,EAAAT,EAC1BU,YAAAA,WAAWD,EAAG,GAAuCA,EAAAE,EAAAX,EACrDY,mBAAAA,WAAkBD,EAAG,GAA6DA,EAIlFE,EAAwCC,oBAAjCC,EAAYF,KAAEG,EAAeH,KAE9BI,EAAmBC,SAA6C,IAChEC,EAAoBD,SAAgC,IAEpDE,EAAuCC,WAAQ,WACnD,OAAAC,KAAYrB,EAAcG,KACzB,CAACH,EAAWG,IAETmB,EAAcF,WAAQ,WAC1B,OAAOG,MAAMC,KAAKC,OAAOC,KAAKP,MAC7B,CAACA,IAGEQ,EAAaP,WAAQ,WACzB,OAAOK,OAAOC,KAAKP,GAAmBS,QACpC,SAACC,GAAG,OAAKN,MAAMO,QAAQX,EAAkBU,SAE1C,CAACV,IAoFEY,EAA6B,SAACC,GAClCC,QAAQC,IAAI,CAACC,2BAA4BH,IAMzC,IAJA,IAAMI,EAA4B,IAAIC,gBAItCC,IAAAC,EAFmBd,OAAOC,KAAKM,GAEHM,EAAAC,EAAAC,OAAAF,IAAE,CAAzB,IAAMT,EAAGU,EAAAD,GACZ,GAAIf,MAAMO,QAAQX,EAAkBU,IAAO,CACzC,IAAMY,EAAaT,EAAOH,GAE1B,OADAI,QAAQC,IAAI,CAACO,WAAAA,IACLlC,GACN,IAAK,MACH,IAAMmC,EAAWD,EAAWE,KAAK,KAEjCP,EAASQ,IAAIf,EAAKa,GAClB,MACA,IAAK,SAEL,QAA6BG,EAA7BC,EAAAC,EAAmBN,KAAUI,EAAAC,KAAAE,MAAE,CAAA,IAApBC,EAAIJ,EAAAK,MACbjB,QAAQC,IAAI,CAACe,KAAAA,IAEbb,EAASe,OAAOtB,EAAKoB,GAGvB,MACA,IAAK,WACL,QAA6BG,EAA7BC,EAAAN,EAAmBN,KAAUW,EAAAC,KAAAL,MAC3BZ,EAASe,OAAUtB,OADNuB,EAAAF,OAGf,MACA,QACA,IAAMR,EAAWD,EAAWE,KAAK,KACjCP,EAASQ,IAAIf,EAAKa,SAItBN,EAASQ,IAAIf,EAAKG,EAAOH,IAI7B,OADAI,QAAQC,IAAI,CAACoB,MAAOlB,EAASmB,aACtBnB,GAGHoB,EAAwB,SAAHC,OAAoBC,EAAaD,EAAbC,cAQ7C,OAJuBjC,OAAOkC,QAJaF,EAAZG,cAIqBC,OAClD,SAAAC,GAAY,OAAMJ,EAAbI,QAAOA,SAMhBC,aAAU,WAER,IAAMC,EAA8BvC,OAAOC,KAAKrB,GAC1C4D,EAA4BxC,OAAOC,KAAKjB,GACd,IAA7BuD,EAAkBxB,QAA2C,IAA3ByB,EAAgBzB,QAGrD,WAEE,IAAM0B,EAAuBnC,EAA2B1B,GAAekD,WACjEY,EAAYC,IACZC,EAAkBtC,EAA2BoC,GAAWZ,WACxDe,EAAoBvC,EAA2BtB,GAAa8C,WAMlE,GAJAtB,QAAQC,IAAI,CAACgC,oBAAAA,IAEmBV,EAAsB,CAAEI,aAAcnD,EAAaiD,cAAeS,IAElG,CAWA,IAAMI,EAAyBf,EAAsB,CAAEI,aAAcU,EAAmBZ,cAAerD,IAEvG,GAAI2D,EAAkBxB,OAAS,GAAK+B,EAAwB,CAC1D,GAAIL,IAAwBG,EAAiB,OAC7CG,EAAa,CAAEC,UAAWpE,UAX1BmE,EAAa,CAAEC,UAASpD,KACnBhB,EACAI,KAaTiE,KAGC,IAOH,IAAMC,EAAsB,SAACzB,EAAerB,GAE1C,GAAsC,iBAA3BV,EAAkBU,GAC3B,OAAO+C,SAAS1B,GACX,GAAsC,kBAA3B/B,EAAkBU,GAClC,MAAiB,SAAVqB,EACF,GAAI3B,MAAMO,QAAQX,EAAkBU,IAAO,CAGhD,GAA2B,QAAvBtB,EACF,OAAOO,EAAa+D,OAAOhD,GAAKc,KAAK,IAAImC,MAAM,KAC1C,GAA2B,WAAvBvE,EAGT,OADA0B,QAAQC,IAAI,CAAC6C,cAAejE,EAAa+D,OAAOhD,KACzCf,EAAa+D,OAAOhD,GACtB,GAA2B,aAAvBtB,EACT,OAAOO,EAAa+D,OAAUhD,QAMlC,OAAOqB,GAOD8B,EAAe,SAACnD,EAAasC,GAEjC,GADmB5C,MAAMO,QAAQX,EAAkBU,IACnC,CAAA,IAAAoD,EAEd,GAA2B,aAAvB1E,EAAmC,CAAA,IAAA2E,EAE/BC,EAAWrE,EAAa+D,OAAUhD,QAClCuD,EAAoBrD,GAA0BmD,KAAAA,EAAIrD,GAAMsD,EAAQD,IAAI3B,WAG1E,OADsB8B,mBAAmBD,GAEpC,GAA2B,QAAvB7E,EAA8B,CAAA,IAAA+E,EACjC7C,EAAa3B,EAAa+D,OAAOhD,GACjCuD,EAAoBrD,GAA0BuD,KAAAA,EAAIzD,GAAMY,EAAU6C,IAAI/B,WAE5E,OADsB8B,mBAAmBD,GAG3C,IAAM3C,EAAa3B,EAAa+D,OAAOhD,GAEvC,OADqBE,GAA0BkD,KAAAA,EAAIpD,GAAMY,EAAUwC,IAAI1B,WAIvE,OAAOY,EAAUtC,IA8Bf0D,EAA8CnE,WAAQ,WAE1D,MAA8B,aAAvBb,EA7Ba,SAACO,GAGrB,IAFA,IAEiD0E,EAF3CC,EAA+C,GAErDC,EAAA3C,EAA2BjC,EAAa6C,aAAS6B,EAAAE,KAAA1C,MAAE,CAAA,IAAA2C,EAAAH,EAAAtC,MAAvCrB,EAAG8D,KAAEzC,EAAKyC,KACpB,GAAI9D,EAAI+D,SAAS,MAAO,CACtB,IAAMC,EAAUhE,EAAIiE,QAAQ,KAAM,IAC9BL,EAAUI,GACXJ,EAAUI,GAAsBE,KAAK7C,GAEtCuC,EAAUI,GAAW,CAAC3C,QAIpBuC,EAAU5D,GACRN,MAAMO,QAAQ2D,EAAU5D,IACzB4D,EAAU5D,GAAkBkE,KAAK7C,GAElCuC,EAAU5D,GAAO,CAAC4D,EAAU5D,GAAgBqB,GAG9CuC,EAAU5D,GAAOqB,EAIvB,OAAOuC,EAKoCO,CAAalF,GAAgBW,OAAOwE,YAAYnF,EAAa6C,aACvG,CAAC7C,EAAcP,IAEZ6D,EAAY,SAAH8B,OAA2BC,cAAF,GAAED,GAArBE,QAAAA,WAAOD,GAAOA,EAcjC,OAXe1E,OAAOC,KAAK6D,GAAoBc,QAAO,SAACC,EAAKzE,GAQ1D,OAPIJ,OAAO8E,UAAUC,eAAeC,KAAKtF,EAAmBU,KAG1DyE,EAFuC,aAAvB/F,EAAoCsB,EAAIiE,QAAQ,KAAM,IAAMjE,IAEjD,IAAZuE,EACXzB,EAAoBY,EAAmB1D,GAAgBA,GACtDmD,EAAanD,EAAK0D,IAElBe,IACN,KAgFDI,EAAc,SAAHC,OAhBTC,EAgBgDC,cAAF,GAAEF,GAAjCG,oBAEfC,EAAoBhF,EAA0BV,KAE7CrB,YAJiC6G,GAAOA,IAMnBxF,MAtBtBuF,EAA4CxC,EAAU,CAAEgC,QAD1BzE,EAAWa,OAAS,IAGRf,OAAOC,KAAKkF,GAAiBP,QAC3E,SAACC,EAAKzE,GAKJ,OAJIJ,OAAO8E,UAAUC,eAAeC,KAAKzG,EAAW6B,KAElDyE,EAAIzE,GAAO+E,EAAgB/E,IAEtByE,IAET,MAeK7F,IAGPM,EAAgBgG,IAOZvC,EAAe,SAAHwC,oBAAqE,GAAEA,EAAAC,EAAAC,EAAjEzC,UAAAA,WAASwC,EAAG,GAAeA,EAAAE,EAAAD,EAAEE,WAAAA,WAAUD,EAAG,GAAgBA,EAEhF,GACoC,IAAlC1F,OAAOC,KAAK+C,GAAWjC,QACY,IAAnCf,OAAOC,KAAK0F,GAAY5E,OAF1B,CAQA,IA9DsB6E,EAgEhBC,EAzYkB,SACxBC,EACA9C,GAIA,IAAM+C,EAAanG,KAAQkG,GAG3B,OAA0B,IAAtB5F,EAAWa,SAEfb,EAAW8F,SAAQ,SAAC5F,GAGlB,IAAI6F,EAAgB,GACpB,OAAQnH,GACN,IAAK,MAGHmH,GAFY5G,EAAa6G,IAAI9F,IAAQ,IAEjBiD,MAAM,KACvB8C,KAAI,SAACC,GAAC,OAAKA,EAAEC,UACblG,OAAOmG,SACV,MAEF,IAAK,SAEH,IAAMC,EAAYlH,EAAa+D,OAAOhD,GACtC6F,EAAgBM,EAAUxF,OAAS,EAAIwF,EAAY,GAEnD/F,QAAQC,IAAI,CAAC+F,OAAQP,IACrB,MAEF,IAAK,WAED,IAAMM,EAAYlH,EAAa+D,OAAUhD,QACzC6F,EAAgBM,EAAUxF,OAAS,EAAIwF,EAAY,GACnD/F,QAAQC,IAAI,CAACgG,SAAUF,IAGvB,MAEJ,QAAS,IAAAG,EAGPT,UADSS,EAAGrH,EAAa6G,IAAI9F,IAAIsG,EAAI,IACjBrD,MAAM,KACvB8C,KAAI,SAACC,GAAC,OAAKA,EAAEC,UACblG,OAAOmG,SAMd,QAAuBK,IAAnB3D,EAAU5C,GAAoB,CAChC,IAAMwG,EAAW5D,EAAU5C,GACvByG,EAAqB,GACD,iBAAbD,GAETC,EAAWZ,EAAca,SAASF,GAC9BX,EAAc9F,QAAO,SAACiG,GAAC,OAAKA,IAAMQ,QAASG,OACvCd,GAAeW,IACvBpG,QAAQC,IAAI,CAACwF,cAAAA,IACXzF,QAAQC,IAAI,CAACmG,SAAAA,IACfpG,QAAQC,IAAI,CAACuG,gBAAiBH,KACrB/G,MAAMO,QAAQuG,IAGvBC,EAAW/G,MAAMC,KAAK,IAAIkH,OAAGF,OAAMH,KACnCpG,QAAQC,IAAI,CAACmG,SAAAA,IACbpG,QAAQC,IAAI,CAACoG,SAAAA,KAGbA,EAAWZ,EAGbF,EAAc3F,GAAOyG,MAIzBrG,QAAQC,IAAI,CAACsF,cAAAA,KArEuBA,EAgYPmB,CA9FI,SAAClE,EAAgD2C,GAElF,IAAMpF,EAASoC,IAGTwE,EAAwBnH,OAAOkC,QAAQc,GAAW7C,QAAO,SAAAiH,GAAK,OAAQtH,MAAMO,QAAQX,EAAtB0H,UAC9DC,EAASrH,OAAOsH,OAAM1H,KACvBW,EACAP,OAAOwE,YAAY2C,GACnBnI,IAEC4G,EAAyC5F,OAAOC,KAAKoH,GAAQzC,QAAO,SAACC,EAAKzE,GAE9E,OAAIJ,OAAO8E,UAAUC,eAAeC,KAAKW,EAAYvF,KAA4B,IAApBuF,EAAWvF,IAG3C,KAAhBiH,EAAOjH,IAAmBlB,EAAmB4H,SAASO,EAAOjH,MAExEyE,EAAIzE,GAAOiH,EAAOjH,IAJXyE,IAQR,IAEH,OAAAjF,KACKrB,EACAqH,GAkEoB2B,CAA2BvE,EAAW2C,GAEE3C,GAE3DwE,GAlEgB5B,EAkEcC,EA/DdhG,EAAY+E,QAAO,SAACC,EAAKzE,GAM7C,OALIJ,OAAO8E,UAAUC,eAAeC,KAAKY,EAAgBxF,KAEvDyE,EAAIzE,GAAOwF,EAAexF,IAGrByE,IACN,KA0DHvF,EAAgBgB,EAA2BkH,SAVzCvC,KAeIwC,EAAWC,eAAa,SAACC,EAAiBC,GAC9C,IAAMC,EAAeC,OAAOH,GAE5BpI,EAAiBwI,QAAQF,GAAgBD,IACxC,IAwBL,OArBEtF,aAAU,WAER,QAAA0F,IAAAC,EAA2BjI,OAAOkC,QAAQ3C,EAAiBwI,SAAQC,EAAAC,EAAAlH,OAAAiH,IAAE,CAAA,IAAAE,EAAAC,EAAhEC,EAAAH,EAAAD,GAAO5H,EAAGgI,KAAE3G,EAAK2G,KAEdC,SAAQH,EAAGpE,EAAmB1D,IAAI8H,EAAI,KAE5C,GAAIG,YADUF,EAAG1I,EAAkBsI,QAAQ3H,IAAI+H,EAAI,MAGjD,QAA4BG,EAA5BC,EAAAjH,EAAuBG,KAAK6G,EAAAC,KAAAhH,MAAE,CAAA,IAAnBiH,EAAQF,EAAA7G,MACjBjB,QAAQC,IAAIgB,GAEZ+G,IAKJ/I,EAAkBsI,QAAQ3H,GAAOiI,KAIlC,CAACvE,IACC,CACLzE,aAAAA,EACA0D,aAAAA,EACAkC,YAAAA,EACAtC,UAAAA,EACA8F,SAlJe,SAAoBrI,EAAWsI,GAE9C,IAAMC,EAASb,OAAO1H,GAGtB,OADmC,WAArBsI,SAAAA,EAAS/D,SAAmBzB,EAAoB7D,EAAa6G,IAAIyC,GAASA,GAAUpF,EAAaoF,EAAS7E,IA+IxH2D,SAAAA"}
1	+ {"version":3,"file":"react-magic-search-params.cjs.production.min.js","sources":["../src/useMagicSearchParams.ts"],"sourcesContent":["import { useSearchParams } from 'react-router-dom'\r\nimport { useMemo, useEffect, useRef, useCallback } from 'react'\r\n\r\n\r\n// Custom hook with advanced techniques to handle search parameters for any pagination\r\n\r\ntype CommonParams = {\r\n page?: number\r\n page_size?: number\r\n}\r\n/\r\nMaps all properties of M (mandatory) as required\r\nand all properties of O (optional) as optional. \r\n/\r\ntype MergeParams<M, O> = {\r\n [K in keyof M]: M[K]\r\n} & {\r\n [K in keyof O]?: O[K]\r\n}\r\n/*\r\n Interface for the configuration object that the hook receives \r\n /\r\nexport interface UseMagicSearchParamsOptions<\r\n M extends Record<string, unknown>,\r\n O extends Record<string, unknown>\r\n> {\r\n mandatory: M \r\n optional?: O\r\n defaultParams?: Partial<MergeParams<M, O>>\r\n forceParams?: Partial<MergeParams<M, O>> // transform all to partial to avoid errors\r\n arraySerialization?: 'csv' \| 'repeat' \| 'brackets' // technical to serialize arrays in the URL\r\n omitParamsByValues?: Array<'all' \| 'default' \| 'unknown' \| 'none' \| 'void '> \r\n}\r\n\r\n/* \r\nGeneric hook to handle search parameters in the URL\r\n@param mandatory - Mandatory parameters (e.g., page=1, page_size=10, etc.)\r\n@param optional - Optional parameters (e.g., order, search, etc.)\r\n@param defaultParams - Default parameters sent in the URL on initialization\r\n@param forceParams - Parameters forced into the URL regardless of user input\r\n@param omitParamsByValues - Parameters omitted if they have specific values \r\n/\r\nexport const useMagicSearchParams = <\r\n M extends Record<string, unknown> & CommonParams,\r\n O extends Record<string, unknown>,\r\n>({\r\n mandatory = {} as M,\r\n optional = {} as O,\r\n defaultParams = {} as Partial<MergeParams<M, O>>,\r\n arraySerialization = 'csv',\r\n forceParams = {} as {} as Partial<MergeParams<M, O>>,\r\n omitParamsByValues = [] as Array<'all' \| 'default' \| 'unknown' \| 'none' \| 'void '>\r\n}: UseMagicSearchParamsOptions<M, O>)=> {\r\n\r\n\r\n const [searchParams, setSearchParams] = useSearchParams() \r\n // Ref to store subscriptions: { paramName: [callback1, callback2, ...] }\r\n const subscriptionsRef = useRef<Record<string, Array<() => unknown>>>({}); \r\n const previousParamsRef = useRef<Record<string, unknown>>({})\r\n\r\n const TOTAL_PARAMS_PAGE: MergeParams<M, O> = useMemo(() => {\r\n return { ...mandatory, ...optional };\r\n }, [mandatory, optional]);\r\n\r\n const PARAM_ORDER = useMemo(() => {\r\n return Array.from(Object.keys(TOTAL_PARAMS_PAGE))\r\n }, [TOTAL_PARAMS_PAGE])\r\n\r\n // we get the keys that are arrays according to TOTAL_PARAMS_PAGE since these require special treatment in the URL due to serialization mode\r\n const ARRAY_KEYS = useMemo(() => {\r\n return Object.keys(TOTAL_PARAMS_PAGE).filter(\r\n (key) => Array.isArray(TOTAL_PARAMS_PAGE[key])\r\n );\r\n }, [TOTAL_PARAMS_PAGE])\r\n\r\n const appendArrayValues = (\r\n finallyParams: Record<string, unknown>,\r\n newParams: Record<string, string \| string[] \| unknown>\r\n ): Record<string, unknown> => {\r\n \r\n // Note: We cannot modify the object of the final parameters directly, as immutability must be maintained\r\n const updatedParams = { ...finallyParams };\r\n \r\n\r\n if (ARRAY_KEYS.length === 0) return updatedParams;\r\n \r\n ARRAY_KEYS.forEach((key) => {\r\n // We use the current values directly from searchParams (source of truth)\r\n // This avoids depending on finallyParams in which the arrays have been omitted\r\n let currentValues = []; \r\n switch (arraySerialization) {\r\n case 'csv': {\r\n const raw = searchParams.get(key) \|\| '';\r\n // For csv we expect \"value1,value2,...\" (no prefix)\r\n currentValues = raw.split(',')\r\n .map((v) => v.trim())\r\n .filter(Boolean) as Array<string>\r\n break;\r\n }\r\n case 'repeat': {\r\n // Here we get all ocurrences of key\r\n const urlParams = searchParams.getAll(key) as Array<string>\r\n currentValues = urlParams.length > 0 ? urlParams : []\r\n \r\n console.log({REPEAT: currentValues})\r\n break;\r\n }\r\n case 'brackets': {\r\n // Build URLSearchParams from current parameters (to ensure no serialized values are taken previously)\r\n const urlParams = searchParams.getAll(`${key}[]`) as Array<string>\r\n currentValues = urlParams.length > 0 ? urlParams : []\r\n console.log({BRACKETS: urlParams})\r\n \r\n \r\n break;\r\n }\r\n default: {\r\n // Mode by default works as csv\r\n const raw = searchParams.get(key) ?? '';\r\n currentValues = raw.split(',')\r\n .map((v) => v.trim())\r\n .filter(Boolean);\r\n }\r\n break; \r\n }\r\n // Update array values with new ones\r\n \r\n if (newParams[key] !== undefined) {\r\n const incoming = newParams[key];\r\n let combined: string[] = []\r\n if (typeof incoming === 'string') {\r\n // If it is a string, it is toggled (add/remove)\r\n combined = currentValues.includes(incoming)\r\n ? currentValues.filter((v) => v !== incoming)\r\n : [...currentValues, incoming];\r\n console.log({currentValues})\r\n console.log({incoming})\r\n console.log({CONBINED_STRING: combined})\r\n } else if (Array.isArray(incoming)) {\r\n // if an array is passed, repeated values are merged into a single value\r\n // Note: Set is used to remove duplicates\r\n combined = Array.from(new Set([ ...incoming]));\r\n console.log({incoming})\r\n console.log({combined})\r\n } else {\r\n \r\n combined = currentValues;\r\n }\r\n\r\n updatedParams[key] = combined\r\n\r\n }\r\n });\r\n console.log({updatedParams})\r\n return updatedParams\r\n };\r\n\r\n const transformParamsToURLSearch = (params: Record<string, unknown>): URLSearchParams => {\r\n console.log({PARAMS_RECIBIDOS_TRANSFORM: params})\r\n\r\n const newParam: URLSearchParams = new URLSearchParams()\r\n\r\n const paramsKeys = Object.keys(params)\r\n\r\n for (const key of paramsKeys) {\r\n if (Array.isArray(TOTAL_PARAMS_PAGE[key])) {\r\n const arrayValue = params[key] as unknown[]\r\n console.log({arrayValue})\r\n switch (arraySerialization) {\r\n case 'csv': {\r\n const csvValue = arrayValue.join(',')\r\n // set ensure that the previous value is replaced\r\n newParam.set(key, csvValue)\r\n break\r\n } case 'repeat': {\r\n \r\n for (const item of arrayValue) {\r\n console.log({item})\r\n // add new value to the key, instead of replacing it\r\n newParam.append(key, item as string)\r\n \r\n }\r\n break\r\n } case 'brackets': {\r\n for (const item of arrayValue) {\r\n newParam.append(`${key}[]`, item as string)\r\n }\r\n break\r\n } default: {\r\n const csvValue = arrayValue.join(',')\r\n newParam.set(key, csvValue)\r\n }\r\n }\r\n } else {\r\n newParam.set(key, params[key] as string)\r\n }\r\n }\r\n console.log({FINAL: newParam.toString()})\r\n return newParam\r\n }\r\n // @ts-ignore\r\n const hasForcedParamsValues = ({ paramsForced, compareParams }) => {\r\n\r\n // Iterates over the forced parameters and verifies that they exist in the URL and match their values\r\n // Ej: { page: 1, page_size: 10 } === { page: 1, page_size: 10 } => true\r\n const allParamsMatch = Object.entries(paramsForced).every(\r\n ([key, value]) => compareParams[key] === value\r\n );\r\n\r\n return allParamsMatch;\r\n };\r\n \r\n useEffect(() => {\r\n\r\n const keysDefaultParams: string[] = Object.keys(defaultParams)\r\n const keysForceParams: string[] = Object.keys(forceParams)\r\n if(keysDefaultParams.length === 0 && keysForceParams.length === 0) return\r\n \r\n\r\n function handleStartingParams() {\r\n\r\n const defaultParamsString = transformParamsToURLSearch(defaultParams).toString()\r\n const paramsUrl = getParams()\r\n const paramsUrlString = transformParamsToURLSearch(paramsUrl).toString()\r\n const forceParamsString = transformParamsToURLSearch(forceParams).toString()\r\n\r\n console.log({defaultParamsString})\r\n\r\n const isForcedParams: boolean = hasForcedParamsValues({ paramsForced: forceParams, compareParams: paramsUrl })\r\n\r\n if (!isForcedParams) {\r\n\r\n // In this case, the forced parameters take precedence over the default parameters and the parameters of the current URL (which could have been modified by the user, e.g., page_size=1000)\r\n\r\n updateParams({ newParams: {\r\n ...defaultParams,\r\n ...forceParams\r\n }})\r\n return\r\n }\r\n // In this way it will be validated that the forced parameters keys and values are in the current URL\r\n const isIncludesForcedParams = hasForcedParamsValues({ paramsForced: forceParamsString, compareParams: defaultParams })\r\n\r\n if (keysDefaultParams.length > 0 && isIncludesForcedParams) {\r\n if (defaultParamsString === paramsUrlString) return // this means that the URL already has the default parameters\r\n updateParams({ newParams: defaultParams })\r\n }\r\n\r\n }\r\n handleStartingParams()\r\n\r\n // eslint-disable-next-line react-hooks/exhaustive-deps\r\n }, [])\r\n\r\n /\r\n Convert a string value to its original type (number, boolean, array) according to TOTAL_PARAMS_PAGE\r\n * @param value - Chain obtained from the URL\r\n * @param key - Key of the parameter\r\n /\r\n const convertOriginalType = (value: string, key: string) => {\r\n // Given that the parameters of a URL are recieved as strings, they are converted to their original type\r\n if (typeof TOTAL_PARAMS_PAGE[key] === 'number') {\r\n return parseInt(value)\r\n } else if (typeof TOTAL_PARAMS_PAGE[key] === 'boolean') {\r\n return value === 'true'\r\n } else if (Array.isArray(TOTAL_PARAMS_PAGE[key])) {\r\n // The result will be a valid array represented in the URL ej: tags=tag1,tag2,tag3 to ['tag1', 'tag2', 'tag3'], useful to combine the values of the arrays with the new ones\r\n \r\n if (arraySerialization === 'csv') {\r\n return searchParams.getAll(key).join('').split(',')\r\n } else if (arraySerialization === 'repeat') {\r\n \r\n console.log({SEARCH_PARAMS: searchParams.getAll(key)})\r\n return searchParams.getAll(key)\r\n } else if (arraySerialization === 'brackets') {\r\n return searchParams.getAll(`${key}[]`)\r\n }\r\n \r\n \r\n }\r\n // Note: dates are not converted as it is better to handle them directly in the component that receives them, using a library like < date-fns >\r\n return value\r\n }\r\n \r\n /\r\n Gets the current parameters from the URL and converts them to their original type if desired\r\n * @param convert - If true, converts from string to the inferred type (number, boolean, ...)\r\n */\r\n const getStringUrl = (key: string, paramsUrl: Record<string, unknown>) => {\r\n const isKeyArray = Array.isArray(TOTAL_PARAMS_PAGE[key])\r\n if (isKeyArray) {\r\n\r\n if (arraySerialization === 'brackets') {\r\n\r\n const arrayUrl = searchParams.getAll(`${key}[]`)\r\n const encodedQueryArray = transformParamsToURLSearch({ [key]: arrayUrl }).toString()\r\n // in this way the array of the URL is decoded to its original form ej: tags[]=tag1&tags[]=tag2&tags[]=tag3\r\n const unencodeQuery = decodeURIComponent(encodedQueryArray)\r\n return unencodeQuery\r\n } else if (arraySerialization === 'csv') {\r\n const arrayValue = searchParams.getAll(key)\r\n const encodedQueryArray = transformParamsToURLSearch({ [key]: arrayValue }).toString()\r\n const unencodeQuery = decodeURIComponent(encodedQueryArray)\r\n return unencodeQuery\r\n }\r\n const arrayValue = searchParams.getAll(key)\r\n const stringResult = transformParamsToURLSearch({ [key]: arrayValue }).toString()\r\n return stringResult\r\n } else {\r\n \r\n return paramsUrl[key] as string\r\n }\r\n }\r\n const getParamsObj = (searchParams: URLSearchParams): Record<string, string \| string[]> => {\r\n const paramsObj: Record<string, string \| string[]> = {};\r\n // @ts-ignore\r\n for (const [key, value] of searchParams.entries()) {\r\n if (key.endsWith('[]')) {\r\n const bareKey = key.replace('[]', '');\r\n if (paramsObj[bareKey]) {\r\n (paramsObj[bareKey] as string[]).push(value);\r\n } else {\r\n paramsObj[bareKey] = [value];\r\n }\r\n } else {\r\n // If the key already exists, it is a repeated parameter\r\n if (paramsObj[key]) {\r\n if (Array.isArray(paramsObj[key])) {\r\n (paramsObj[key] as string[]).push(value);\r\n } else {\r\n paramsObj[key] = [paramsObj[key] as string, value];\r\n }\r\n } else {\r\n paramsObj[key] = value;\r\n }\r\n }\r\n }\r\n return paramsObj;\r\n }\r\n // Optimization: While the parameters are not updated, the current parameters of the URL are not recalculated\r\n const CURRENT_PARAMS_URL: Record<string, unknown> = useMemo(() => {\r\n\r\n return arraySerialization === 'brackets' ? getParamsObj(searchParams) : Object.fromEntries(searchParams.entries())\r\n }, [searchParams, arraySerialization])\r\n\r\n const getParams = ({ convert = true } = {}): MergeParams<M, O> => {\r\n // All the paramteres are extracted from the URL and converted into an object\r\n\r\n const params = Object.keys(CURRENT_PARAMS_URL).reduce((acc, key) => {\r\n if (Object.prototype.hasOwnProperty.call(TOTAL_PARAMS_PAGE, key)) {\r\n const realKey = arraySerialization === 'brackets' ? key.replace('[]', '') : key\r\n // @ts-ignore\r\n acc[realKey] = convert === true\r\n ? convertOriginalType(CURRENT_PARAMS_URL[key] as string, key)\r\n : getStringUrl(key, CURRENT_PARAMS_URL)\r\n }\r\n return acc\r\n }, {})\r\n \r\n return params as MergeParams<M, O>\r\n }\r\n type keys = keyof MergeParams<M, O>\r\n // Note: in this way the return of the getParam function is typed dynamically, thus having autocomplete in the IDE (eg: value.split(','))\r\n type TagReturn<T extends boolean> = T extends true ? string[] : string;\r\n const getParam = <T extends boolean>(key: keys, options?: { convert: T }): TagReturn<T> => {\r\n\r\n const keyStr = String(key)\r\n // @ts-ignore\r\n const value = options?.convert === true ? convertOriginalType(searchParams.get(keyStr), keyStr) : getStringUrl(keyStr, CURRENT_PARAMS_URL)\r\n return value as TagReturn<T> \r\n }\r\n \r\n type OptionalParamsFiltered = Partial<O>\r\n\r\n const calculateOmittedParameters = (newParams: Record<string, unknown \| unknown[]>, keepParams: Record<string, boolean>) => {\r\n // Calculate the ommited parameters, that is, the parameters that have not been sent in the request\r\n const params = getParams()\r\n // hasOw\r\n // Note: it will be necessary to omit the parameters that are arrays because the idea is not to replace them but to add or remove some values\r\n const newParamsWithoutArray = Object.entries(newParams).filter(([key,]) => !Array.isArray(TOTAL_PARAMS_PAGE[key]))\r\n const result = Object.assign({\r\n ...params,\r\n ...Object.fromEntries(newParamsWithoutArray),\r\n ...forceParams // the forced parameters will always be sent and will maintain their value\r\n })\r\n const paramsFiltered: OptionalParamsFiltered = Object.keys(result).reduce((acc, key) => {\r\n // for default no parameters are omitted unless specified in the keepParams object\r\n if (Object.prototype.hasOwnProperty.call(keepParams, key) && keepParams[key] === false) {\r\n return acc\r\n // Note: They array of parameters omitted by values (e.g., ['all', 'default']) are omitted since they are usually a default value that is not desired to be sent\r\n } else if (!!result[key] !== false && !omitParamsByValues.includes(result[key])) {\r\n // @ts-ignore\r\n acc[key] = result[key]\r\n }\r\n\r\n return acc\r\n }, {})\r\n\r\n return {\r\n ...mandatory,\r\n ...paramsFiltered\r\n } \r\n }\r\n // @ts-ignore\r\n const sortParameters = (paramsFiltered) => {\r\n // sort the parameters according to the structure so that it persists with each change in the URL, eg: localhost:3000/?page=1&page_size=10\r\n // Note: this visibly improves the user experience\r\n const orderedParams = PARAM_ORDER.reduce((acc, key) => {\r\n if (Object.prototype.hasOwnProperty.call(paramsFiltered, key)) {\r\n // @ts-ignore\r\n acc[key] = paramsFiltered[key]\r\n }\r\n\r\n return acc\r\n }, {})\r\n return orderedParams\r\n }\r\n\r\n const mandatoryParameters = () => {\r\n // Note: in case there are arrays in the URL, they are converted to their original form ej: tags=['tag1', 'tag2'] otherwise the parameters are extracted without converting to optimize performance\r\n const isNecessaryConvert: boolean = ARRAY_KEYS.length > 0 ? true : false\r\n const totalParametros: Record<string, unknown> = getParams({ convert: isNecessaryConvert })\r\n\r\n const paramsUrlFound: Record<string, boolean> = Object.keys(totalParametros).reduce(\r\n (acc, key) => {\r\n if (Object.prototype.hasOwnProperty.call(mandatory, key)) {\r\n // @ts-ignore\r\n acc[key] = totalParametros[key]\r\n }\r\n return acc\r\n },\r\n {}\r\n )\r\n\r\n return paramsUrlFound\r\n }\r\n\r\n const clearParams = ({ keepMandatoryParams = true } = {}): void => {\r\n // for default, the mandatory parameters are not cleared since the current pagination would be lost\r\n const paramsTransformed = transformParamsToURLSearch(\r\n {\r\n ...mandatory,\r\n \r\n ...(keepMandatoryParams && {\r\n ...mandatoryParameters()\r\n }),\r\n ...forceParams \r\n }\r\n )\r\n setSearchParams(paramsTransformed) \r\n }\r\n\r\n // transforms the keys to boolean to know which parameters to keep\r\n type KeepParamsTransformedValuesBoolean = Partial<Record<keyof typeof TOTAL_PARAMS_PAGE, boolean>>\r\n type NewParams = Partial<typeof TOTAL_PARAMS_PAGE> \r\n type KeepParams = KeepParamsTransformedValuesBoolean\r\n const updateParams = ({ newParams = {} as NewParams, keepParams = {} as KeepParams } = {}) => {\r\n\r\n if (\r\n Object.keys(newParams).length === 0 &&\r\n Object.keys(keepParams).length === 0\r\n ) {\r\n clearParams()\r\n return\r\n }\r\n // @ts-ignore\r\n const finallyParamters = calculateOmittedParameters(newParams, keepParams)\r\n\r\n const convertedArrayValues = appendArrayValues(finallyParamters, newParams)\r\n\r\n const paramsSorted = sortParameters(convertedArrayValues)\r\n\r\n setSearchParams(transformParamsToURLSearch(paramsSorted))\r\n\r\n }\r\n\r\n // only for the keys of the parameters to subscribe to changes in the URL to trigger the callback\r\n const onChange = useCallback( (paramName: keys, callbacks: Array<() => void>) => {\r\n const paramNameStr = String(paramName)\r\n // replace the previous callbacks with the new ones so as not to accumulate callbacks\r\n subscriptionsRef.current[paramNameStr] = callbacks;\r\n }, [])\r\n \r\n // each time searchParams changes, we notify the subscribers\r\n useEffect(() => {\r\n\r\n for (const [key, value] of Object.entries(subscriptionsRef.current)) {\r\n\r\n const newValue = CURRENT_PARAMS_URL[key] ?? null \r\n const oldValue = previousParamsRef.current[key] ?? null\r\n if (newValue !== oldValue) {\r\n \r\n for (const callback of value) {\r\n console.log(value)\r\n\r\n callback()\r\n\r\n }\r\n }\r\n // once the callback is executed, the previous value is updated to ensure that the next time the value changes, the callback is executed\r\n previousParamsRef.current[key] = newValue\r\n }\r\n\r\n \r\n }, [CURRENT_PARAMS_URL])\r\n return {\r\n searchParams,\r\n updateParams,\r\n clearParams,\r\n getParams,\r\n getParam,\r\n onChange\r\n }\r\n}\r\n"],"names":["_ref","mandatory","_ref$mandatory","_ref$optional","optional","_ref$defaultParams","defaultParams","_ref$arraySerializati","arraySerialization","_ref$forceParams","forceParams","_ref$omitParamsByValu","omitParamsByValues","_useSearchParams","useSearchParams","searchParams","setSearchParams","subscriptionsRef","useRef","previousParamsRef","TOTAL_PARAMS_PAGE","useMemo","_extends","PARAM_ORDER","Array","from","Object","keys","ARRAY_KEYS","filter","key","isArray","transformParamsToURLSearch","params","console","log","PARAMS_RECIBIDOS_TRANSFORM","newParam","URLSearchParams","_i","_paramsKeys","length","arrayValue","csvValue","join","set","_step","_iterator","_createForOfIteratorHelperLoose","done","item","value","append","_step2","_iterator2","FINAL","toString","hasForcedParamsValues","_ref2","compareParams","entries","paramsForced","every","_ref3","useEffect","keysDefaultParams","keysForceParams","defaultParamsString","paramsUrl","getParams","paramsUrlString","forceParamsString","isIncludesForcedParams","updateParams","newParams","handleStartingParams","convertOriginalType","parseInt","getAll","split","SEARCH_PARAMS","getStringUrl","_transformParamsToURL3","_transformParamsToURL","arrayUrl","encodedQueryArray","decodeURIComponent","_transformParamsToURL2","CURRENT_PARAMS_URL","_step3","paramsObj","_iterator3","_step3$value","endsWith","bareKey","replace","push","getParamsObj","fromEntries","_temp","_ref4$convert","convert","reduce","acc","prototype","hasOwnProperty","call","clearParams","_temp2","totalParametros","_ref6$keepMandatoryPa","keepMandatoryParams","paramsTransformed","_temp3","_ref7$newParams","_ref7","_ref7$keepParams","keepParams","paramsFiltered","convertedArrayValues","finallyParams","updatedParams","forEach","currentValues","get","map","v","trim","Boolean","urlParams","REPEAT","BRACKETS","_searchParams$get","undefined","incoming","combined","includes","concat","CONBINED_STRING","Set","appendArrayValues","newParamsWithoutArray","_ref5","result","assign","calculateOmittedParameters","paramsSorted","onChange","useCallback","paramName","callbacks","paramNameStr","String","current","_i2","_Object$entries","_CURRENT_PARAMS_URL$k","_previousParamsRef$cu","_Object$entries$_i","newValue","_step4","_iterator4","callback","getParam","options","keyStr"],"mappings":"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"}

package/dist/react-magic-search-params.esm.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"react-magic-search-params.esm.js","sources":["../src/useMagicSearchParams.ts"],"sourcesContent":["import { useSearchParams } from 'react-router-dom'\r\nimport { useMemo, useEffect, useRef, useCallback } from 'react'\r\n\r\n\r\n// Custom hook with advanced techniques to handle search parameters for any pagination\r\n\r\ntype CommonParams = {\r\n page?: number\r\n page_size?: number\r\n}\r\n/\r\nMaps all properties of M (mandatory) as required\r\nand all properties of O (optional) as optional. \r\n/\r\ntype MergeParams<M, O> = {\r\n [K in keyof M]: M[K]\r\n} & {\r\n [K in keyof O]?: O[K]\r\n}\r\n/*\r\n Interface for the configuration object that the hook receives \r\n /\r\ninterface UseMagicSearchParamsOptions<\r\n M extends Record<string, unknown>,\r\n O extends Record<string, unknown>\r\n> {\r\n mandatory: M \r\n optional?: O\r\n defaultParams?: Partial<MergeParams<M, O>>\r\n forceParams?: Partial<MergeParams<M, O>> // transform all to partial to avoid errors\r\n arraySerialization?: 'csv' \| 'repeat' \| 'brackets' // technical to serialize arrays in the URL\r\n omitParamsByValues?: Array<'all' \| 'default' \| 'unknown' \| 'none' \| 'void '> \r\n}\r\n\r\n/* \r\nGeneric hook to handle search parameters in the URL\r\n@param mandatory - Mandatory parameters (e.g., page=1, page_size=10, etc.)\r\n@param optional - Optional parameters (e.g., order, search, etc.)\r\n@param defaultParams - Default parameters sent in the URL on initialization\r\n@param forceParams - Parameters forced into the URL regardless of user input\r\n@param omitParamsByValues - Parameters omitted if they have specific values \r\n/\r\nexport const useMagicSearchParams = <\r\n M extends Record<string, unknown> & CommonParams,\r\n O extends Record<string, unknown>,\r\n>({\r\n mandatory = {} as M,\r\n optional = {} as O,\r\n defaultParams = {} as Partial<MergeParams<M, O>>,\r\n arraySerialization = 'csv',\r\n forceParams = {} as {} as Partial<MergeParams<M, O>>,\r\n omitParamsByValues = [] as Array<'all' \| 'default' \| 'unknown' \| 'none' \| 'void '>\r\n}: UseMagicSearchParamsOptions<M, O>)=> {\r\n\r\n\r\n const [searchParams, setSearchParams] = useSearchParams() \r\n // Ref to store subscriptions: { paramName: [callback1, callback2, ...] }\r\n const subscriptionsRef = useRef<Record<string, Array<() => unknown>>>({}); \r\n const previousParamsRef = useRef<Record<string, unknown>>({})\r\n\r\n const TOTAL_PARAMS_PAGE: MergeParams<M, O> = useMemo(() => {\r\n return { ...mandatory, ...optional };\r\n }, [mandatory, optional]);\r\n\r\n const PARAM_ORDER = useMemo(() => {\r\n return Array.from(Object.keys(TOTAL_PARAMS_PAGE))\r\n }, [TOTAL_PARAMS_PAGE])\r\n\r\n // we get the keys that are arrays according to TOTAL_PARAMS_PAGE since these require special treatment in the URL due to serialization mode\r\n const ARRAY_KEYS = useMemo(() => {\r\n return Object.keys(TOTAL_PARAMS_PAGE).filter(\r\n (key) => Array.isArray(TOTAL_PARAMS_PAGE[key])\r\n );\r\n }, [TOTAL_PARAMS_PAGE])\r\n\r\n const appendArrayValues = (\r\n finallyParams: Record<string, unknown>,\r\n newParams: Record<string, string \| string[] \| unknown>\r\n ): Record<string, unknown> => {\r\n \r\n // Note: We cannot modify the object of the final parameters directly, as immutability must be maintained\r\n const updatedParams = { ...finallyParams };\r\n \r\n\r\n if (ARRAY_KEYS.length === 0) return updatedParams;\r\n \r\n ARRAY_KEYS.forEach((key) => {\r\n // We use the current values directly from searchParams (source of truth)\r\n // This avoids depending on finallyParams in which the arrays have been omitted\r\n let currentValues = []; \r\n switch (arraySerialization) {\r\n case 'csv': {\r\n const raw = searchParams.get(key) \|\| '';\r\n // For csv we expect \"value1,value2,...\" (no prefix)\r\n currentValues = raw.split(',')\r\n .map((v) => v.trim())\r\n .filter(Boolean) as Array<string>\r\n break;\r\n }\r\n case 'repeat': {\r\n // Here we get all ocurrences of key\r\n const urlParams = searchParams.getAll(key) as Array<string>\r\n currentValues = urlParams.length > 0 ? urlParams : []\r\n \r\n console.log({REPEAT: currentValues})\r\n break;\r\n }\r\n case 'brackets': {\r\n // Build URLSearchParams from current parameters (to ensure no serialized values are taken previously)\r\n const urlParams = searchParams.getAll(`${key}[]`) as Array<string>\r\n currentValues = urlParams.length > 0 ? urlParams : []\r\n console.log({BRACKETS: urlParams})\r\n \r\n \r\n break;\r\n }\r\n default: {\r\n // Mode by default works as csv\r\n const raw = searchParams.get(key) ?? '';\r\n currentValues = raw.split(',')\r\n .map((v) => v.trim())\r\n .filter(Boolean);\r\n }\r\n break; \r\n }\r\n // Update array values with new ones\r\n \r\n if (newParams[key] !== undefined) {\r\n const incoming = newParams[key];\r\n let combined: string[] = []\r\n if (typeof incoming === 'string') {\r\n // If it is a string, it is toggled (add/remove)\r\n combined = currentValues.includes(incoming)\r\n ? currentValues.filter((v) => v !== incoming)\r\n : [...currentValues, incoming];\r\n console.log({currentValues})\r\n console.log({incoming})\r\n console.log({CONBINED_STRING: combined})\r\n } else if (Array.isArray(incoming)) {\r\n // if an array is passed, repeated values are merged into a single value\r\n // Note: Set is used to remove duplicates\r\n combined = Array.from(new Set([ ...incoming]));\r\n console.log({incoming})\r\n console.log({combined})\r\n } else {\r\n \r\n combined = currentValues;\r\n }\r\n\r\n updatedParams[key] = combined\r\n\r\n }\r\n });\r\n console.log({updatedParams})\r\n return updatedParams\r\n };\r\n\r\n const transformParamsToURLSearch = (params: Record<string, unknown>): URLSearchParams => {\r\n console.log({PARAMS_RECIBIDOS_TRANSFORM: params})\r\n\r\n const newParam: URLSearchParams = new URLSearchParams()\r\n\r\n const paramsKeys = Object.keys(params)\r\n\r\n for (const key of paramsKeys) {\r\n if (Array.isArray(TOTAL_PARAMS_PAGE[key])) {\r\n const arrayValue = params[key] as unknown[]\r\n console.log({arrayValue})\r\n switch (arraySerialization) {\r\n case 'csv': {\r\n const csvValue = arrayValue.join(',')\r\n // set ensure that the previous value is replaced\r\n newParam.set(key, csvValue)\r\n break\r\n } case 'repeat': {\r\n \r\n for (const item of arrayValue) {\r\n console.log({item})\r\n // add new value to the key, instead of replacing it\r\n newParam.append(key, item as string)\r\n \r\n }\r\n break\r\n } case 'brackets': {\r\n for (const item of arrayValue) {\r\n newParam.append(`${key}[]`, item as string)\r\n }\r\n break\r\n } default: {\r\n const csvValue = arrayValue.join(',')\r\n newParam.set(key, csvValue)\r\n }\r\n }\r\n } else {\r\n newParam.set(key, params[key] as string)\r\n }\r\n }\r\n console.log({FINAL: newParam.toString()})\r\n return newParam\r\n }\r\n // @ts-ignore\r\n const hasForcedParamsValues = ({ paramsForced, compareParams }) => {\r\n\r\n // Iterates over the forced parameters and verifies that they exist in the URL and match their values\r\n // Ej: { page: 1, page_size: 10 } === { page: 1, page_size: 10 } => true\r\n const allParamsMatch = Object.entries(paramsForced).every(\r\n ([key, value]) => compareParams[key] === value\r\n );\r\n\r\n return allParamsMatch;\r\n };\r\n \r\n useEffect(() => {\r\n\r\n const keysDefaultParams: string[] = Object.keys(defaultParams)\r\n const keysForceParams: string[] = Object.keys(forceParams)\r\n if(keysDefaultParams.length === 0 && keysForceParams.length === 0) return\r\n \r\n\r\n function handleStartingParams() {\r\n\r\n const defaultParamsString = transformParamsToURLSearch(defaultParams).toString()\r\n const paramsUrl = getParams()\r\n const paramsUrlString = transformParamsToURLSearch(paramsUrl).toString()\r\n const forceParamsString = transformParamsToURLSearch(forceParams).toString()\r\n\r\n console.log({defaultParamsString})\r\n\r\n const isForcedParams: boolean = hasForcedParamsValues({ paramsForced: forceParams, compareParams: paramsUrl })\r\n\r\n if (!isForcedParams) {\r\n\r\n // In this case, the forced parameters take precedence over the default parameters and the parameters of the current URL (which could have been modified by the user, e.g., page_size=1000)\r\n\r\n updateParams({ newParams: {\r\n ...defaultParams,\r\n ...forceParams\r\n }})\r\n return\r\n }\r\n // In this way it will be validated that the forced parameters keys and values are in the current URL\r\n const isIncludesForcedParams = hasForcedParamsValues({ paramsForced: forceParamsString, compareParams: defaultParams })\r\n\r\n if (keysDefaultParams.length > 0 && isIncludesForcedParams) {\r\n if (defaultParamsString === paramsUrlString) return // this means that the URL already has the default parameters\r\n updateParams({ newParams: defaultParams })\r\n }\r\n\r\n }\r\n handleStartingParams()\r\n\r\n // eslint-disable-next-line react-hooks/exhaustive-deps\r\n }, [])\r\n\r\n /\r\n Convert a string value to its original type (number, boolean, array) according to TOTAL_PARAMS_PAGE\r\n * @param value - Chain obtained from the URL\r\n * @param key - Key of the parameter\r\n /\r\n const convertOriginalType = (value: string, key: string) => {\r\n // Given that the parameters of a URL are recieved as strings, they are converted to their original type\r\n if (typeof TOTAL_PARAMS_PAGE[key] === 'number') {\r\n return parseInt(value)\r\n } else if (typeof TOTAL_PARAMS_PAGE[key] === 'boolean') {\r\n return value === 'true'\r\n } else if (Array.isArray(TOTAL_PARAMS_PAGE[key])) {\r\n // The result will be a valid array represented in the URL ej: tags=tag1,tag2,tag3 to ['tag1', 'tag2', 'tag3'], useful to combine the values of the arrays with the new ones\r\n \r\n if (arraySerialization === 'csv') {\r\n return searchParams.getAll(key).join('').split(',')\r\n } else if (arraySerialization === 'repeat') {\r\n \r\n console.log({SEARCH_PARAMS: searchParams.getAll(key)})\r\n return searchParams.getAll(key)\r\n } else if (arraySerialization === 'brackets') {\r\n return searchParams.getAll(`${key}[]`)\r\n }\r\n \r\n \r\n }\r\n // Note: dates are not converted as it is better to handle them directly in the component that receives them, using a library like < date-fns >\r\n return value\r\n }\r\n \r\n /\r\n Gets the current parameters from the URL and converts them to their original type if desired\r\n * @param convert - If true, converts from string to the inferred type (number, boolean, ...)\r\n */\r\n const getStringUrl = (key: string, paramsUrl: Record<string, unknown>) => {\r\n const isKeyArray = Array.isArray(TOTAL_PARAMS_PAGE[key])\r\n if (isKeyArray) {\r\n\r\n if (arraySerialization === 'brackets') {\r\n\r\n const arrayUrl = searchParams.getAll(`${key}[]`)\r\n const encodedQueryArray = transformParamsToURLSearch({ [key]: arrayUrl }).toString()\r\n // in this way the array of the URL is decoded to its original form ej: tags[]=tag1&tags[]=tag2&tags[]=tag3\r\n const unencodeQuery = decodeURIComponent(encodedQueryArray)\r\n return unencodeQuery\r\n } else if (arraySerialization === 'csv') {\r\n const arrayValue = searchParams.getAll(key)\r\n const encodedQueryArray = transformParamsToURLSearch({ [key]: arrayValue }).toString()\r\n const unencodeQuery = decodeURIComponent(encodedQueryArray)\r\n return unencodeQuery\r\n }\r\n const arrayValue = searchParams.getAll(key)\r\n const stringResult = transformParamsToURLSearch({ [key]: arrayValue }).toString()\r\n return stringResult\r\n } else {\r\n \r\n return paramsUrl[key] as string\r\n }\r\n }\r\n const getParamsObj = (searchParams: URLSearchParams): Record<string, string \| string[]> => {\r\n const paramsObj: Record<string, string \| string[]> = {};\r\n // @ts-ignore\r\n for (const [key, value] of searchParams.entries()) {\r\n if (key.endsWith('[]')) {\r\n const bareKey = key.replace('[]', '');\r\n if (paramsObj[bareKey]) {\r\n (paramsObj[bareKey] as string[]).push(value);\r\n } else {\r\n paramsObj[bareKey] = [value];\r\n }\r\n } else {\r\n // If the key already exists, it is a repeated parameter\r\n if (paramsObj[key]) {\r\n if (Array.isArray(paramsObj[key])) {\r\n (paramsObj[key] as string[]).push(value);\r\n } else {\r\n paramsObj[key] = [paramsObj[key] as string, value];\r\n }\r\n } else {\r\n paramsObj[key] = value;\r\n }\r\n }\r\n }\r\n return paramsObj;\r\n }\r\n // Optimization: While the parameters are not updated, the current parameters of the URL are not recalculated\r\n const CURRENT_PARAMS_URL: Record<string, unknown> = useMemo(() => {\r\n\r\n return arraySerialization === 'brackets' ? getParamsObj(searchParams) : Object.fromEntries(searchParams.entries())\r\n }, [searchParams, arraySerialization])\r\n\r\n const getParams = ({ convert = true } = {}): MergeParams<M, O> => {\r\n // All the paramteres are extracted from the URL and converted into an object\r\n\r\n const params = Object.keys(CURRENT_PARAMS_URL).reduce((acc, key) => {\r\n if (Object.prototype.hasOwnProperty.call(TOTAL_PARAMS_PAGE, key)) {\r\n const realKey = arraySerialization === 'brackets' ? key.replace('[]', '') : key\r\n // @ts-ignore\r\n acc[realKey] = convert === true\r\n ? convertOriginalType(CURRENT_PARAMS_URL[key] as string, key)\r\n : getStringUrl(key, CURRENT_PARAMS_URL)\r\n }\r\n return acc\r\n }, {})\r\n \r\n return params as MergeParams<M, O>\r\n }\r\n type keys = keyof MergeParams<M, O>\r\n // Note: in this way the return of the getParam function is typed dynamically, thus having autocomplete in the IDE (eg: value.split(','))\r\n type TagReturn<T extends boolean> = T extends true ? string[] : string;\r\n const getParam = <T extends boolean>(key: keys, options?: { convert: T }): TagReturn<T> => {\r\n\r\n const keyStr = String(key)\r\n // @ts-ignore\r\n const value = options?.convert === true ? convertOriginalType(searchParams.get(keyStr), keyStr) : getStringUrl(keyStr, CURRENT_PARAMS_URL)\r\n return value as TagReturn<T> \r\n }\r\n \r\n type OptionalParamsFiltered = Partial<O>\r\n\r\n const calculateOmittedParameters = (newParams: Record<string, unknown \| unknown[]>, keepParams: Record<string, boolean>) => {\r\n // Calculate the ommited parameters, that is, the parameters that have not been sent in the request\r\n const params = getParams()\r\n // hasOw\r\n // Note: it will be necessary to omit the parameters that are arrays because the idea is not to replace them but to add or remove some values\r\n const newParamsWithoutArray = Object.entries(newParams).filter(([key,]) => !Array.isArray(TOTAL_PARAMS_PAGE[key]))\r\n const result = Object.assign({\r\n ...params,\r\n ...Object.fromEntries(newParamsWithoutArray),\r\n ...forceParams // the forced parameters will always be sent and will maintain their value\r\n })\r\n const paramsFiltered: OptionalParamsFiltered = Object.keys(result).reduce((acc, key) => {\r\n // for default no parameters are omitted unless specified in the keepParams object\r\n if (Object.prototype.hasOwnProperty.call(keepParams, key) && keepParams[key] === false) {\r\n return acc\r\n // Note: They array of parameters omitted by values (e.g., ['all', 'default']) are omitted since they are usually a default value that is not desired to be sent\r\n } else if (!!result[key] !== false && !omitParamsByValues.includes(result[key])) {\r\n // @ts-ignore\r\n acc[key] = result[key]\r\n }\r\n\r\n return acc\r\n }, {})\r\n\r\n return {\r\n ...mandatory,\r\n ...paramsFiltered\r\n } \r\n }\r\n // @ts-ignore\r\n const sortParameters = (paramsFiltered) => {\r\n // sort the parameters according to the structure so that it persists with each change in the URL, eg: localhost:3000/?page=1&page_size=10\r\n // Note: this visibly improves the user experience\r\n const orderedParams = PARAM_ORDER.reduce((acc, key) => {\r\n if (Object.prototype.hasOwnProperty.call(paramsFiltered, key)) {\r\n // @ts-ignore\r\n acc[key] = paramsFiltered[key]\r\n }\r\n\r\n return acc\r\n }, {})\r\n return orderedParams\r\n }\r\n\r\n const mandatoryParameters = () => {\r\n // Note: in case there are arrays in the URL, they are converted to their original form ej: tags=['tag1', 'tag2'] otherwise the parameters are extracted without converting to optimize performance\r\n const isNecessaryConvert: boolean = ARRAY_KEYS.length > 0 ? true : false\r\n const totalParametros: Record<string, unknown> = getParams({ convert: isNecessaryConvert })\r\n\r\n const paramsUrlFound: Record<string, boolean> = Object.keys(totalParametros).reduce(\r\n (acc, key) => {\r\n if (Object.prototype.hasOwnProperty.call(mandatory, key)) {\r\n // @ts-ignore\r\n acc[key] = totalParametros[key]\r\n }\r\n return acc\r\n },\r\n {}\r\n )\r\n\r\n return paramsUrlFound\r\n }\r\n\r\n const clearParams = ({ keepMandatoryParams = true } = {}): void => {\r\n // for default, the mandatory parameters are not cleared since the current pagination would be lost\r\n const paramsTransformed = transformParamsToURLSearch(\r\n {\r\n ...mandatory,\r\n \r\n ...(keepMandatoryParams && {\r\n ...mandatoryParameters()\r\n }),\r\n ...forceParams \r\n }\r\n )\r\n setSearchParams(paramsTransformed) \r\n }\r\n\r\n // transforms the keys to boolean to know which parameters to keep\r\n type KeepParamsTransformedValuesBoolean = Partial<Record<keyof typeof TOTAL_PARAMS_PAGE, boolean>>\r\n type NewParams = Partial<typeof TOTAL_PARAMS_PAGE> \r\n type KeepParams = KeepParamsTransformedValuesBoolean\r\n const updateParams = ({ newParams = {} as NewParams, keepParams = {} as KeepParams } = {}) => {\r\n\r\n if (\r\n Object.keys(newParams).length === 0 &&\r\n Object.keys(keepParams).length === 0\r\n ) {\r\n clearParams()\r\n return\r\n }\r\n // @ts-ignore\r\n const finallyParamters = calculateOmittedParameters(newParams, keepParams)\r\n\r\n const convertedArrayValues = appendArrayValues(finallyParamters, newParams)\r\n\r\n const paramsSorted = sortParameters(convertedArrayValues)\r\n\r\n setSearchParams(transformParamsToURLSearch(paramsSorted))\r\n\r\n }\r\n\r\n // only for the keys of the parameters to subscribe to changes in the URL to trigger the callback\r\n const onChange = useCallback( (paramName: keys, callbacks: Array<() => void>) => {\r\n const paramNameStr = String(paramName)\r\n // replace the previous callbacks with the new ones so as not to accumulate callbacks\r\n subscriptionsRef.current[paramNameStr] = callbacks;\r\n }, [])\r\n \r\n // each time searchParams changes, we notify the subscribers\r\n useEffect(() => {\r\n\r\n for (const [key, value] of Object.entries(subscriptionsRef.current)) {\r\n\r\n const newValue = CURRENT_PARAMS_URL[key] ?? null \r\n const oldValue = previousParamsRef.current[key] ?? null\r\n if (newValue !== oldValue) {\r\n \r\n for (const callback of value) {\r\n console.log(value)\r\n\r\n callback()\r\n\r\n }\r\n }\r\n // once the callback is executed, the previous value is updated to ensure that the next time the value changes, the callback is executed\r\n previousParamsRef.current[key] = newValue\r\n }\r\n\r\n \r\n }, [CURRENT_PARAMS_URL])\r\n return {\r\n searchParams,\r\n updateParams,\r\n clearParams,\r\n getParams,\r\n getParam,\r\n onChange\r\n }\r\n}\r\n"],"names":["useMagicSearchParams","_ref","mandatory","_ref$mandatory","_ref$optional","optional","_ref$defaultParams","defaultParams","_ref$arraySerializati","arraySerialization","_ref$forceParams","forceParams","_ref$omitParamsByValu","omitParamsByValues","_useSearchParams","useSearchParams","searchParams","setSearchParams","subscriptionsRef","useRef","previousParamsRef","TOTAL_PARAMS_PAGE","useMemo","_extends","PARAM_ORDER","Array","from","Object","keys","ARRAY_KEYS","filter","key","isArray","appendArrayValues","finallyParams","newParams","updatedParams","length","forEach","currentValues","raw","get","split","map","v","trim","Boolean","urlParams","getAll","console","log","REPEAT","BRACKETS","_searchParams$get","undefined","incoming","combined","includes","concat","CONBINED_STRING","Set","transformParamsToURLSearch","params","PARAMS_RECIBIDOS_TRANSFORM","newParam","URLSearchParams","paramsKeys","_i","_paramsKeys","arrayValue","csvValue","join","set","_iterator","_createForOfIteratorHelperLoose","_step","done","item","value","append","_iterator2","_step2","FINAL","toString","hasForcedParamsValues","_ref2","paramsForced","compareParams","allParamsMatch","entries","every","_ref3","useEffect","keysDefaultParams","keysForceParams","handleStartingParams","defaultParamsString","paramsUrl","getParams","paramsUrlString","forceParamsString","isForcedParams","updateParams","isIncludesForcedParams","convertOriginalType","parseInt","SEARCH_PARAMS","getStringUrl","isKeyArray","_transformParamsToURL3","_transformParamsToURL","arrayUrl","encodedQueryArray","unencodeQuery","decodeURIComponent","_transformParamsToURL2","stringResult","getParamsObj","paramsObj","_iterator3","_step3","_step3$value","endsWith","bareKey","replace","push","CURRENT_PARAMS_URL","fromEntries","_temp","_ref4$convert","_ref4","convert","reduce","acc","prototype","hasOwnProperty","call","realKey","getParam","options","keyStr","String","calculateOmittedParameters","keepParams","newParamsWithoutArray","_ref5","result","assign","paramsFiltered","sortParameters","orderedParams","mandatoryParameters","isNecessaryConvert","totalParametros","paramsUrlFound","clearParams","_temp2","_ref6$keepMandatoryPa","_ref6","keepMandatoryParams","paramsTransformed","_temp3","_ref7$newParams","_ref7","_ref7$keepParams","finallyParamters","convertedArrayValues","paramsSorted","onChange","useCallback","paramName","callbacks","paramNameStr","current","_i2","_Object$entries","_CURRENT_PARAMS_URL$k","_previousParamsRef$cu","_Object$entries$_i","newValue","oldValue","_iterator4","_step4","callback"],"mappings":"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"}
1	+ {"version":3,"file":"react-magic-search-params.esm.js","sources":["../src/useMagicSearchParams.ts"],"sourcesContent":["import { useSearchParams } from 'react-router-dom'\r\nimport { useMemo, useEffect, useRef, useCallback } from 'react'\r\n\r\n\r\n// Custom hook with advanced techniques to handle search parameters for any pagination\r\n\r\ntype CommonParams = {\r\n page?: number\r\n page_size?: number\r\n}\r\n/\r\nMaps all properties of M (mandatory) as required\r\nand all properties of O (optional) as optional. \r\n/\r\ntype MergeParams<M, O> = {\r\n [K in keyof M]: M[K]\r\n} & {\r\n [K in keyof O]?: O[K]\r\n}\r\n/*\r\n Interface for the configuration object that the hook receives \r\n /\r\nexport interface UseMagicSearchParamsOptions<\r\n M extends Record<string, unknown>,\r\n O extends Record<string, unknown>\r\n> {\r\n mandatory: M \r\n optional?: O\r\n defaultParams?: Partial<MergeParams<M, O>>\r\n forceParams?: Partial<MergeParams<M, O>> // transform all to partial to avoid errors\r\n arraySerialization?: 'csv' \| 'repeat' \| 'brackets' // technical to serialize arrays in the URL\r\n omitParamsByValues?: Array<'all' \| 'default' \| 'unknown' \| 'none' \| 'void '> \r\n}\r\n\r\n/* \r\nGeneric hook to handle search parameters in the URL\r\n@param mandatory - Mandatory parameters (e.g., page=1, page_size=10, etc.)\r\n@param optional - Optional parameters (e.g., order, search, etc.)\r\n@param defaultParams - Default parameters sent in the URL on initialization\r\n@param forceParams - Parameters forced into the URL regardless of user input\r\n@param omitParamsByValues - Parameters omitted if they have specific values \r\n/\r\nexport const useMagicSearchParams = <\r\n M extends Record<string, unknown> & CommonParams,\r\n O extends Record<string, unknown>,\r\n>({\r\n mandatory = {} as M,\r\n optional = {} as O,\r\n defaultParams = {} as Partial<MergeParams<M, O>>,\r\n arraySerialization = 'csv',\r\n forceParams = {} as {} as Partial<MergeParams<M, O>>,\r\n omitParamsByValues = [] as Array<'all' \| 'default' \| 'unknown' \| 'none' \| 'void '>\r\n}: UseMagicSearchParamsOptions<M, O>)=> {\r\n\r\n\r\n const [searchParams, setSearchParams] = useSearchParams() \r\n // Ref to store subscriptions: { paramName: [callback1, callback2, ...] }\r\n const subscriptionsRef = useRef<Record<string, Array<() => unknown>>>({}); \r\n const previousParamsRef = useRef<Record<string, unknown>>({})\r\n\r\n const TOTAL_PARAMS_PAGE: MergeParams<M, O> = useMemo(() => {\r\n return { ...mandatory, ...optional };\r\n }, [mandatory, optional]);\r\n\r\n const PARAM_ORDER = useMemo(() => {\r\n return Array.from(Object.keys(TOTAL_PARAMS_PAGE))\r\n }, [TOTAL_PARAMS_PAGE])\r\n\r\n // we get the keys that are arrays according to TOTAL_PARAMS_PAGE since these require special treatment in the URL due to serialization mode\r\n const ARRAY_KEYS = useMemo(() => {\r\n return Object.keys(TOTAL_PARAMS_PAGE).filter(\r\n (key) => Array.isArray(TOTAL_PARAMS_PAGE[key])\r\n );\r\n }, [TOTAL_PARAMS_PAGE])\r\n\r\n const appendArrayValues = (\r\n finallyParams: Record<string, unknown>,\r\n newParams: Record<string, string \| string[] \| unknown>\r\n ): Record<string, unknown> => {\r\n \r\n // Note: We cannot modify the object of the final parameters directly, as immutability must be maintained\r\n const updatedParams = { ...finallyParams };\r\n \r\n\r\n if (ARRAY_KEYS.length === 0) return updatedParams;\r\n \r\n ARRAY_KEYS.forEach((key) => {\r\n // We use the current values directly from searchParams (source of truth)\r\n // This avoids depending on finallyParams in which the arrays have been omitted\r\n let currentValues = []; \r\n switch (arraySerialization) {\r\n case 'csv': {\r\n const raw = searchParams.get(key) \|\| '';\r\n // For csv we expect \"value1,value2,...\" (no prefix)\r\n currentValues = raw.split(',')\r\n .map((v) => v.trim())\r\n .filter(Boolean) as Array<string>\r\n break;\r\n }\r\n case 'repeat': {\r\n // Here we get all ocurrences of key\r\n const urlParams = searchParams.getAll(key) as Array<string>\r\n currentValues = urlParams.length > 0 ? urlParams : []\r\n \r\n console.log({REPEAT: currentValues})\r\n break;\r\n }\r\n case 'brackets': {\r\n // Build URLSearchParams from current parameters (to ensure no serialized values are taken previously)\r\n const urlParams = searchParams.getAll(`${key}[]`) as Array<string>\r\n currentValues = urlParams.length > 0 ? urlParams : []\r\n console.log({BRACKETS: urlParams})\r\n \r\n \r\n break;\r\n }\r\n default: {\r\n // Mode by default works as csv\r\n const raw = searchParams.get(key) ?? '';\r\n currentValues = raw.split(',')\r\n .map((v) => v.trim())\r\n .filter(Boolean);\r\n }\r\n break; \r\n }\r\n // Update array values with new ones\r\n \r\n if (newParams[key] !== undefined) {\r\n const incoming = newParams[key];\r\n let combined: string[] = []\r\n if (typeof incoming === 'string') {\r\n // If it is a string, it is toggled (add/remove)\r\n combined = currentValues.includes(incoming)\r\n ? currentValues.filter((v) => v !== incoming)\r\n : [...currentValues, incoming];\r\n console.log({currentValues})\r\n console.log({incoming})\r\n console.log({CONBINED_STRING: combined})\r\n } else if (Array.isArray(incoming)) {\r\n // if an array is passed, repeated values are merged into a single value\r\n // Note: Set is used to remove duplicates\r\n combined = Array.from(new Set([ ...incoming]));\r\n console.log({incoming})\r\n console.log({combined})\r\n } else {\r\n \r\n combined = currentValues;\r\n }\r\n\r\n updatedParams[key] = combined\r\n\r\n }\r\n });\r\n console.log({updatedParams})\r\n return updatedParams\r\n };\r\n\r\n const transformParamsToURLSearch = (params: Record<string, unknown>): URLSearchParams => {\r\n console.log({PARAMS_RECIBIDOS_TRANSFORM: params})\r\n\r\n const newParam: URLSearchParams = new URLSearchParams()\r\n\r\n const paramsKeys = Object.keys(params)\r\n\r\n for (const key of paramsKeys) {\r\n if (Array.isArray(TOTAL_PARAMS_PAGE[key])) {\r\n const arrayValue = params[key] as unknown[]\r\n console.log({arrayValue})\r\n switch (arraySerialization) {\r\n case 'csv': {\r\n const csvValue = arrayValue.join(',')\r\n // set ensure that the previous value is replaced\r\n newParam.set(key, csvValue)\r\n break\r\n } case 'repeat': {\r\n \r\n for (const item of arrayValue) {\r\n console.log({item})\r\n // add new value to the key, instead of replacing it\r\n newParam.append(key, item as string)\r\n \r\n }\r\n break\r\n } case 'brackets': {\r\n for (const item of arrayValue) {\r\n newParam.append(`${key}[]`, item as string)\r\n }\r\n break\r\n } default: {\r\n const csvValue = arrayValue.join(',')\r\n newParam.set(key, csvValue)\r\n }\r\n }\r\n } else {\r\n newParam.set(key, params[key] as string)\r\n }\r\n }\r\n console.log({FINAL: newParam.toString()})\r\n return newParam\r\n }\r\n // @ts-ignore\r\n const hasForcedParamsValues = ({ paramsForced, compareParams }) => {\r\n\r\n // Iterates over the forced parameters and verifies that they exist in the URL and match their values\r\n // Ej: { page: 1, page_size: 10 } === { page: 1, page_size: 10 } => true\r\n const allParamsMatch = Object.entries(paramsForced).every(\r\n ([key, value]) => compareParams[key] === value\r\n );\r\n\r\n return allParamsMatch;\r\n };\r\n \r\n useEffect(() => {\r\n\r\n const keysDefaultParams: string[] = Object.keys(defaultParams)\r\n const keysForceParams: string[] = Object.keys(forceParams)\r\n if(keysDefaultParams.length === 0 && keysForceParams.length === 0) return\r\n \r\n\r\n function handleStartingParams() {\r\n\r\n const defaultParamsString = transformParamsToURLSearch(defaultParams).toString()\r\n const paramsUrl = getParams()\r\n const paramsUrlString = transformParamsToURLSearch(paramsUrl).toString()\r\n const forceParamsString = transformParamsToURLSearch(forceParams).toString()\r\n\r\n console.log({defaultParamsString})\r\n\r\n const isForcedParams: boolean = hasForcedParamsValues({ paramsForced: forceParams, compareParams: paramsUrl })\r\n\r\n if (!isForcedParams) {\r\n\r\n // In this case, the forced parameters take precedence over the default parameters and the parameters of the current URL (which could have been modified by the user, e.g., page_size=1000)\r\n\r\n updateParams({ newParams: {\r\n ...defaultParams,\r\n ...forceParams\r\n }})\r\n return\r\n }\r\n // In this way it will be validated that the forced parameters keys and values are in the current URL\r\n const isIncludesForcedParams = hasForcedParamsValues({ paramsForced: forceParamsString, compareParams: defaultParams })\r\n\r\n if (keysDefaultParams.length > 0 && isIncludesForcedParams) {\r\n if (defaultParamsString === paramsUrlString) return // this means that the URL already has the default parameters\r\n updateParams({ newParams: defaultParams })\r\n }\r\n\r\n }\r\n handleStartingParams()\r\n\r\n // eslint-disable-next-line react-hooks/exhaustive-deps\r\n }, [])\r\n\r\n /\r\n Convert a string value to its original type (number, boolean, array) according to TOTAL_PARAMS_PAGE\r\n * @param value - Chain obtained from the URL\r\n * @param key - Key of the parameter\r\n /\r\n const convertOriginalType = (value: string, key: string) => {\r\n // Given that the parameters of a URL are recieved as strings, they are converted to their original type\r\n if (typeof TOTAL_PARAMS_PAGE[key] === 'number') {\r\n return parseInt(value)\r\n } else if (typeof TOTAL_PARAMS_PAGE[key] === 'boolean') {\r\n return value === 'true'\r\n } else if (Array.isArray(TOTAL_PARAMS_PAGE[key])) {\r\n // The result will be a valid array represented in the URL ej: tags=tag1,tag2,tag3 to ['tag1', 'tag2', 'tag3'], useful to combine the values of the arrays with the new ones\r\n \r\n if (arraySerialization === 'csv') {\r\n return searchParams.getAll(key).join('').split(',')\r\n } else if (arraySerialization === 'repeat') {\r\n \r\n console.log({SEARCH_PARAMS: searchParams.getAll(key)})\r\n return searchParams.getAll(key)\r\n } else if (arraySerialization === 'brackets') {\r\n return searchParams.getAll(`${key}[]`)\r\n }\r\n \r\n \r\n }\r\n // Note: dates are not converted as it is better to handle them directly in the component that receives them, using a library like < date-fns >\r\n return value\r\n }\r\n \r\n /\r\n Gets the current parameters from the URL and converts them to their original type if desired\r\n * @param convert - If true, converts from string to the inferred type (number, boolean, ...)\r\n */\r\n const getStringUrl = (key: string, paramsUrl: Record<string, unknown>) => {\r\n const isKeyArray = Array.isArray(TOTAL_PARAMS_PAGE[key])\r\n if (isKeyArray) {\r\n\r\n if (arraySerialization === 'brackets') {\r\n\r\n const arrayUrl = searchParams.getAll(`${key}[]`)\r\n const encodedQueryArray = transformParamsToURLSearch({ [key]: arrayUrl }).toString()\r\n // in this way the array of the URL is decoded to its original form ej: tags[]=tag1&tags[]=tag2&tags[]=tag3\r\n const unencodeQuery = decodeURIComponent(encodedQueryArray)\r\n return unencodeQuery\r\n } else if (arraySerialization === 'csv') {\r\n const arrayValue = searchParams.getAll(key)\r\n const encodedQueryArray = transformParamsToURLSearch({ [key]: arrayValue }).toString()\r\n const unencodeQuery = decodeURIComponent(encodedQueryArray)\r\n return unencodeQuery\r\n }\r\n const arrayValue = searchParams.getAll(key)\r\n const stringResult = transformParamsToURLSearch({ [key]: arrayValue }).toString()\r\n return stringResult\r\n } else {\r\n \r\n return paramsUrl[key] as string\r\n }\r\n }\r\n const getParamsObj = (searchParams: URLSearchParams): Record<string, string \| string[]> => {\r\n const paramsObj: Record<string, string \| string[]> = {};\r\n // @ts-ignore\r\n for (const [key, value] of searchParams.entries()) {\r\n if (key.endsWith('[]')) {\r\n const bareKey = key.replace('[]', '');\r\n if (paramsObj[bareKey]) {\r\n (paramsObj[bareKey] as string[]).push(value);\r\n } else {\r\n paramsObj[bareKey] = [value];\r\n }\r\n } else {\r\n // If the key already exists, it is a repeated parameter\r\n if (paramsObj[key]) {\r\n if (Array.isArray(paramsObj[key])) {\r\n (paramsObj[key] as string[]).push(value);\r\n } else {\r\n paramsObj[key] = [paramsObj[key] as string, value];\r\n }\r\n } else {\r\n paramsObj[key] = value;\r\n }\r\n }\r\n }\r\n return paramsObj;\r\n }\r\n // Optimization: While the parameters are not updated, the current parameters of the URL are not recalculated\r\n const CURRENT_PARAMS_URL: Record<string, unknown> = useMemo(() => {\r\n\r\n return arraySerialization === 'brackets' ? getParamsObj(searchParams) : Object.fromEntries(searchParams.entries())\r\n }, [searchParams, arraySerialization])\r\n\r\n const getParams = ({ convert = true } = {}): MergeParams<M, O> => {\r\n // All the paramteres are extracted from the URL and converted into an object\r\n\r\n const params = Object.keys(CURRENT_PARAMS_URL).reduce((acc, key) => {\r\n if (Object.prototype.hasOwnProperty.call(TOTAL_PARAMS_PAGE, key)) {\r\n const realKey = arraySerialization === 'brackets' ? key.replace('[]', '') : key\r\n // @ts-ignore\r\n acc[realKey] = convert === true\r\n ? convertOriginalType(CURRENT_PARAMS_URL[key] as string, key)\r\n : getStringUrl(key, CURRENT_PARAMS_URL)\r\n }\r\n return acc\r\n }, {})\r\n \r\n return params as MergeParams<M, O>\r\n }\r\n type keys = keyof MergeParams<M, O>\r\n // Note: in this way the return of the getParam function is typed dynamically, thus having autocomplete in the IDE (eg: value.split(','))\r\n type TagReturn<T extends boolean> = T extends true ? string[] : string;\r\n const getParam = <T extends boolean>(key: keys, options?: { convert: T }): TagReturn<T> => {\r\n\r\n const keyStr = String(key)\r\n // @ts-ignore\r\n const value = options?.convert === true ? convertOriginalType(searchParams.get(keyStr), keyStr) : getStringUrl(keyStr, CURRENT_PARAMS_URL)\r\n return value as TagReturn<T> \r\n }\r\n \r\n type OptionalParamsFiltered = Partial<O>\r\n\r\n const calculateOmittedParameters = (newParams: Record<string, unknown \| unknown[]>, keepParams: Record<string, boolean>) => {\r\n // Calculate the ommited parameters, that is, the parameters that have not been sent in the request\r\n const params = getParams()\r\n // hasOw\r\n // Note: it will be necessary to omit the parameters that are arrays because the idea is not to replace them but to add or remove some values\r\n const newParamsWithoutArray = Object.entries(newParams).filter(([key,]) => !Array.isArray(TOTAL_PARAMS_PAGE[key]))\r\n const result = Object.assign({\r\n ...params,\r\n ...Object.fromEntries(newParamsWithoutArray),\r\n ...forceParams // the forced parameters will always be sent and will maintain their value\r\n })\r\n const paramsFiltered: OptionalParamsFiltered = Object.keys(result).reduce((acc, key) => {\r\n // for default no parameters are omitted unless specified in the keepParams object\r\n if (Object.prototype.hasOwnProperty.call(keepParams, key) && keepParams[key] === false) {\r\n return acc\r\n // Note: They array of parameters omitted by values (e.g., ['all', 'default']) are omitted since they are usually a default value that is not desired to be sent\r\n } else if (!!result[key] !== false && !omitParamsByValues.includes(result[key])) {\r\n // @ts-ignore\r\n acc[key] = result[key]\r\n }\r\n\r\n return acc\r\n }, {})\r\n\r\n return {\r\n ...mandatory,\r\n ...paramsFiltered\r\n } \r\n }\r\n // @ts-ignore\r\n const sortParameters = (paramsFiltered) => {\r\n // sort the parameters according to the structure so that it persists with each change in the URL, eg: localhost:3000/?page=1&page_size=10\r\n // Note: this visibly improves the user experience\r\n const orderedParams = PARAM_ORDER.reduce((acc, key) => {\r\n if (Object.prototype.hasOwnProperty.call(paramsFiltered, key)) {\r\n // @ts-ignore\r\n acc[key] = paramsFiltered[key]\r\n }\r\n\r\n return acc\r\n }, {})\r\n return orderedParams\r\n }\r\n\r\n const mandatoryParameters = () => {\r\n // Note: in case there are arrays in the URL, they are converted to their original form ej: tags=['tag1', 'tag2'] otherwise the parameters are extracted without converting to optimize performance\r\n const isNecessaryConvert: boolean = ARRAY_KEYS.length > 0 ? true : false\r\n const totalParametros: Record<string, unknown> = getParams({ convert: isNecessaryConvert })\r\n\r\n const paramsUrlFound: Record<string, boolean> = Object.keys(totalParametros).reduce(\r\n (acc, key) => {\r\n if (Object.prototype.hasOwnProperty.call(mandatory, key)) {\r\n // @ts-ignore\r\n acc[key] = totalParametros[key]\r\n }\r\n return acc\r\n },\r\n {}\r\n )\r\n\r\n return paramsUrlFound\r\n }\r\n\r\n const clearParams = ({ keepMandatoryParams = true } = {}): void => {\r\n // for default, the mandatory parameters are not cleared since the current pagination would be lost\r\n const paramsTransformed = transformParamsToURLSearch(\r\n {\r\n ...mandatory,\r\n \r\n ...(keepMandatoryParams && {\r\n ...mandatoryParameters()\r\n }),\r\n ...forceParams \r\n }\r\n )\r\n setSearchParams(paramsTransformed) \r\n }\r\n\r\n // transforms the keys to boolean to know which parameters to keep\r\n type KeepParamsTransformedValuesBoolean = Partial<Record<keyof typeof TOTAL_PARAMS_PAGE, boolean>>\r\n type NewParams = Partial<typeof TOTAL_PARAMS_PAGE> \r\n type KeepParams = KeepParamsTransformedValuesBoolean\r\n const updateParams = ({ newParams = {} as NewParams, keepParams = {} as KeepParams } = {}) => {\r\n\r\n if (\r\n Object.keys(newParams).length === 0 &&\r\n Object.keys(keepParams).length === 0\r\n ) {\r\n clearParams()\r\n return\r\n }\r\n // @ts-ignore\r\n const finallyParamters = calculateOmittedParameters(newParams, keepParams)\r\n\r\n const convertedArrayValues = appendArrayValues(finallyParamters, newParams)\r\n\r\n const paramsSorted = sortParameters(convertedArrayValues)\r\n\r\n setSearchParams(transformParamsToURLSearch(paramsSorted))\r\n\r\n }\r\n\r\n // only for the keys of the parameters to subscribe to changes in the URL to trigger the callback\r\n const onChange = useCallback( (paramName: keys, callbacks: Array<() => void>) => {\r\n const paramNameStr = String(paramName)\r\n // replace the previous callbacks with the new ones so as not to accumulate callbacks\r\n subscriptionsRef.current[paramNameStr] = callbacks;\r\n }, [])\r\n \r\n // each time searchParams changes, we notify the subscribers\r\n useEffect(() => {\r\n\r\n for (const [key, value] of Object.entries(subscriptionsRef.current)) {\r\n\r\n const newValue = CURRENT_PARAMS_URL[key] ?? null \r\n const oldValue = previousParamsRef.current[key] ?? null\r\n if (newValue !== oldValue) {\r\n \r\n for (const callback of value) {\r\n console.log(value)\r\n\r\n callback()\r\n\r\n }\r\n }\r\n // once the callback is executed, the previous value is updated to ensure that the next time the value changes, the callback is executed\r\n previousParamsRef.current[key] = newValue\r\n }\r\n\r\n \r\n }, [CURRENT_PARAMS_URL])\r\n return {\r\n searchParams,\r\n updateParams,\r\n clearParams,\r\n getParams,\r\n getParam,\r\n onChange\r\n }\r\n}\r\n"],"names":["useMagicSearchParams","_ref","mandatory","_ref$mandatory","_ref$optional","optional","_ref$defaultParams","defaultParams","_ref$arraySerializati","arraySerialization","_ref$forceParams","forceParams","_ref$omitParamsByValu","omitParamsByValues","_useSearchParams","useSearchParams","searchParams","setSearchParams","subscriptionsRef","useRef","previousParamsRef","TOTAL_PARAMS_PAGE","useMemo","_extends","PARAM_ORDER","Array","from","Object","keys","ARRAY_KEYS","filter","key","isArray","appendArrayValues","finallyParams","newParams","updatedParams","length","forEach","currentValues","raw","get","split","map","v","trim","Boolean","urlParams","getAll","console","log","REPEAT","BRACKETS","_searchParams$get","undefined","incoming","combined","includes","concat","CONBINED_STRING","Set","transformParamsToURLSearch","params","PARAMS_RECIBIDOS_TRANSFORM","newParam","URLSearchParams","paramsKeys","_i","_paramsKeys","arrayValue","csvValue","join","set","_iterator","_createForOfIteratorHelperLoose","_step","done","item","value","append","_iterator2","_step2","FINAL","toString","hasForcedParamsValues","_ref2","paramsForced","compareParams","allParamsMatch","entries","every","_ref3","useEffect","keysDefaultParams","keysForceParams","handleStartingParams","defaultParamsString","paramsUrl","getParams","paramsUrlString","forceParamsString","isForcedParams","updateParams","isIncludesForcedParams","convertOriginalType","parseInt","SEARCH_PARAMS","getStringUrl","isKeyArray","_transformParamsToURL3","_transformParamsToURL","arrayUrl","encodedQueryArray","unencodeQuery","decodeURIComponent","_transformParamsToURL2","stringResult","getParamsObj","paramsObj","_iterator3","_step3","_step3$value","endsWith","bareKey","replace","push","CURRENT_PARAMS_URL","fromEntries","_temp","_ref4$convert","_ref4","convert","reduce","acc","prototype","hasOwnProperty","call","realKey","getParam","options","keyStr","String","calculateOmittedParameters","keepParams","newParamsWithoutArray","_ref5","result","assign","paramsFiltered","sortParameters","orderedParams","mandatoryParameters","isNecessaryConvert","totalParametros","paramsUrlFound","clearParams","_temp2","_ref6$keepMandatoryPa","_ref6","keepMandatoryParams","paramsTransformed","_temp3","_ref7$newParams","_ref7","_ref7$keepParams","finallyParamters","convertedArrayValues","paramsSorted","onChange","useCallback","paramName","callbacks","paramNameStr","current","_i2","_Object$entries","_CURRENT_PARAMS_URL$k","_previousParamsRef$cu","_Object$entries$_i","newValue","oldValue","_iterator4","_step4","callback"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA;;;;;;;;IAQaA,oBAAoB,GAAG,SAAvBA,oBAAoBA,CAAAC,IAAA;4BAI/BC,SAAS;IAATA,SAAS,GAAAC,cAAA,cAAG,EAAO,GAAAA,cAAA;IAAAC,aAAA,GAAAH,IAAA,CACnBI,QAAQ;IAARA,QAAQ,GAAAD,aAAA,cAAG,EAAO,GAAAA,aAAA;IAAAE,kBAAA,GAAAL,IAAA,CAClBM,aAAa;IAAbA,aAAa,GAAAD,kBAAA,cAAG,EAAgC,GAAAA,kBAAA;IAAAE,qBAAA,GAAAP,IAAA,CAChDQ,kBAAkB;IAAlBA,kBAAkB,GAAAD,qBAAA,cAAG,KAAK,GAAAA,qBAAA;IAAAE,gBAAA,GAAAT,IAAA,CAC1BU,WAAW;IAAXA,WAAW,GAAAD,gBAAA,cAAG,EAAuC,GAAAA,gBAAA;IAAAE,qBAAA,GAAAX,IAAA,CACrDY,kBAAkB;IAAlBA,kBAAkB,GAAAD,qBAAA,cAAG,EAA6D,GAAAA,qBAAA;EAIlF,IAAAE,gBAAA,GAAwCC,eAAe,EAAE;IAAlDC,YAAY,GAAAF,gBAAA;IAAEG,eAAe,GAAAH,gBAAA;;EAEpC,IAAMI,gBAAgB,GAAGC,MAAM,CAAuC,EAAE,CAAC;EACzE,IAAMC,iBAAiB,GAAGD,MAAM,CAA0B,EAAE,CAAC;EAE7D,IAAME,iBAAiB,GAAsBC,OAAO,CAAC;IACnD,OAAAC,QAAA,KAAYrB,SAAS,EAAKG,QAAQ;GACnC,EAAE,CAACH,SAAS,EAAEG,QAAQ,CAAC,CAAC;EAEzB,IAAMmB,WAAW,GAAGF,OAAO,CAAC;IAC1B,OAAOG,KAAK,CAACC,IAAI,CAACC,MAAM,CAACC,IAAI,CAACP,iBAAiB,CAAC,CAAC;GAClD,EAAE,CAACA,iBAAiB,CAAC,CAAC;;EAGvB,IAAMQ,UAAU,GAAGP,OAAO,CAAC;IACzB,OAAOK,MAAM,CAACC,IAAI,CAACP,iBAAiB,CAAC,CAACS,MAAM,CAC1C,UAACC,GAAG;MAAA,OAAKN,KAAK,CAACO,OAAO,CAACX,iBAAiB,CAACU,GAAG,CAAC,CAAC;MAC/C;GACF,EAAE,CAACV,iBAAiB,CAAC,CAAC;EAEvB,IAAMY,iBAAiB,GAAG,SAApBA,iBAAiBA,CACrBC,aAAsC,EACtCC,SAAsD;;IAItD,IAAMC,aAAa,GAAAb,QAAA,KAAQW,aAAa,CAAE;IAG1C,IAAIL,UAAU,CAACQ,MAAM,KAAK,CAAC,EAAE,OAAOD,aAAa;IAEjDP,UAAU,CAACS,OAAO,CAAC,UAACP,GAAG;;;MAGrB,IAAIQ,aAAa,GAAG,EAAE;MACtB,QAAQ9B,kBAAkB;QACxB,KAAK,KAAK;UAAE;YACV,IAAM+B,GAAG,GAAGxB,YAAY,CAACyB,GAAG,CAACV,GAAG,CAAC,IAAI,EAAE;;YAEvCQ,aAAa,GAAGC,GAAG,CAACE,KAAK,CAAC,GAAG,CAAC,CAC3BC,GAAG,CAAC,UAACC,CAAC;cAAA,OAAKA,CAAC,CAACC,IAAI,EAAE;cAAC,CACpBf,MAAM,CAACgB,OAAO,CAAkB;YACnC;;QAEF,KAAK,QAAQ;UAAE;;YAEb,IAAMC,SAAS,GAAG/B,YAAY,CAACgC,MAAM,CAACjB,GAAG,CAAkB;YAC3DQ,aAAa,GAAGQ,SAAS,CAACV,MAAM,GAAG,CAAC,GAAGU,SAAS,GAAG,EAAE;YAErDE,OAAO,CAACC,GAAG,CAAC;cAACC,MAAM,EAAEZ;aAAc,CAAC;YACpC;;QAEF,KAAK,UAAU;UAAE;;YAEb,IAAMQ,UAAS,GAAG/B,YAAY,CAACgC,MAAM,CAAIjB,GAAG,OAAI,CAAkB;YAClEQ,aAAa,GAAGQ,UAAS,CAACV,MAAM,GAAG,CAAC,GAAGU,UAAS,GAAG,EAAE;YACrDE,OAAO,CAACC,GAAG,CAAC;cAACE,QAAQ,EAAEL;aAAU,CAAC;YAGlC;;QAEJ;UAAS;YAAA,IAAAM,iBAAA;;YAEP,IAAMb,IAAG,IAAAa,iBAAA,GAAGrC,YAAY,CAACyB,GAAG,CAACV,GAAG,CAAC,YAAAsB,iBAAA,GAAI,EAAE;YACvCd,aAAa,GAAGC,IAAG,CAACE,KAAK,CAAC,GAAG,CAAC,CAC3BC,GAAG,CAAC,UAACC,CAAC;cAAA,OAAKA,CAAC,CAACC,IAAI,EAAE;cAAC,CACpBf,MAAM,CAACgB,OAAO,CAAC;;UAEpB;;;MAIF,IAAIX,SAAS,CAACJ,GAAG,CAAC,KAAKuB,SAAS,EAAE;QAChC,IAAMC,QAAQ,GAAGpB,SAAS,CAACJ,GAAG,CAAC;QAC/B,IAAIyB,QAAQ,GAAa,EAAE;QAC3B,IAAI,OAAOD,QAAQ,KAAK,QAAQ,EAAE;;UAEhCC,QAAQ,GAAGjB,aAAa,CAACkB,QAAQ,CAACF,QAAQ,CAAC,GACvChB,aAAa,CAACT,MAAM,CAAC,UAACc,CAAC;YAAA,OAAKA,CAAC,KAAKW,QAAQ;YAAC,MAAAG,MAAA,CACvCnB,aAAa,GAAEgB,QAAQ,EAAC;UAChCN,OAAO,CAACC,GAAG,CAAC;YAACX,aAAa,EAAbA;WAAc,CAAC;UAC1BU,OAAO,CAACC,GAAG,CAAC;YAACK,QAAQ,EAARA;WAAS,CAAC;UACzBN,OAAO,CAACC,GAAG,CAAC;YAACS,eAAe,EAAEH;WAAS,CAAC;SACzC,MAAM,IAAI/B,KAAK,CAACO,OAAO,CAACuB,QAAQ,CAAC,EAAE;;;UAGlCC,QAAQ,GAAG/B,KAAK,CAACC,IAAI,CAAC,IAAIkC,GAAG,IAAAF,MAAA,CAAMH,QAAQ,CAAC,CAAC,CAAC;UAC9CN,OAAO,CAACC,GAAG,CAAC;YAACK,QAAQ,EAARA;WAAS,CAAC;UACvBN,OAAO,CAACC,GAAG,CAAC;YAACM,QAAQ,EAARA;WAAS,CAAC;SACxB,MAAM;UAELA,QAAQ,GAAGjB,aAAa;;QAG1BH,aAAa,CAACL,GAAG,CAAC,GAAGyB,QAAQ;;KAGhC,CAAC;IACFP,OAAO,CAACC,GAAG,CAAC;MAACd,aAAa,EAAbA;KAAc,CAAC;IAC5B,OAAOA,aAAa;GACrB;EAED,IAAMyB,0BAA0B,GAAG,SAA7BA,0BAA0BA,CAAIC,MAA+B;IACjEb,OAAO,CAACC,GAAG,CAAC;MAACa,0BAA0B,EAAED;KAAO,CAAC;IAEjD,IAAME,QAAQ,GAAoB,IAAIC,eAAe,EAAE;IAEvD,IAAMC,UAAU,GAAGvC,MAAM,CAACC,IAAI,CAACkC,MAAM,CAAC;IAEtC,SAAAK,EAAA,MAAAC,WAAA,GAAkBF,UAAU,EAAAC,EAAA,GAAAC,WAAA,CAAA/B,MAAA,EAAA8B,EAAA,IAAE;MAAzB,IAAMpC,GAAG,GAAAqC,WAAA,CAAAD,EAAA;MACZ,IAAI1C,KAAK,CAACO,OAAO,CAACX,iBAAiB,CAACU,GAAG,CAAC,CAAC,EAAE;QACzC,IAAMsC,UAAU,GAAGP,MAAM,CAAC/B,GAAG,CAAc;QAC3CkB,OAAO,CAACC,GAAG,CAAC;UAACmB,UAAU,EAAVA;SAAW,CAAC;QACzB,QAAQ5D,kBAAkB;UACxB,KAAK,KAAK;YAAE;cACV,IAAM6D,QAAQ,GAAGD,UAAU,CAACE,IAAI,CAAC,GAAG,CAAC;;cAErCP,QAAQ,CAACQ,GAAG,CAACzC,GAAG,EAAEuC,QAAQ,CAAC;cAC3B;;UACA,KAAK,QAAQ;YAAE;cAEf,SAAAG,SAAA,GAAAC,+BAAA,CAAmBL,UAAU,GAAAM,KAAA,IAAAA,KAAA,GAAAF,SAAA,IAAAG,IAAA,GAAE;gBAAA,IAApBC,IAAI,GAAAF,KAAA,CAAAG,KAAA;gBACb7B,OAAO,CAACC,GAAG,CAAC;kBAAC2B,IAAI,EAAJA;iBAAK,CAAC;;gBAEnBb,QAAQ,CAACe,MAAM,CAAChD,GAAG,EAAE8C,IAAc,CAAC;;cAGtC;;UACA,KAAK,UAAU;YAAE;cACjB,SAAAG,UAAA,GAAAN,+BAAA,CAAmBL,UAAU,GAAAY,MAAA,IAAAA,MAAA,GAAAD,UAAA,IAAAJ,IAAA,GAAE;gBAAA,IAApBC,KAAI,GAAAI,MAAA,CAAAH,KAAA;gBACbd,QAAQ,CAACe,MAAM,CAAIhD,GAAG,SAAM8C,KAAc,CAAC;;cAE7C;;UACA;YAAS;cACT,IAAMP,SAAQ,GAAGD,UAAU,CAACE,IAAI,CAAC,GAAG,CAAC;cACrCP,QAAQ,CAACQ,GAAG,CAACzC,GAAG,EAAEuC,SAAQ,CAAC;;;OAGhC,MAAM;QACLN,QAAQ,CAACQ,GAAG,CAACzC,GAAG,EAAE+B,MAAM,CAAC/B,GAAG,CAAW,CAAC;;;IAG5CkB,OAAO,CAACC,GAAG,CAAC;MAACgC,KAAK,EAAElB,QAAQ,CAACmB,QAAQ;KAAG,CAAC;IACzC,OAAOnB,QAAQ;GAChB;;EAED,IAAMoB,qBAAqB,GAAG,SAAxBA,qBAAqBA,CAAAC,KAAA;QAAMC,YAAY,GAAAD,KAAA,CAAZC,YAAY;MAAEC,aAAa,GAAAF,KAAA,CAAbE,aAAa;;;IAI1D,IAAMC,cAAc,GAAG7D,MAAM,CAAC8D,OAAO,CAACH,YAAY,CAAC,CAACI,KAAK,CACvD,UAAAC,KAAA;MAAA,IAAE5D,GAAG,GAAA4D,KAAA;QAAEb,KAAK,GAAAa,KAAA;MAAA,OAAMJ,aAAa,CAACxD,GAAG,CAAC,KAAK+C,KAAK;MAC/C;IAED,OAAOU,cAAc;GACtB;EAEDI,SAAS,CAAC;IAER,IAAMC,iBAAiB,GAAalE,MAAM,CAACC,IAAI,CAACrB,aAAa,CAAC;IAC9D,IAAMuF,eAAe,GAAanE,MAAM,CAACC,IAAI,CAACjB,WAAW,CAAC;IAC1D,IAAGkF,iBAAiB,CAACxD,MAAM,KAAK,CAAC,IAAIyD,eAAe,CAACzD,MAAM,KAAK,CAAC,EAAE;IAGnE,SAAS0D,oBAAoBA;MAE3B,IAAMC,mBAAmB,GAAInC,0BAA0B,CAACtD,aAAa,CAAC,CAAC4E,QAAQ,EAAE;MACjF,IAAMc,SAAS,GAAGC,SAAS,EAAE;MAC7B,IAAMC,eAAe,GAAGtC,0BAA0B,CAACoC,SAAS,CAAC,CAACd,QAAQ,EAAE;MACxE,IAAMiB,iBAAiB,GAAGvC,0BAA0B,CAAClD,WAAW,CAAC,CAACwE,QAAQ,EAAE;MAE5ElC,OAAO,CAACC,GAAG,CAAC;QAAC8C,mBAAmB,EAAnBA;OAAoB,CAAC;MAElC,IAAMK,cAAc,GAAYjB,qBAAqB,CAAC;QAAEE,YAAY,EAAE3E,WAAW;QAAE4E,aAAa,EAAEU;OAAW,CAAC;MAE9G,IAAI,CAACI,cAAc,EAAE;;QAInBC,YAAY,CAAC;UAAEnE,SAAS,EAAAZ,QAAA,KACnBhB,aAAa,EACbI,WAAW;SACd,CAAC;QACH;;;MAGF,IAAM4F,sBAAsB,GAAGnB,qBAAqB,CAAC;QAAEE,YAAY,EAAEc,iBAAiB;QAAEb,aAAa,EAAEhF;OAAe,CAAC;MAEvH,IAAIsF,iBAAiB,CAACxD,MAAM,GAAG,CAAC,IAAIkE,sBAAsB,EAAE;QAC1D,IAAIP,mBAAmB,KAAKG,eAAe,EAAE,OAAM;QACnDG,YAAY,CAAC;UAAEnE,SAAS,EAAE5B;SAAe,CAAC;;;IAI9CwF,oBAAoB,EAAE;;GAGvB,EAAE,EAAE,CAAC;;;;;;EAON,IAAMS,mBAAmB,GAAG,SAAtBA,mBAAmBA,CAAI1B,KAAa,EAAE/C,GAAW;;IAErD,IAAI,OAAOV,iBAAiB,CAACU,GAAG,CAAC,KAAK,QAAQ,EAAE;MAC9C,OAAO0E,QAAQ,CAAC3B,KAAK,CAAC;KACvB,MAAM,IAAI,OAAOzD,iBAAiB,CAACU,GAAG,CAAC,KAAK,SAAS,EAAE;MACtD,OAAO+C,KAAK,KAAK,MAAM;KACxB,MAAM,IAAIrD,KAAK,CAACO,OAAO,CAACX,iBAAiB,CAACU,GAAG,CAAC,CAAC,EAAE;;MAGhD,IAAItB,kBAAkB,KAAK,KAAK,EAAE;QAChC,OAAOO,YAAY,CAACgC,MAAM,CAACjB,GAAG,CAAC,CAACwC,IAAI,CAAC,EAAE,CAAC,CAAC7B,KAAK,CAAC,GAAG,CAAC;OACpD,MAAM,IAAIjC,kBAAkB,KAAK,QAAQ,EAAE;QAE1CwC,OAAO,CAACC,GAAG,CAAC;UAACwD,aAAa,EAAE1F,YAAY,CAACgC,MAAM,CAACjB,GAAG;SAAE,CAAC;QACtD,OAAOf,YAAY,CAACgC,MAAM,CAACjB,GAAG,CAAC;OAChC,MAAM,IAAItB,kBAAkB,KAAK,UAAU,EAAE;QAC5C,OAAOO,YAAY,CAACgC,MAAM,CAAIjB,GAAG,OAAI,CAAC;;;;IAM1C,OAAO+C,KAAK;GACb;;;;;EAMC,IAAM6B,YAAY,GAAG,SAAfA,YAAYA,CAAI5E,GAAW,EAAEkE,SAAkC;IACnE,IAAMW,UAAU,GAAGnF,KAAK,CAACO,OAAO,CAACX,iBAAiB,CAACU,GAAG,CAAC,CAAC;IACxD,IAAI6E,UAAU,EAAE;MAAA,IAAAC,sBAAA;MAEd,IAAIpG,kBAAkB,KAAK,UAAU,EAAE;QAAA,IAAAqG,qBAAA;QAErC,IAAMC,QAAQ,GAAG/F,YAAY,CAACgC,MAAM,CAAIjB,GAAG,OAAI,CAAC;QAChD,IAAMiF,iBAAiB,GAAGnD,0BAA0B,EAAAiD,qBAAA,OAAAA,qBAAA,CAAI/E,GAAG,IAAGgF,QAAQ,EAAAD,qBAAA,EAAG,CAAC3B,QAAQ,EAAE;;QAEpF,IAAM8B,aAAa,GAAGC,kBAAkB,CAACF,iBAAiB,CAAC;QAC3D,OAAOC,aAAa;OACrB,MAAM,IAAIxG,kBAAkB,KAAK,KAAK,EAAE;QAAA,IAAA0G,sBAAA;QACvC,IAAM9C,WAAU,GAAGrD,YAAY,CAACgC,MAAM,CAACjB,GAAG,CAAC;QAC3C,IAAMiF,kBAAiB,GAAGnD,0BAA0B,EAAAsD,sBAAA,OAAAA,sBAAA,CAAIpF,GAAG,IAAGsC,WAAU,EAAA8C,sBAAA,EAAG,CAAChC,QAAQ,EAAE;QACtF,IAAM8B,cAAa,GAAGC,kBAAkB,CAACF,kBAAiB,CAAC;QAC3D,OAAOC,cAAa;;MAEtB,IAAM5C,UAAU,GAAGrD,YAAY,CAACgC,MAAM,CAACjB,GAAG,CAAC;MAC3C,IAAMqF,YAAY,GAAGvD,0BAA0B,EAAAgD,sBAAA,OAAAA,sBAAA,CAAI9E,GAAG,IAAGsC,UAAU,EAAAwC,sBAAA,EAAG,CAAC1B,QAAQ,EAAE;MACjF,OAAOiC,YAAY;KACpB,MAAM;MAEL,OAAOnB,SAAS,CAAClE,GAAG,CAAW;;GAEjC;EACD,IAAMsF,YAAY,GAAG,SAAfA,YAAYA,CAAIrG,YAA6B;IAClD,IAAMsG,SAAS,GAAsC,EAAE;;IAEvD,SAAAC,UAAA,GAAA7C,+BAAA,CAA2B1D,YAAY,CAACyE,OAAO,EAAE,GAAA+B,MAAA,IAAAA,MAAA,GAAAD,UAAA,IAAA3C,IAAA,GAAE;MAAA,IAAA6C,YAAA,GAAAD,MAAA,CAAA1C,KAAA;QAAvC/C,GAAG,GAAA0F,YAAA;QAAE3C,KAAK,GAAA2C,YAAA;MACpB,IAAI1F,GAAG,CAAC2F,QAAQ,CAAC,IAAI,CAAC,EAAE;QACtB,IAAMC,OAAO,GAAG5F,GAAG,CAAC6F,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QACrC,IAAIN,SAAS,CAACK,OAAO,CAAC,EAAE;UACrBL,SAAS,CAACK,OAAO,CAAc,CAACE,IAAI,CAAC/C,KAAK,CAAC;SAC7C,MAAM;UACLwC,SAAS,CAACK,OAAO,CAAC,GAAG,CAAC7C,KAAK,CAAC;;OAE/B,MAAM;;QAEL,IAAIwC,SAAS,CAACvF,GAAG,CAAC,EAAE;UAClB,IAAIN,KAAK,CAACO,OAAO,CAACsF,SAAS,CAACvF,GAAG,CAAC,CAAC,EAAE;YAChCuF,SAAS,CAACvF,GAAG,CAAc,CAAC8F,IAAI,CAAC/C,KAAK,CAAC;WACzC,MAAM;YACLwC,SAAS,CAACvF,GAAG,CAAC,GAAG,CAACuF,SAAS,CAACvF,GAAG,CAAW,EAAE+C,KAAK,CAAC;;SAErD,MAAM;UACLwC,SAAS,CAACvF,GAAG,CAAC,GAAG+C,KAAK;;;;IAI5B,OAAOwC,SAAS;GAChB;;EAEF,IAAMQ,kBAAkB,GAA4BxG,OAAO,CAAC;IAE1D,OAAOb,kBAAkB,KAAK,UAAU,GAAG4G,YAAY,CAACrG,YAAY,CAAC,GAAGW,MAAM,CAACoG,WAAW,CAAC/G,YAAY,CAACyE,OAAO,EAAE,CAAC;GACnH,EAAE,CAACzE,YAAY,EAAEP,kBAAkB,CAAC,CAAC;EAEtC,IAAMyF,SAAS,GAAG,SAAZA,SAASA,CAAA8B,KAAA;mCAAyB,EAAE,GAAAA,KAAA;MAAAC,aAAA,GAAAC,KAAA,CAArBC,OAAO;MAAPA,OAAO,GAAAF,aAAA,cAAG,IAAI,GAAAA,aAAA;;IAGjC,IAAMnE,MAAM,GAAGnC,MAAM,CAACC,IAAI,CAACkG,kBAAkB,CAAC,CAACM,MAAM,CAAC,UAACC,GAAG,EAAEtG,GAAG;MAC7D,IAAIJ,MAAM,CAAC2G,SAAS,CAACC,cAAc,CAACC,IAAI,CAACnH,iBAAiB,EAAEU,GAAG,CAAC,EAAE;QAChE,IAAM0G,OAAO,GAAGhI,kBAAkB,KAAK,UAAU,GAAGsB,GAAG,CAAC6F,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG7F,GAAG;;QAE/EsG,GAAG,CAACI,OAAO,CAAC,GAAGN,OAAO,KAAK,IAAI,GAC3B3B,mBAAmB,CAACsB,kBAAkB,CAAC/F,GAAG,CAAW,EAAEA,GAAG,CAAC,GAC1D4E,YAAY,CAAC5E,GAAG,EAAE+F,kBAAkB,CAAC;;MAE5C,OAAOO,GAAG;KACX,EAAE,EAAE,CAAC;IAEN,OAAOvE,MAA2B;GACnC;EAIH,IAAM4E,QAAQ,GAAG,SAAXA,QAAQA,CAAuB3G,GAAS,EAAE4G,OAAwB;IAEtE,IAAMC,MAAM,GAAGC,MAAM,CAAC9G,GAAG,CAAC;;IAE1B,IAAM+C,KAAK,GAAG,CAAA6D,OAAO,oBAAPA,OAAO,CAAER,OAAO,MAAK,IAAI,GAAG3B,mBAAmB,CAACxF,YAAY,CAACyB,GAAG,CAACmG,MAAM,CAAC,EAAEA,MAAM,CAAC,GAAGjC,YAAY,CAACiC,MAAM,EAAGd,kBAAkB,CAAC;IAC3I,OAAOhD,KAAqB;GAC7B;EAID,IAAMgE,0BAA0B,GAAG,SAA7BA,0BAA0BA,CAAI3G,SAA8C,EAAE4G,UAAmC;;IAErH,IAAMjF,MAAM,GAAGoC,SAAS,EAAE;;;IAG1B,IAAM8C,qBAAqB,GAAGrH,MAAM,CAAC8D,OAAO,CAACtD,SAAS,CAAC,CAACL,MAAM,CAAC,UAAAmH,KAAA;MAAA,IAAElH,GAAG,GAAAkH,KAAA;MAAA,OAAO,CAACxH,KAAK,CAACO,OAAO,CAACX,iBAAiB,CAACU,GAAG,CAAC,CAAC;MAAC;IAClH,IAAMmH,MAAM,GAAGvH,MAAM,CAACwH,MAAM,CAAA5H,QAAA,KACvBuC,MAAM,EACNnC,MAAM,CAACoG,WAAW,CAACiB,qBAAqB,CAAC,EACzCrI,WAAW,CACf,CAAC;IACF,IAAMyI,cAAc,GAA2BzH,MAAM,CAACC,IAAI,CAACsH,MAAM,CAAC,CAACd,MAAM,CAAC,UAACC,GAAG,EAAEtG,GAAG;;MAEjF,IAAIJ,MAAM,CAAC2G,SAAS,CAACC,cAAc,CAACC,IAAI,CAACO,UAAU,EAAEhH,GAAG,CAAC,IAAIgH,UAAU,CAAChH,GAAG,CAAC,KAAK,KAAK,EAAE;QACtF,OAAOsG,GAAG;;OAEX,MAAM,IAAI,CAAC,CAACa,MAAM,CAACnH,GAAG,CAAC,KAAK,KAAK,IAAI,CAAClB,kBAAkB,CAAC4C,QAAQ,CAACyF,MAAM,CAACnH,GAAG,CAAC,CAAC,EAAE;;QAE/EsG,GAAG,CAACtG,GAAG,CAAC,GAAGmH,MAAM,CAACnH,GAAG,CAAC;;MAGxB,OAAOsG,GAAG;KACX,EAAE,EAAE,CAAC;IAEN,OAAA9G,QAAA,KACKrB,SAAS,EACTkJ,cAAc;GAEpB;;EAED,IAAMC,cAAc,GAAG,SAAjBA,cAAcA,CAAID,cAAc;;;IAGpC,IAAME,aAAa,GAAG9H,WAAW,CAAC4G,MAAM,CAAC,UAACC,GAAG,EAAEtG,GAAG;MAChD,IAAIJ,MAAM,CAAC2G,SAAS,CAACC,cAAc,CAACC,IAAI,CAACY,cAAc,EAAErH,GAAG,CAAC,EAAE;;QAE7DsG,GAAG,CAACtG,GAAG,CAAC,GAAGqH,cAAc,CAACrH,GAAG,CAAC;;MAGhC,OAAOsG,GAAG;KACX,EAAE,EAAE,CAAC;IACN,OAAOiB,aAAa;GACrB;EAED,IAAMC,mBAAmB,GAAG,SAAtBA,mBAAmBA;;IAEvB,IAAMC,kBAAkB,GAAY3H,UAAU,CAACQ,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,KAAK;IACxE,IAAMoH,eAAe,GAA6BvD,SAAS,CAAC;MAAEiC,OAAO,EAAEqB;KAAoB,CAAC;IAE5F,IAAME,cAAc,GAA4B/H,MAAM,CAACC,IAAI,CAAC6H,eAAe,CAAC,CAACrB,MAAM,CACjF,UAACC,GAAG,EAAEtG,GAAG;MACP,IAAIJ,MAAM,CAAC2G,SAAS,CAACC,cAAc,CAACC,IAAI,CAACtI,SAAS,EAAE6B,GAAG,CAAC,EAAE;;QAExDsG,GAAG,CAACtG,GAAG,CAAC,GAAG0H,eAAe,CAAC1H,GAAG,CAAC;;MAEjC,OAAOsG,GAAG;KACX,EACD,EAAE,CACH;IAED,OAAOqB,cAAc;GACtB;EAED,IAAMC,WAAW,GAAG,SAAdA,WAAWA,CAAAC,MAAA;oCAAqC,EAAE,GAAAA,MAAA;MAAAC,qBAAA,GAAAC,KAAA,CAAjCC,mBAAmB;MAAnBA,mBAAmB,GAAAF,qBAAA,cAAG,IAAI,GAAAA,qBAAA;;IAE/C,IAAMG,iBAAiB,GAAGnG,0BAA0B,CAAAtC,QAAA,KAE7CrB,SAAS,EAEP6J,mBAAmB,IAAAxI,QAAA,KACnBgI,mBAAmB,EAAE,CACzB,EACE5I,WAAW,CACf,CACF;IACDM,eAAe,CAAC+I,iBAAiB,CAAC;GACnC;EAMD,IAAM1D,YAAY,GAAG,SAAfA,YAAYA,CAAA2D,MAAA;oCAAqE,EAAE,GAAAA,MAAA;MAAAC,eAAA,GAAAC,KAAA,CAAjEhI,SAAS;MAATA,SAAS,GAAA+H,eAAA,cAAG,EAAe,GAAAA,eAAA;MAAAE,gBAAA,GAAAD,KAAA,CAAEpB,UAAU;MAAVA,UAAU,GAAAqB,gBAAA,cAAG,EAAgB,GAAAA,gBAAA;IAEhF,IACEzI,MAAM,CAACC,IAAI,CAACO,SAAS,CAAC,CAACE,MAAM,KAAK,CAAC,IACnCV,MAAM,CAACC,IAAI,CAACmH,UAAU,CAAC,CAAC1G,MAAM,KAAK,CAAC,EACpC;MACAsH,WAAW,EAAE;MACb;;;IAGF,IAAMU,gBAAgB,GAAGvB,0BAA0B,CAAC3G,SAAS,EAAE4G,UAAU,CAAC;IAE1E,IAAMuB,oBAAoB,GAAGrI,iBAAiB,CAACoI,gBAAgB,EAAElI,SAAS,CAAC;IAE3E,IAAMoI,YAAY,GAAGlB,cAAc,CAACiB,oBAAoB,CAAC;IAEzDrJ,eAAe,CAAC4C,0BAA0B,CAAC0G,YAAY,CAAC,CAAC;GAE1D;;EAGC,IAAMC,QAAQ,GAAGC,WAAW,CAAE,UAACC,SAAe,EAAEC,SAA4B;IAC1E,IAAMC,YAAY,GAAG/B,MAAM,CAAC6B,SAAS,CAAC;;IAEtCxJ,gBAAgB,CAAC2J,OAAO,CAACD,YAAY,CAAC,GAAGD,SAAS;GACnD,EAAE,EAAE,CAAC;;EAGN/E,SAAS,CAAC;IAER,SAAAkF,GAAA,MAAAC,eAAA,GAA2BpJ,MAAM,CAAC8D,OAAO,CAACvE,gBAAgB,CAAC2J,OAAO,CAAC,EAAAC,GAAA,GAAAC,eAAA,CAAA1I,MAAA,EAAAyI,GAAA,IAAE;MAAA,IAAAE,qBAAA,EAAAC,qBAAA;MAAhE,IAAAC,kBAAA,GAAAH,eAAA,CAAAD,GAAA;QAAO/I,GAAG,GAAAmJ,kBAAA;QAAEpG,KAAK,GAAAoG,kBAAA;MAEpB,IAAMC,QAAQ,IAAAH,qBAAA,GAAGlD,kBAAkB,CAAC/F,GAAG,CAAC,YAAAiJ,qBAAA,GAAI,IAAI;MAChD,IAAMI,QAAQ,IAAAH,qBAAA,GAAG7J,iBAAiB,CAACyJ,OAAO,CAAC9I,GAAG,CAAC,YAAAkJ,qBAAA,GAAI,IAAI;MACvD,IAAIE,QAAQ,KAAKC,QAAQ,EAAE;QAEzB,SAAAC,UAAA,GAAA3G,+BAAA,CAAuBI,KAAK,GAAAwG,MAAA,IAAAA,MAAA,GAAAD,UAAA,IAAAzG,IAAA,GAAE;UAAA,IAAnB2G,QAAQ,GAAAD,MAAA,CAAAxG,KAAA;UACjB7B,OAAO,CAACC,GAAG,CAAC4B,KAAK,CAAC;UAElByG,QAAQ,EAAE;;;;MAKdnK,iBAAiB,CAACyJ,OAAO,CAAC9I,GAAG,CAAC,GAAGoJ,QAAQ;;GAI5C,EAAE,CAACrD,kBAAkB,CAAC,CAAC;EAC1B,OAAO;IACL9G,YAAY,EAAZA,YAAY;IACZsF,YAAY,EAAZA,YAAY;IACZqD,WAAW,EAAXA,WAAW;IACXzD,SAAS,EAATA,SAAS;IACTwC,QAAQ,EAARA,QAAQ;IACR8B,QAAQ,EAARA;GACD;AACH;;;;"}

package/dist/useMagicSearchParams.d.ts CHANGED Viewed

@@ -10,7 +10,7 @@ declare type MergeParams<M, O> = {
 /**
  * Interface for the configuration object that the hook receives
  */
-interface UseMagicSearchParamsOptions<M extends Record<string, unknown>, O extends Record<string, unknown>> {
+export interface UseMagicSearchParamsOptions<M extends Record<string, unknown>, O extends Record<string, unknown>> {
     mandatory: M;
     optional?: O;
     defaultParams?: Partial<MergeParams<M, O>>;

package/package.json CHANGED Viewed

@@ -8,7 +8,7 @@
     "typescript",
     "autocomplete"
   ],
-  "version": "0.2.0",
+  "version": "0.3.0",
   "license": "MIT",
   "main": "dist/index.js",
   "typings": "dist/index.d.ts",
@@ -73,7 +73,8 @@
   "exports": {
     ".": {
       "import": "./dist/react-magic-search-params.esm.js",
-      "require": "./dist/react-magic-search-params.cjs.production.min.js"
+      "require": "./dist/react-magic-search-params.cjs.production.min.js",
+      "types": "./dist/index.d.ts"
     }
   }
 }

package/src/index.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export { useMagicSearchParams } from "./useMagicSearchParams";
2	+ export type { UseMagicSearchParamsOptions } from "./useMagicSearchParams";

package/src/useMagicSearchParams.ts CHANGED Viewed

@@ -20,7 +20,7 @@ type MergeParams<M, O> = {
 /**
  * Interface for the configuration object that the hook receives
  */
-interface UseMagicSearchParamsOptions<
+export interface UseMagicSearchParamsOptions<
   M extends Record<string, unknown>,
   O extends Record<string, unknown>
 > {