@buildinams/core 0.3.0 → 0.3.1

package/dist/{chunk-IAAQVL6M.js → chunk-5KDGGGVO.js}

@@ -29,11 +29,12 @@ var hrefSchema = createStringSchema({
     };
   },
   stringify: (state) => {
+    if (!state.searchParams) return state.pathname;
     const paramsString = state.searchParams.toString();
     return state.pathname + (paramsString ? `?${paramsString}` : "");
   }
 });
 
 export { createSchema, createStringSchema, hrefSchema };
-//# sourceMappingURL=chunk-IAAQVL6M.js.map
-//# sourceMappingURL=chunk-IAAQVL6M.js.map
+//# sourceMappingURL=chunk-5KDGGGVO.js.map
+//# sourceMappingURL=chunk-5KDGGGVO.js.map

package/dist/chunk-5KDGGGVO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schema/schema.ts","../src/schema/string-schema.ts","../src/schema/href-schema.ts"],"names":[],"mappings":";AAkGO,IAAM,YAAA,GAAe,CAK3B,QAAA,MACmD;AAAA,EACnD,GAAG,QAAA;AAAA,EAEH,YAAA,EAAc,CAAC,KAAA,EAAO,IAAA,KAAS;AAC9B,IAAA,OAAO,SAAS,SAAA,CAAU,IAAA,CAAK,SAAS,KAAA,CAAM,KAAK,CAAC,CAAC,CAAA;AAAA,EACtD;AACD,CAAA;;;AC9FO,IAAM,kBAAA,GAAqB,CACjC,QAAA,KAC4C;AAC5C,EAAA,MAAM,SAAS,YAAA,CAA+C;AAAA,IAC7D,WAAW,QAAA,CAAS,SAAA;AAAA,IACpB,OAAO,QAAA,CAAS;AAAA,GAChB,CAAA;AAED,EAAA,OAAO;AAAA,IACN,OAAO,MAAA,CAAO,KAAA;AAAA,IACd,WAAW,MAAA,CAAO,SAAA;AAAA,IAClB,gBAAgB,MAAA,CAAO;AAAA,GACxB;AACD;;;ACKO,IAAM,aAAa,kBAAA,CASxB;AAAA,EACD,KAAA,EAAO,CAAC,IAAA,KAAS;AAChB,IAAA,MAAM,CAAC,WAAW,EAAA,EAAI,MAAA,GAAS,EAAE,CAAA,GAAI,IAAA,CAAK,MAAM,GAAG,CAAA;AACnD,IAAA,OAAO;AAAA,MACN,QAAA;AAAA,MACA,YAAA,EAAc,IAAI,eAAA,CAAgB,MAAM;AAAA,KACzC;AAAA,EACD,CAAA;AAAA,EACA,SAAA,EAAW,CAAC,KAAA,KAAU;AACrB,IAAA,IAAI,CAAC,KAAA,CAAM,YAAA,EAAc,OAAO,KAAA,CAAM,QAAA;AACtC,IAAA,MAAM,YAAA,GAAe,KAAA,CAAM,YAAA,CAAa,QAAA,EAAS;AACjD,IAAA,OAAO,KAAA,CAAM,QAAA,IAAY,YAAA,GAAe,CAAA,CAAA,EAAI,YAAY,CAAA,CAAA,GAAK,EAAA,CAAA;AAAA,EAC9D;AACD,CAAC","file":"chunk-5KDGGGVO.js","sourcesContent":["/**\n * Defines the schema for parsing and stringifying states to and from primitive values.\n *\n * The `Schema` type is a generic type that takes:\n * - `State`: A state object type.\n * - `Serialized`: The raw value type\n * - `SerializableState?`: (optional) A (partial) state object type that can be used for serialization. Defaults to `State` if not provided.\n *\n * It returns the following methods:\n * - `parse`: A function that takes a raw value and returns the corresponding state object.\n * - `serialize`: A function that takes a (serializable) state object and returns a raw value that represents the given state.\n * - `parserialize`: A function that takes a raw value and a reducer function - it returns a new raw value that represents the reduced state.\n *\n * @see createSchema for a helper function to create a `Schema` from simpler parsing and serializing functions.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type Schema<State = any, Serialized = any, SerializableState = State> = {\n\t/** Parse a raw value into the state shape */\n\tparse: (value: Serialized) => State;\n\t/** Serialize a state shape into a raw value */\n\tserialize: (state: SerializableState) => Serialized;\n\n\t/** Compute a new serialized value based on a given serialized value and a reducer of the current state. */\n\tparserialize: (\n\t\tvalue: Serialized,\n\t\tnext: (state: State) => SerializableState,\n\t) => Serialized;\n};\n\n/**\n * A utility type to extract the state shape from a given `Schema`.\n */\nexport type SchemaState<T extends Schema> =\n\tT extends Schema<infer U> ? U : never;\n\n/**\n * A utility type to extract the serialized value type from a given `Schema`.\n */\nexport type SchemaSerialized<T extends Schema> =\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\tT extends Schema<any, infer U> ? U : never;\n\n/**\n * A utility type to extract the serializable state shape from a given `Schema`.\n */\nexport type SchemaSerializableState<T extends Schema> =\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\tT extends Schema<any, any, infer U> ? U : never;\n\n/**\n * Low-level helper function to create a basic `Schema` that receives the config for converting between serialized values and state objects.\n *\n * The template requires two methods:\n * - `parse`: A method that takes a serialized value and returns the corresponding state object.\n * - `serialize`: A method that takes a state object and returns a serialized value that represents the given state.\n *\n * The `parserialize` method is automatically implemented based on the provided `parse` and `serialize` methods, allowing you to compute a new serialized value based on an existing serialized value and a reducer function for the state.\n *\n * @example\n * ```ts\n * import { createSchema } from \"@buildinams/core/schema\";\n *\n * const numberSchema = createSchema<\n *   number, // State\n *   string // Serialized\n * >({\n *   parse: (value) => parseInt(value, 10),\n *   serialize: (state) => state.toString(),\n * });\n *\n * const result = numberSchema.parserialize(\"42\", (state) => state + 1);\n * console.log(result); // \"43\"\n * ```\n *\n * @example\n * ```ts\n * import { createSchema } from \"@buildinams/core/schema\";\n *\n * const hrefSchema: createSchema<\n *   { pathname: string, searchParams: URLSearchParams },\n *   string,\n *   { pathname: string, searchParams?: URLSearchParams } // SerializableState allows to define different state used for serialization, in this case making searchParams optional to allow for more flexible stringification logic\n * >({\n *  parse: (href) => {\n *    const [pathname = \"\", search = \"\"] = href.split(\"?\");\n *    return {\n *     pathname,\n *     searchParams: new URLSearchParams(search),\n *    };\n *  },\n *  serialize: (serializableState) => {\n *    if (!serializableState.searchParams) return serializableState.pathname;\n *    const paramsString = serializableState.searchParams.toString();\n *    return serializableState.pathname + (paramsString ? `?${paramsString}` : \"\");\n *  },\n * })\n * ```\n */\nexport const createSchema = <\n\tState = never,\n\tSerialized = never,\n\tSerializableState = State,\n>(\n\ttemplate: Omit<Schema<State, Serialized, SerializableState>, \"parserialize\">,\n): Schema<State, Serialized, SerializableState> => ({\n\t...template,\n\n\tparserialize: (value, next) => {\n\t\treturn template.serialize(next(template.parse(value)));\n\t},\n});\n","import type { Schema } from \"./schema\";\nimport { createSchema } from \"./schema\";\n\nexport type StringSchema<State = never, SerializableState = State> = {\n\tparse: Schema<State, string, SerializableState>[\"parse\"];\n\tstringify: Schema<State, string, SerializableState>[\"serialize\"];\n\tparseStringify: Schema<State, string, SerializableState>[\"parserialize\"];\n};\n\n/**\n * Helper function to create a `StringSchema` which converts between strings and state objects.\n *\n * The template requires two functions:\n * - `parse`: A function that takes a string and returns the corresponding state object.\n * - `stringify`: A function that takes a state object and returns a string that represents the given state.\n */\nexport const createStringSchema = <State = never, SerializableState = State>(\n\ttemplate: Omit<StringSchema<State, SerializableState>, \"parseStringify\">,\n): StringSchema<State, SerializableState> => {\n\tconst schema = createSchema<State, string, SerializableState>({\n\t\tserialize: template.stringify,\n\t\tparse: template.parse,\n\t});\n\n\treturn {\n\t\tparse: schema.parse,\n\t\tstringify: schema.serialize,\n\t\tparseStringify: schema.parserialize,\n\t};\n};\n","import { createStringSchema } from \"./string-schema\";\n\n/**\n * Utility schema for parsing and stringifying href strings into structured state objects that include the pathname and URL search parameters.\n *\n *  @example\n * ```ts\n * import { createSchema, hrefSchema } from \"@buildinams/core/schema\";\n *\n * const myHrefSchema = createSchema<{\n *  page: number,\n *  // Used to compute next href - don't use directly. Use `.stringify()` instead\n *  _href: string\n * }>({\n *   parse: (href) => {\n *    const { searchParams } = hrefSchema.parse(href);\n *    return {\n *     page: parseInt(searchParams.get(\"page\") || \"1\", 10),\n *     _href: href,\n *    }\n *   },\n *   serialize: (state) => {\n *    const { pathname, searchParams } = hrefSchema.parse(state._href);\n *    searchParams.delete(\"page\");\n *    if (state.page > 1) {\n *     searchParams.set(\"page\", state.page.toString());\n *    }\n *\n *    // note that `searchParams` are optional for serialization\n *    return hrefSchema.stringify({ pathname, searchParams });\n *   }\n * });\n * ```\n */\nexport const hrefSchema = createStringSchema<\n\t{\n\t\tpathname: string;\n\t\tsearchParams: URLSearchParams;\n\t},\n\t{\n\t\tpathname: string;\n\t\tsearchParams?: URLSearchParams;\n\t}\n>({\n\tparse: (href) => {\n\t\tconst [pathname = \"\", search = \"\"] = href.split(\"?\");\n\t\treturn {\n\t\t\tpathname,\n\t\t\tsearchParams: new URLSearchParams(search),\n\t\t};\n\t},\n\tstringify: (state) => {\n\t\tif (!state.searchParams) return state.pathname;\n\t\tconst paramsString = state.searchParams.toString();\n\t\treturn state.pathname + (paramsString ? `?${paramsString}` : \"\");\n\t},\n});\n"]}

package/dist/navigation/index.d.ts

@@ -1,4 +1,4 @@
-import { S as Schema } from '../schema-iy92gbTC.js';
+import { S as Schema } from '../schema-CfQvhbuU.js';
 
 /** @deprecated use `Schema` directly */
 type HrefSchema<State = never> = {

package/dist/navigation/index.js

@@ -1,4 +1,4 @@
-import { createStringSchema } from '../chunk-IAAQVL6M.js';
+import { createStringSchema } from '../chunk-5KDGGGVO.js';
 
 // src/navigation/href-schema.ts
 var hrefToUrl = (href) => new URL(href, "http://localhost");

package/dist/schema/index.d.ts

@@ -1,10 +1,10 @@
-import { S as Schema } from '../schema-iy92gbTC.js';
-export { b as SchemaSerialized, a as SchemaState, c as createSchema } from '../schema-iy92gbTC.js';
+import { S as Schema } from '../schema-CfQvhbuU.js';
+export { c as SchemaSerializableState, b as SchemaSerialized, a as SchemaState, d as createSchema } from '../schema-CfQvhbuU.js';
 
-type StringSchema<State = never> = {
-    parse: Schema<State, string>["parse"];
-    stringify: Schema<State, string>["serialize"];
-    parseStringify: Schema<State, string>["parserialize"];
+type StringSchema<State = never, SerializableState = State> = {
+    parse: Schema<State, string, SerializableState>["parse"];
+    stringify: Schema<State, string, SerializableState>["serialize"];
+    parseStringify: Schema<State, string, SerializableState>["parserialize"];
 };
 /**
  * Helper function to create a `StringSchema` which converts between strings and state objects.
@@ -13,7 +13,7 @@ type StringSchema<State = never> = {
  * - `parse`: A function that takes a string and returns the corresponding state object.
  * - `stringify`: A function that takes a state object and returns a string that represents the given state.
  */
-declare const createStringSchema: <S = never>(template: Omit<StringSchema<S>, "parseStringify">) => StringSchema<S>;
+declare const createStringSchema: <State = never, SerializableState = State>(template: Omit<StringSchema<State, SerializableState>, "parseStringify">) => StringSchema<State, SerializableState>;
 
 /**
  * Utility schema for parsing and stringifying href strings into structured state objects that include the pathname and URL search parameters.
@@ -30,7 +30,7 @@ declare const createStringSchema: <S = never>(template: Omit<StringSchema<S>, "p
  *   parse: (href) => {
  *    const { searchParams } = hrefSchema.parse(href);
  *    return {
- *     page: parseInt(searchParams.get("page"), 10) || 1,
+ *     page: parseInt(searchParams.get("page") || "1", 10),
  *     _href: href,
  *    }
  *   },
@@ -40,7 +40,9 @@ declare const createStringSchema: <S = never>(template: Omit<StringSchema<S>, "p
  *    if (state.page > 1) {
  *     searchParams.set("page", state.page.toString());
  *    }
- *    return hrefSchema.serialize({ pathname, searchParams });
+ *
+ *    // note that `searchParams` are optional for serialization
+ *    return hrefSchema.stringify({ pathname, searchParams });
  *   }
  * });
  * ```
@@ -48,6 +50,9 @@ declare const createStringSchema: <S = never>(template: Omit<StringSchema<S>, "p
 declare const hrefSchema: StringSchema<{
     pathname: string;
     searchParams: URLSearchParams;
+}, {
+    pathname: string;
+    searchParams?: URLSearchParams;
 }>;
 
 export { Schema, type StringSchema, createStringSchema, hrefSchema };

package/dist/schema/index.js

@@ -1,3 +1,3 @@
-export { createSchema, createStringSchema, hrefSchema } from '../chunk-IAAQVL6M.js';
+export { createSchema, createStringSchema, hrefSchema } from '../chunk-5KDGGGVO.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/schema-CfQvhbuU.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Defines the schema for parsing and stringifying states to and from primitive values.
+ *
+ * The `Schema` type is a generic type that takes:
+ * - `State`: A state object type.
+ * - `Serialized`: The raw value type
+ * - `SerializableState?`: (optional) A (partial) state object type that can be used for serialization. Defaults to `State` if not provided.
+ *
+ * It returns the following methods:
+ * - `parse`: A function that takes a raw value and returns the corresponding state object.
+ * - `serialize`: A function that takes a (serializable) state object and returns a raw value that represents the given state.
+ * - `parserialize`: A function that takes a raw value and a reducer function - it returns a new raw value that represents the reduced state.
+ *
+ * @see createSchema for a helper function to create a `Schema` from simpler parsing and serializing functions.
+ */
+type Schema<State = any, Serialized = any, SerializableState = State> = {
+    /** Parse a raw value into the state shape */
+    parse: (value: Serialized) => State;
+    /** Serialize a state shape into a raw value */
+    serialize: (state: SerializableState) => Serialized;
+    /** Compute a new serialized value based on a given serialized value and a reducer of the current state. */
+    parserialize: (value: Serialized, next: (state: State) => SerializableState) => Serialized;
+};
+/**
+ * A utility type to extract the state shape from a given `Schema`.
+ */
+type SchemaState<T extends Schema> = T extends Schema<infer U> ? U : never;
+/**
+ * A utility type to extract the serialized value type from a given `Schema`.
+ */
+type SchemaSerialized<T extends Schema> = T extends Schema<any, infer U> ? U : never;
+/**
+ * A utility type to extract the serializable state shape from a given `Schema`.
+ */
+type SchemaSerializableState<T extends Schema> = T extends Schema<any, any, infer U> ? U : never;
+/**
+ * Low-level helper function to create a basic `Schema` that receives the config for converting between serialized values and state objects.
+ *
+ * The template requires two methods:
+ * - `parse`: A method that takes a serialized value and returns the corresponding state object.
+ * - `serialize`: A method that takes a state object and returns a serialized value that represents the given state.
+ *
+ * The `parserialize` method is automatically implemented based on the provided `parse` and `serialize` methods, allowing you to compute a new serialized value based on an existing serialized value and a reducer function for the state.
+ *
+ * @example
+ * ```ts
+ * import { createSchema } from "@buildinams/core/schema";
+ *
+ * const numberSchema = createSchema<
+ *   number, // State
+ *   string // Serialized
+ * >({
+ *   parse: (value) => parseInt(value, 10),
+ *   serialize: (state) => state.toString(),
+ * });
+ *
+ * const result = numberSchema.parserialize("42", (state) => state + 1);
+ * console.log(result); // "43"
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { createSchema } from "@buildinams/core/schema";
+ *
+ * const hrefSchema: createSchema<
+ *   { pathname: string, searchParams: URLSearchParams },
+ *   string,
+ *   { pathname: string, searchParams?: URLSearchParams } // SerializableState allows to define different state used for serialization, in this case making searchParams optional to allow for more flexible stringification logic
+ * >({
+ *  parse: (href) => {
+ *    const [pathname = "", search = ""] = href.split("?");
+ *    return {
+ *     pathname,
+ *     searchParams: new URLSearchParams(search),
+ *    };
+ *  },
+ *  serialize: (serializableState) => {
+ *    if (!serializableState.searchParams) return serializableState.pathname;
+ *    const paramsString = serializableState.searchParams.toString();
+ *    return serializableState.pathname + (paramsString ? `?${paramsString}` : "");
+ *  },
+ * })
+ * ```
+ */
+declare const createSchema: <State = never, Serialized = never, SerializableState = State>(template: Omit<Schema<State, Serialized, SerializableState>, "parserialize">) => Schema<State, Serialized, SerializableState>;
+
+export { type Schema as S, type SchemaState as a, type SchemaSerialized as b, type SchemaSerializableState as c, createSchema as d };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@buildinams/core",
-	"version": "0.3.0",
+	"version": "0.3.1",
 	"type": "module",
 	"author": "Build in Amsterdam <development@buildinamsterdam.com> (https://www.buildinamsterdam.com/)",
 	"repository": {
@@ -59,7 +59,7 @@
 		"README.md"
 	],
 	"publishConfig": {
-		"registry": "https://npm.pkg.github.com",
+		"registry": "https://registry.npmjs.org",
 		"access": "public"
 	},
 	"devDependencies": {

package/dist/chunk-IAAQVL6M.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/schema/schema.ts","../src/schema/string-schema.ts","../src/schema/href-schema.ts"],"names":[],"mappings":";AA4CO,IAAM,YAAA,GAAe,CAC3B,QAAA,MACmB;AAAA,EACnB,GAAG,QAAA;AAAA,EAEH,YAAA,EAAc,CAAC,KAAA,EAAO,IAAA,KAAS;AAC9B,IAAA,OAAO,SAAS,SAAA,CAAU,IAAA,CAAK,SAAS,KAAA,CAAM,KAAK,CAAC,CAAC,CAAA;AAAA,EACtD;AACD,CAAA;;;ACpCO,IAAM,kBAAA,GAAqB,CACjC,QAAA,KACqB;AACrB,EAAA,MAAM,SAAS,YAAA,CAAwB;AAAA,IACtC,WAAW,QAAA,CAAS,SAAA;AAAA,IACpB,OAAO,QAAA,CAAS;AAAA,GAChB,CAAA;AAED,EAAA,OAAO;AAAA,IACN,OAAO,MAAA,CAAO,KAAA;AAAA,IACd,WAAW,MAAA,CAAO,SAAA;AAAA,IAClB,gBAAgB,MAAA,CAAO;AAAA,GACxB;AACD;;;ACGO,IAAM,aAAa,kBAAA,CAGvB;AAAA,EACF,KAAA,EAAO,CAAC,IAAA,KAAS;AAChB,IAAA,MAAM,CAAC,WAAW,EAAA,EAAI,MAAA,GAAS,EAAE,CAAA,GAAI,IAAA,CAAK,MAAM,GAAG,CAAA;AACnD,IAAA,OAAO;AAAA,MACN,QAAA;AAAA,MACA,YAAA,EAAc,IAAI,eAAA,CAAgB,MAAM;AAAA,KACzC;AAAA,EACD,CAAA;AAAA,EACA,SAAA,EAAW,CAAC,KAAA,KAAU;AACrB,IAAA,MAAM,YAAA,GAAe,KAAA,CAAM,YAAA,CAAa,QAAA,EAAS;AACjD,IAAA,OAAO,KAAA,CAAM,QAAA,IAAY,YAAA,GAAe,CAAA,CAAA,EAAI,YAAY,CAAA,CAAA,GAAK,EAAA,CAAA;AAAA,EAC9D;AACD,CAAC","file":"chunk-IAAQVL6M.js","sourcesContent":["/**\n * Defines the schema for parsing and stringifying states to and from primitive values.\n *\n * The `Schema` type is a generic that takes a state shape and optional raw value type and declares three methods:\n *\n * - `parse`: A function that takes a raw value and returns the corresponding state object.\n * - `stringify`: A function that takes a state object and returns a raw value that represents the given state.\n * - `parseStringify`: A function that takes a raw value and a reducer function - it returns a new raw value that represents the reduced state.\n *\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type Schema<State = any, Serialized = any> = {\n\t/** Parse a raw value into the state shape */\n\tparse: (value: Serialized) => State;\n\t/** Serialize a state shape into a raw value */\n\tserialize: (state: State) => Serialized;\n\n\t/** Compute a new serialized value based on a given serialized value and a reducer of the current state. */\n\tparserialize: (\n\t\tvalue: Serialized,\n\t\tnext: (state: State) => State,\n\t) => Serialized;\n};\n\n/**\n * A utility type to extract the state shape from a given `Schema`.\n */\nexport type SchemaState<T extends Schema> =\n\tT extends Schema<infer U> ? U : never;\n\n/**\n * A utility type to extract the serialized value type from a given `Schema`.\n */\nexport type SchemaSerialized<T extends Schema> =\n\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\tT extends Schema<any, infer U> ? U : never;\n\n/**\n * Low-level helper function to create a basic `Schema` that receives the config for converting between serialized values and state objects.\n *\n * The template requires two functions:\n * - `parse`: A function that takes a serialized value and returns the corresponding state object.\n * - `serialize`: A function that takes a state object and returns a serialized value that represents the given state.\n */\nexport const createSchema = <S = never, R = never>(\n\ttemplate: Omit<Schema<S, R>, \"parserialize\">,\n): Schema<S, R> => ({\n\t...template,\n\n\tparserialize: (value, next) => {\n\t\treturn template.serialize(next(template.parse(value)));\n\t},\n});\n","import type { Schema } from \"./schema\";\nimport { createSchema } from \"./schema\";\n\nexport type StringSchema<State = never> = {\n\tparse: Schema<State, string>[\"parse\"];\n\tstringify: Schema<State, string>[\"serialize\"];\n\tparseStringify: Schema<State, string>[\"parserialize\"];\n};\n\n/**\n * Helper function to create a `StringSchema` which converts between strings and state objects.\n *\n * The template requires two functions:\n * - `parse`: A function that takes a string and returns the corresponding state object.\n * - `stringify`: A function that takes a state object and returns a string that represents the given state.\n */\nexport const createStringSchema = <S = never>(\n\ttemplate: Omit<StringSchema<S>, \"parseStringify\">,\n): StringSchema<S> => {\n\tconst schema = createSchema<S, string>({\n\t\tserialize: template.stringify,\n\t\tparse: template.parse,\n\t});\n\n\treturn {\n\t\tparse: schema.parse,\n\t\tstringify: schema.serialize,\n\t\tparseStringify: schema.parserialize,\n\t};\n};\n","import { createStringSchema } from \"./string-schema\";\n\n/**\n * Utility schema for parsing and stringifying href strings into structured state objects that include the pathname and URL search parameters.\n *\n *  @example\n * ```ts\n * import { createSchema, hrefSchema } from \"@buildinams/core/schema\";\n *\n * const myHrefSchema = createSchema<{\n *  page: number,\n *  // Used to compute next href - don't use directly. Use `.stringify()` instead\n *  _href: string\n * }>({\n *   parse: (href) => {\n *    const { searchParams } = hrefSchema.parse(href);\n *    return {\n *     page: parseInt(searchParams.get(\"page\"), 10) || 1,\n *     _href: href,\n *    }\n *   },\n *   serialize: (state) => {\n *    const { pathname, searchParams } = hrefSchema.parse(state._href);\n *    searchParams.delete(\"page\");\n *    if (state.page > 1) {\n *     searchParams.set(\"page\", state.page.toString());\n *    }\n *    return hrefSchema.serialize({ pathname, searchParams });\n *   }\n * });\n * ```\n */\nexport const hrefSchema = createStringSchema<{\n\tpathname: string;\n\tsearchParams: URLSearchParams;\n}>({\n\tparse: (href) => {\n\t\tconst [pathname = \"\", search = \"\"] = href.split(\"?\");\n\t\treturn {\n\t\t\tpathname,\n\t\t\tsearchParams: new URLSearchParams(search),\n\t\t};\n\t},\n\tstringify: (state) => {\n\t\tconst paramsString = state.searchParams.toString();\n\t\treturn state.pathname + (paramsString ? `?${paramsString}` : \"\");\n\t},\n});\n"]}

package/dist/schema-iy92gbTC.d.ts

@@ -1,36 +0,0 @@
-/**
- * Defines the schema for parsing and stringifying states to and from primitive values.
- *
- * The `Schema` type is a generic that takes a state shape and optional raw value type and declares three methods:
- *
- * - `parse`: A function that takes a raw value and returns the corresponding state object.
- * - `stringify`: A function that takes a state object and returns a raw value that represents the given state.
- * - `parseStringify`: A function that takes a raw value and a reducer function - it returns a new raw value that represents the reduced state.
- *
- */
-type Schema<State = any, Serialized = any> = {
-    /** Parse a raw value into the state shape */
-    parse: (value: Serialized) => State;
-    /** Serialize a state shape into a raw value */
-    serialize: (state: State) => Serialized;
-    /** Compute a new serialized value based on a given serialized value and a reducer of the current state. */
-    parserialize: (value: Serialized, next: (state: State) => State) => Serialized;
-};
-/**
- * A utility type to extract the state shape from a given `Schema`.
- */
-type SchemaState<T extends Schema> = T extends Schema<infer U> ? U : never;
-/**
- * A utility type to extract the serialized value type from a given `Schema`.
- */
-type SchemaSerialized<T extends Schema> = T extends Schema<any, infer U> ? U : never;
-/**
- * Low-level helper function to create a basic `Schema` that receives the config for converting between serialized values and state objects.
- *
- * The template requires two functions:
- * - `parse`: A function that takes a serialized value and returns the corresponding state object.
- * - `serialize`: A function that takes a state object and returns a serialized value that represents the given state.
- */
-declare const createSchema: <S = never, R = never>(template: Omit<Schema<S, R>, "parserialize">) => Schema<S, R>;
-
-export { type Schema as S, type SchemaState as a, type SchemaSerialized as b, createSchema as c };