@nakanoaas/notion-valibot-schema 0.0.4 → 0.0.5

package/dist/phone-number.d.mts

@@ -1,11 +1,70 @@
 import * as v from "valibot";
 
 //#region src/phone-number.d.ts
+
+/**
+ * Schema to extract the `phone_number` property from a Notion page property.
+ *
+ * **Input:**
+ * ```
+ * {
+ *   phone_number: string;
+ * }
+ * ```
+ *
+ * **Output:** `string`
+ *
+ * @example
+ * ```ts
+ * import * as v from "valibot";
+ * import { PhoneNumberSchema } from "@nakanoaas/notion-valibot-utils";
+ *
+ * const PageSchema = v.object({
+ *   id: v.string(),
+ *   properties: v.object({
+ *     Phone: PhoneNumberSchema,
+ *   }),
+ * });
+ *
+ * const page = await notion.pages.retrieve({ page_id: "..." });
+ * const parsed = v.parse(PageSchema, page);
+ * // parsed.properties.Phone: string
+ * ```
+ */
 declare const PhoneNumberSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
   readonly phone_number: v.StringSchema<undefined>;
 }, undefined>, v.TransformAction<{
   phone_number: string;
 }, string>]>;
+/**
+ * Schema to extract the `phone_number` property from a Notion page property or `null`.
+ *
+ * **Input:**
+ * ```
+ * {
+ *   phone_number: string | null;
+ * }
+ * ```
+ *
+ * **Output:** `string | null`
+ *
+ * @example
+ * ```ts
+ * import * as v from "valibot";
+ * import { NullablePhoneNumberSchema } from "@nakanoaas/notion-valibot-utils";
+ *
+ * const PageSchema = v.object({
+ *   id: v.string(),
+ *   properties: v.object({
+ *     Phone: NullablePhoneNumberSchema,
+ *   }),
+ * });
+ *
+ * const page = await notion.pages.retrieve({ page_id: "..." });
+ * const parsed = v.parse(PageSchema, page);
+ * // parsed.properties.Phone: string | null
+ * ```
+ */
 declare const NullablePhoneNumberSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
   readonly phone_number: v.NullableSchema<v.StringSchema<undefined>, undefined>;
 }, undefined>, v.TransformAction<{

package/dist/phone-number.mjs

@@ -1,7 +1,65 @@
 import * as v from "valibot";
 
 //#region src/phone-number.ts
+/**
+* Schema to extract the `phone_number` property from a Notion page property.
+*
+* **Input:**
+* ```
+* {
+*   phone_number: string;
+* }
+* ```
+*
+* **Output:** `string`
+*
+* @example
+* ```ts
+* import * as v from "valibot";
+* import { PhoneNumberSchema } from "@nakanoaas/notion-valibot-utils";
+*
+* const PageSchema = v.object({
+*   id: v.string(),
+*   properties: v.object({
+*     Phone: PhoneNumberSchema,
+*   }),
+* });
+*
+* const page = await notion.pages.retrieve({ page_id: "..." });
+* const parsed = v.parse(PageSchema, page);
+* // parsed.properties.Phone: string
+* ```
+*/
 const PhoneNumberSchema = v.pipe(v.object({ phone_number: v.string() }), v.transform((v$1) => v$1.phone_number));
+/**
+* Schema to extract the `phone_number` property from a Notion page property or `null`.
+*
+* **Input:**
+* ```
+* {
+*   phone_number: string | null;
+* }
+* ```
+*
+* **Output:** `string | null`
+*
+* @example
+* ```ts
+* import * as v from "valibot";
+* import { NullablePhoneNumberSchema } from "@nakanoaas/notion-valibot-utils";
+*
+* const PageSchema = v.object({
+*   id: v.string(),
+*   properties: v.object({
+*     Phone: NullablePhoneNumberSchema,
+*   }),
+* });
+*
+* const page = await notion.pages.retrieve({ page_id: "..." });
+* const parsed = v.parse(PageSchema, page);
+* // parsed.properties.Phone: string | null
+* ```
+*/
 const NullablePhoneNumberSchema = v.pipe(v.object({ phone_number: v.nullable(v.string()) }), v.transform((v$1) => v$1.phone_number));
 
 //#endregion

package/dist/phone-number.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"phone-number.mjs","names":["v"],"sources":["../src/phone-number.ts"],"sourcesContent":["import * as v from \"valibot\";\n\nexport const PhoneNumberSchema = v.pipe(\n\tv.object({\n\t\tphone_number: v.string(),\n\t}),\n\tv.transform((v) => v.phone_number),\n);\n\nexport const NullablePhoneNumberSchema = v.pipe(\n\tv.object({\n\t\tphone_number: v.nullable(v.string()),\n\t}),\n\tv.transform((v) => v.phone_number),\n);\n"],"mappings":";;;AAEA,MAAa,oBAAoB,EAAE,KAClC,EAAE,OAAO,EACR,cAAc,EAAE,QAAQ,EACxB,CAAC,EACF,EAAE,WAAW,QAAMA,IAAE,aAAa,CAClC;AAED,MAAa,4BAA4B,EAAE,KAC1C,EAAE,OAAO,EACR,cAAc,EAAE,SAAS,EAAE,QAAQ,CAAC,EACpC,CAAC,EACF,EAAE,WAAW,QAAMA,IAAE,aAAa,CAClC"}
+{"version":3,"file":"phone-number.mjs","names":["v"],"sources":["../src/phone-number.ts"],"sourcesContent":["import * as v from \"valibot\";\n\n/**\n * Schema to extract the `phone_number` property from a Notion page property.\n *\n * **Input:**\n * ```\n * {\n *   phone_number: string;\n * }\n * ```\n *\n * **Output:** `string`\n *\n * @example\n * ```ts\n * import * as v from \"valibot\";\n * import { PhoneNumberSchema } from \"@nakanoaas/notion-valibot-utils\";\n *\n * const PageSchema = v.object({\n *   id: v.string(),\n *   properties: v.object({\n *     Phone: PhoneNumberSchema,\n *   }),\n * });\n *\n * const page = await notion.pages.retrieve({ page_id: \"...\" });\n * const parsed = v.parse(PageSchema, page);\n * // parsed.properties.Phone: string\n * ```\n */\nexport const PhoneNumberSchema = v.pipe(\n\tv.object({\n\t\tphone_number: v.string(),\n\t}),\n\tv.transform((v) => v.phone_number),\n);\n\n/**\n * Schema to extract the `phone_number` property from a Notion page property or `null`.\n *\n * **Input:**\n * ```\n * {\n *   phone_number: string | null;\n * }\n * ```\n *\n * **Output:** `string | null`\n *\n * @example\n * ```ts\n * import * as v from \"valibot\";\n * import { NullablePhoneNumberSchema } from \"@nakanoaas/notion-valibot-utils\";\n *\n * const PageSchema = v.object({\n *   id: v.string(),\n *   properties: v.object({\n *     Phone: NullablePhoneNumberSchema,\n *   }),\n * });\n *\n * const page = await notion.pages.retrieve({ page_id: \"...\" });\n * const parsed = v.parse(PageSchema, page);\n * // parsed.properties.Phone: string | null\n * ```\n */\nexport const NullablePhoneNumberSchema = v.pipe(\n\tv.object({\n\t\tphone_number: v.nullable(v.string()),\n\t}),\n\tv.transform((v) => v.phone_number),\n);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,MAAa,oBAAoB,EAAE,KAClC,EAAE,OAAO,EACR,cAAc,EAAE,QAAQ,EACxB,CAAC,EACF,EAAE,WAAW,QAAMA,IAAE,aAAa,CAClC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BD,MAAa,4BAA4B,EAAE,KAC1C,EAAE,OAAO,EACR,cAAc,EAAE,SAAS,EAAE,QAAQ,CAAC,EACpC,CAAC,EACF,EAAE,WAAW,QAAMA,IAAE,aAAa,CAClC"}

package/dist/place.cjs

@@ -3,13 +3,141 @@ let valibot = require("valibot");
 valibot = require_rolldown_runtime.__toESM(valibot);
 
 //#region src/place.ts
+/**
+* Schema for a Notion place object structure.
+*
+* **Input:**
+* ```
+* {
+*   lat: number;
+*   lon: number;
+*   name?: string | null;
+*   address?: string | null;
+* }
+* ```
+*
+* **Output:**
+* ```
+* {
+*   lat: number;
+*   lon: number;
+*   name?: string | null;
+*   address?: string | null;
+* }
+* ```
+*
+* @example
+* ```ts
+* import * as v from "valibot";
+* import { PlaceObjectSchema } from "@nakanoaas/notion-valibot-utils";
+*
+* const PageSchema = v.object({
+*   id: v.string(),
+*   properties: v.object({
+*     Location: v.object({
+*       place: PlaceObjectSchema,
+*     }),
+*   }),
+* });
+*
+* const page = await notion.pages.retrieve({ page_id: "..." });
+* const parsed = v.parse(PageSchema, page);
+* // parsed.properties.Location.place: { lat: number; lon: number; name?: string | null; address?: string | null }
+* ```
+*
+* @internal
+*/
 const PlaceObjectSchema = valibot.object({
 	lat: valibot.number(),
 	lon: valibot.number(),
 	name: valibot.nullish(valibot.string()),
 	address: valibot.nullish(valibot.string())
 });
+/**
+* Schema to extract the `place` property from a Notion page property.
+*
+* **Input:**
+* ```
+* {
+*   place: {
+*     lat: number;
+*     lon: number;
+*     name?: string | null;
+*     address?: string | null;
+*   };
+* }
+* ```
+*
+* **Output:**
+* ```
+* {
+*   lat: number;
+*   lon: number;
+*   name?: string | null;
+*   address?: string | null;
+* }
+* ```
+*
+* @example
+* ```ts
+* import * as v from "valibot";
+* import { PlaceSchema } from "@nakanoaas/notion-valibot-utils";
+*
+* const PageSchema = v.object({
+*   id: v.string(),
+*   properties: v.object({
+*     Location: PlaceSchema,
+*   }),
+* });
+*
+* const page = await notion.pages.retrieve({ page_id: "..." });
+* const parsed = v.parse(PageSchema, page);
+* // parsed.properties.Location: { lat: number; lon: number; name?: string | null; address?: string | null }
+* ```
+*/
 const PlaceSchema = valibot.pipe(valibot.object({ place: PlaceObjectSchema }), valibot.transform((v) => v.place));
+/**
+* Schema to extract the `place` property from a Notion page property or `null`.
+*
+* **Input:**
+* ```
+* {
+*   place: {
+*     lat: number;
+*     lon: number;
+*     name?: string | null;
+*     address?: string | null;
+*   } | null;
+* }
+* ```
+*
+* **Output:**
+* ```
+* {
+*   lat: number;
+*   lon: number;
+*   name?: string | null;
+*   address?: string | null;
+* } | null
+* ```
+*
+* @example
+* ```ts
+* import * as v from "valibot";
+* import { NullablePlaceSchema } from "@nakanoaas/notion-valibot-utils";
+*
+* const PageSchema = v.object({
+*   id: v.string(),
+*   properties: v.object({
+*     Location: NullablePlaceSchema,
+*   }),
+* });
+*
+* const page = await notion.pages.retrieve({ page_id: "..." });
+* const parsed = v.parse(PageSchema, page);
+* // parsed.properties.Location: { lat: number; lon: number; name?: string | null; address?: string | null } | null
+* ```
+*/
 const NullablePlaceSchema = valibot.pipe(valibot.object({ place: valibot.nullable(PlaceObjectSchema) }), valibot.transform((v) => v.place));
 
 //#endregion

package/dist/place.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"place.cjs","names":["v"],"sources":["../src/place.ts"],"sourcesContent":["import * as v from \"valibot\";\n\nconst PlaceObjectSchema = v.object({\n\tlat: v.number(),\n\tlon: v.number(),\n\tname: v.nullish(v.string()),\n\taddress: v.nullish(v.string()),\n});\n\nexport const PlaceSchema = v.pipe(\n\tv.object({\n\t\tplace: PlaceObjectSchema,\n\t}),\n\tv.transform((v) => v.place),\n);\n\nexport const NullablePlaceSchema = v.pipe(\n\tv.object({\n\t\tplace: v.nullable(PlaceObjectSchema),\n\t}),\n\tv.transform((v) => v.place),\n);\n"],"mappings":";;;;;AAEA,MAAM,oBAAoBA,QAAE,OAAO;CAClC,KAAKA,QAAE,QAAQ;CACf,KAAKA,QAAE,QAAQ;CACf,MAAMA,QAAE,QAAQA,QAAE,QAAQ,CAAC;CAC3B,SAASA,QAAE,QAAQA,QAAE,QAAQ,CAAC;CAC9B,CAAC;AAEF,MAAa,cAAcA,QAAE,KAC5BA,QAAE,OAAO,EACR,OAAO,mBACP,CAAC,EACFA,QAAE,WAAW,MAAM,EAAE,MAAM,CAC3B;AAED,MAAa,sBAAsBA,QAAE,KACpCA,QAAE,OAAO,EACR,OAAOA,QAAE,SAAS,kBAAkB,EACpC,CAAC,EACFA,QAAE,WAAW,MAAM,EAAE,MAAM,CAC3B"}
+{"version":3,"file":"place.cjs","names":["v"],"sources":["../src/place.ts"],"sourcesContent":["import * as v from \"valibot\";\n\n/**\n * Schema for a Notion place object structure.\n *\n * **Input:**\n * ```\n * {\n *   lat: number;\n *   lon: number;\n *   name?: string | null;\n *   address?: string | null;\n * }\n * ```\n *\n * **Output:**\n * ```\n * {\n *   lat: number;\n *   lon: number;\n *   name?: string | null;\n *   address?: string | null;\n * }\n * ```\n *\n * @example\n * ```ts\n * import * as v from \"valibot\";\n * import { PlaceObjectSchema } from \"@nakanoaas/notion-valibot-utils\";\n *\n * const PageSchema = v.object({\n *   id: v.string(),\n *   properties: v.object({\n *     Location: v.object({\n *       place: PlaceObjectSchema,\n *     }),\n *   }),\n * });\n *\n * const page = await notion.pages.retrieve({ page_id: \"...\" });\n * const parsed = v.parse(PageSchema, page);\n * // parsed.properties.Location.place: { lat: number; lon: number; name?: string | null; address?: string | null }\n * ```\n *\n * @internal\n */\nconst PlaceObjectSchema = v.object({\n\tlat: v.number(),\n\tlon: v.number(),\n\tname: v.nullish(v.string()),\n\taddress: v.nullish(v.string()),\n});\n\n/**\n * Schema to extract the `place` property from a Notion page property.\n *\n * **Input:**\n * ```\n * {\n *   place: {\n *     lat: number;\n *     lon: number;\n *     name?: string | null;\n *     address?: string | null;\n *   };\n * }\n * ```\n *\n * **Output:**\n * ```\n * {\n *   lat: number;\n *   lon: number;\n *   name?: string | null;\n *   address?: string | null;\n * }\n * ```\n *\n * @example\n * ```ts\n * import * as v from \"valibot\";\n * import { PlaceSchema } from \"@nakanoaas/notion-valibot-utils\";\n *\n * const PageSchema = v.object({\n *   id: v.string(),\n *   properties: v.object({\n *     Location: PlaceSchema,\n *   }),\n * });\n *\n * const page = await notion.pages.retrieve({ page_id: \"...\" });\n * const parsed = v.parse(PageSchema, page);\n * // parsed.properties.Location: { lat: number; lon: number; name?: string | null; address?: string | null }\n * ```\n */\nexport const PlaceSchema = v.pipe(\n\tv.object({\n\t\tplace: PlaceObjectSchema,\n\t}),\n\tv.transform((v) => v.place),\n);\n\n/**\n * Schema to extract the `place` property from a Notion page property or `null`.\n *\n * **Input:**\n * ```\n * {\n *   place: {\n *     lat: number;\n *     lon: number;\n *     name?: string | null;\n *     address?: string | null;\n *   } | null;\n * }\n * ```\n *\n * **Output:**\n * ```\n * {\n *   lat: number;\n *   lon: number;\n *   name?: string | null;\n *   address?: string | null;\n * } | null\n * ```\n *\n * @example\n * ```ts\n * import * as v from \"valibot\";\n * import { NullablePlaceSchema } from \"@nakanoaas/notion-valibot-utils\";\n *\n * const PageSchema = v.object({\n *   id: v.string(),\n *   properties: v.object({\n *     Location: NullablePlaceSchema,\n *   }),\n * });\n *\n * const page = await notion.pages.retrieve({ page_id: \"...\" });\n * const parsed = v.parse(PageSchema, page);\n * // parsed.properties.Location: { lat: number; lon: number; name?: string | null; address?: string | null } | null\n * ```\n */\nexport const NullablePlaceSchema = v.pipe(\n\tv.object({\n\t\tplace: v.nullable(PlaceObjectSchema),\n\t}),\n\tv.transform((v) => v.place),\n);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8CA,MAAM,oBAAoBA,QAAE,OAAO;CAClC,KAAKA,QAAE,QAAQ;CACf,KAAKA,QAAE,QAAQ;CACf,MAAMA,QAAE,QAAQA,QAAE,QAAQ,CAAC;CAC3B,SAASA,QAAE,QAAQA,QAAE,QAAQ,CAAC;CAC9B,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CF,MAAa,cAAcA,QAAE,KAC5BA,QAAE,OAAO,EACR,OAAO,mBACP,CAAC,EACFA,QAAE,WAAW,MAAM,EAAE,MAAM,CAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CD,MAAa,sBAAsBA,QAAE,KACpCA,QAAE,OAAO,EACR,OAAOA,QAAE,SAAS,kBAAkB,EACpC,CAAC,EACFA,QAAE,WAAW,MAAM,EAAE,MAAM,CAC3B"}

package/dist/place.d.cts

@@ -1,6 +1,49 @@
 import * as v from "valibot";
 
 //#region src/place.d.ts
+
+/**
+ * Schema to extract the `place` property from a Notion page property.
+ *
+ * **Input:**
+ * ```
+ * {
+ *   place: {
+ *     lat: number;
+ *     lon: number;
+ *     name?: string | null;
+ *     address?: string | null;
+ *   };
+ * }
+ * ```
+ *
+ * **Output:**
+ * ```
+ * {
+ *   lat: number;
+ *   lon: number;
+ *   name?: string | null;
+ *   address?: string | null;
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * import * as v from "valibot";
+ * import { PlaceSchema } from "@nakanoaas/notion-valibot-utils";
+ *
+ * const PageSchema = v.object({
+ *   id: v.string(),
+ *   properties: v.object({
+ *     Location: PlaceSchema,
+ *   }),
+ * });
+ *
+ * const page = await notion.pages.retrieve({ page_id: "..." });
+ * const parsed = v.parse(PageSchema, page);
+ * // parsed.properties.Location: { lat: number; lon: number; name?: string | null; address?: string | null }
+ * ```
+ */
 declare const PlaceSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
   readonly place: v.ObjectSchema<{
     readonly lat: v.NumberSchema<undefined>;
@@ -21,6 +64,48 @@ declare const PlaceSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
   name?: string | null | undefined;
   address?: string | null | undefined;
 }>]>;
+/**
+ * Schema to extract the `place` property from a Notion page property or `null`.
+ *
+ * **Input:**
+ * ```
+ * {
+ *   place: {
+ *     lat: number;
+ *     lon: number;
+ *     name?: string | null;
+ *     address?: string | null;
+ *   } | null;
+ * }
+ * ```
+ *
+ * **Output:**
+ * ```
+ * {
+ *   lat: number;
+ *   lon: number;
+ *   name?: string | null;
+ *   address?: string | null;
+ * } | null
+ * ```
+ *
+ * @example
+ * ```ts
+ * import * as v from "valibot";
+ * import { NullablePlaceSchema } from "@nakanoaas/notion-valibot-utils";
+ *
+ * const PageSchema = v.object({
+ *   id: v.string(),
+ *   properties: v.object({
+ *     Location: NullablePlaceSchema,
+ *   }),
+ * });
+ *
+ * const page = await notion.pages.retrieve({ page_id: "..." });
+ * const parsed = v.parse(PageSchema, page);
+ * // parsed.properties.Location: { lat: number; lon: number; name?: string | null; address?: string | null } | null
+ * ```
+ */
 declare const NullablePlaceSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
   readonly place: v.NullableSchema<v.ObjectSchema<{
     readonly lat: v.NumberSchema<undefined>;

package/dist/place.d.mts

@@ -1,6 +1,49 @@
 import * as v from "valibot";
 
 //#region src/place.d.ts
+
+/**
+ * Schema to extract the `place` property from a Notion page property.
+ *
+ * **Input:**
+ * ```
+ * {
+ *   place: {
+ *     lat: number;
+ *     lon: number;
+ *     name?: string | null;
+ *     address?: string | null;
+ *   };
+ * }
+ * ```
+ *
+ * **Output:**
+ * ```
+ * {
+ *   lat: number;
+ *   lon: number;
+ *   name?: string | null;
+ *   address?: string | null;
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * import * as v from "valibot";
+ * import { PlaceSchema } from "@nakanoaas/notion-valibot-utils";
+ *
+ * const PageSchema = v.object({
+ *   id: v.string(),
+ *   properties: v.object({
+ *     Location: PlaceSchema,
+ *   }),
+ * });
+ *
+ * const page = await notion.pages.retrieve({ page_id: "..." });
+ * const parsed = v.parse(PageSchema, page);
+ * // parsed.properties.Location: { lat: number; lon: number; name?: string | null; address?: string | null }
+ * ```
+ */
 declare const PlaceSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
   readonly place: v.ObjectSchema<{
     readonly lat: v.NumberSchema<undefined>;
@@ -21,6 +64,48 @@ declare const PlaceSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
   name?: string | null | undefined;
   address?: string | null | undefined;
 }>]>;
+/**
+ * Schema to extract the `place` property from a Notion page property or `null`.
+ *
+ * **Input:**
+ * ```
+ * {
+ *   place: {
+ *     lat: number;
+ *     lon: number;
+ *     name?: string | null;
+ *     address?: string | null;
+ *   } | null;
+ * }
+ * ```
+ *
+ * **Output:**
+ * ```
+ * {
+ *   lat: number;
+ *   lon: number;
+ *   name?: string | null;
+ *   address?: string | null;
+ * } | null
+ * ```
+ *
+ * @example
+ * ```ts
+ * import * as v from "valibot";
+ * import { NullablePlaceSchema } from "@nakanoaas/notion-valibot-utils";
+ *
+ * const PageSchema = v.object({
+ *   id: v.string(),
+ *   properties: v.object({
+ *     Location: NullablePlaceSchema,
+ *   }),
+ * });
+ *
+ * const page = await notion.pages.retrieve({ page_id: "..." });
+ * const parsed = v.parse(PageSchema, page);
+ * // parsed.properties.Location: { lat: number; lon: number; name?: string | null; address?: string | null } | null
+ * ```
+ */
 declare const NullablePlaceSchema: v.SchemaWithPipe<readonly [v.ObjectSchema<{
   readonly place: v.NullableSchema<v.ObjectSchema<{
     readonly lat: v.NumberSchema<undefined>;

package/dist/place.mjs

@@ -1,13 +1,141 @@
 import * as v from "valibot";
 
 //#region src/place.ts
+/**
+* Schema for a Notion place object structure.
+*
+* **Input:**
+* ```
+* {
+*   lat: number;
+*   lon: number;
+*   name?: string | null;
+*   address?: string | null;
+* }
+* ```
+*
+* **Output:**
+* ```
+* {
+*   lat: number;
+*   lon: number;
+*   name?: string | null;
+*   address?: string | null;
+* }
+* ```
+*
+* @example
+* ```ts
+* import * as v from "valibot";
+* import { PlaceObjectSchema } from "@nakanoaas/notion-valibot-utils";
+*
+* const PageSchema = v.object({
+*   id: v.string(),
+*   properties: v.object({
+*     Location: v.object({
+*       place: PlaceObjectSchema,
+*     }),
+*   }),
+* });
+*
+* const page = await notion.pages.retrieve({ page_id: "..." });
+* const parsed = v.parse(PageSchema, page);
+* // parsed.properties.Location.place: { lat: number; lon: number; name?: string | null; address?: string | null }
+* ```
+*
+* @internal
+*/
 const PlaceObjectSchema = v.object({
 	lat: v.number(),
 	lon: v.number(),
 	name: v.nullish(v.string()),
 	address: v.nullish(v.string())
 });
+/**
+* Schema to extract the `place` property from a Notion page property.
+*
+* **Input:**
+* ```
+* {
+*   place: {
+*     lat: number;
+*     lon: number;
+*     name?: string | null;
+*     address?: string | null;
+*   };
+* }
+* ```
+*
+* **Output:**
+* ```
+* {
+*   lat: number;
+*   lon: number;
+*   name?: string | null;
+*   address?: string | null;
+* }
+* ```
+*
+* @example
+* ```ts
+* import * as v from "valibot";
+* import { PlaceSchema } from "@nakanoaas/notion-valibot-utils";
+*
+* const PageSchema = v.object({
+*   id: v.string(),
+*   properties: v.object({
+*     Location: PlaceSchema,
+*   }),
+* });
+*
+* const page = await notion.pages.retrieve({ page_id: "..." });
+* const parsed = v.parse(PageSchema, page);
+* // parsed.properties.Location: { lat: number; lon: number; name?: string | null; address?: string | null }
+* ```
+*/
 const PlaceSchema = v.pipe(v.object({ place: PlaceObjectSchema }), v.transform((v$1) => v$1.place));
+/**
+* Schema to extract the `place` property from a Notion page property or `null`.
+*
+* **Input:**
+* ```
+* {
+*   place: {
+*     lat: number;
+*     lon: number;
+*     name?: string | null;
+*     address?: string | null;
+*   } | null;
+* }
+* ```
+*
+* **Output:**
+* ```
+* {
+*   lat: number;
+*   lon: number;
+*   name?: string | null;
+*   address?: string | null;
+* } | null
+* ```
+*
+* @example
+* ```ts
+* import * as v from "valibot";
+* import { NullablePlaceSchema } from "@nakanoaas/notion-valibot-utils";
+*
+* const PageSchema = v.object({
+*   id: v.string(),
+*   properties: v.object({
+*     Location: NullablePlaceSchema,
+*   }),
+* });
+*
+* const page = await notion.pages.retrieve({ page_id: "..." });
+* const parsed = v.parse(PageSchema, page);
+* // parsed.properties.Location: { lat: number; lon: number; name?: string | null; address?: string | null } | null
+* ```
+*/
 const NullablePlaceSchema = v.pipe(v.object({ place: v.nullable(PlaceObjectSchema) }), v.transform((v$1) => v$1.place));
 
 //#endregion

package/dist/place.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"place.mjs","names":["v"],"sources":["../src/place.ts"],"sourcesContent":["import * as v from \"valibot\";\n\nconst PlaceObjectSchema = v.object({\n\tlat: v.number(),\n\tlon: v.number(),\n\tname: v.nullish(v.string()),\n\taddress: v.nullish(v.string()),\n});\n\nexport const PlaceSchema = v.pipe(\n\tv.object({\n\t\tplace: PlaceObjectSchema,\n\t}),\n\tv.transform((v) => v.place),\n);\n\nexport const NullablePlaceSchema = v.pipe(\n\tv.object({\n\t\tplace: v.nullable(PlaceObjectSchema),\n\t}),\n\tv.transform((v) => v.place),\n);\n"],"mappings":";;;AAEA,MAAM,oBAAoB,EAAE,OAAO;CAClC,KAAK,EAAE,QAAQ;CACf,KAAK,EAAE,QAAQ;CACf,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC;CAC3B,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC;CAC9B,CAAC;AAEF,MAAa,cAAc,EAAE,KAC5B,EAAE,OAAO,EACR,OAAO,mBACP,CAAC,EACF,EAAE,WAAW,QAAMA,IAAE,MAAM,CAC3B;AAED,MAAa,sBAAsB,EAAE,KACpC,EAAE,OAAO,EACR,OAAO,EAAE,SAAS,kBAAkB,EACpC,CAAC,EACF,EAAE,WAAW,QAAMA,IAAE,MAAM,CAC3B"}
+{"version":3,"file":"place.mjs","names":["v"],"sources":["../src/place.ts"],"sourcesContent":["import * as v from \"valibot\";\n\n/**\n * Schema for a Notion place object structure.\n *\n * **Input:**\n * ```\n * {\n *   lat: number;\n *   lon: number;\n *   name?: string | null;\n *   address?: string | null;\n * }\n * ```\n *\n * **Output:**\n * ```\n * {\n *   lat: number;\n *   lon: number;\n *   name?: string | null;\n *   address?: string | null;\n * }\n * ```\n *\n * @example\n * ```ts\n * import * as v from \"valibot\";\n * import { PlaceObjectSchema } from \"@nakanoaas/notion-valibot-utils\";\n *\n * const PageSchema = v.object({\n *   id: v.string(),\n *   properties: v.object({\n *     Location: v.object({\n *       place: PlaceObjectSchema,\n *     }),\n *   }),\n * });\n *\n * const page = await notion.pages.retrieve({ page_id: \"...\" });\n * const parsed = v.parse(PageSchema, page);\n * // parsed.properties.Location.place: { lat: number; lon: number; name?: string | null; address?: string | null }\n * ```\n *\n * @internal\n */\nconst PlaceObjectSchema = v.object({\n\tlat: v.number(),\n\tlon: v.number(),\n\tname: v.nullish(v.string()),\n\taddress: v.nullish(v.string()),\n});\n\n/**\n * Schema to extract the `place` property from a Notion page property.\n *\n * **Input:**\n * ```\n * {\n *   place: {\n *     lat: number;\n *     lon: number;\n *     name?: string | null;\n *     address?: string | null;\n *   };\n * }\n * ```\n *\n * **Output:**\n * ```\n * {\n *   lat: number;\n *   lon: number;\n *   name?: string | null;\n *   address?: string | null;\n * }\n * ```\n *\n * @example\n * ```ts\n * import * as v from \"valibot\";\n * import { PlaceSchema } from \"@nakanoaas/notion-valibot-utils\";\n *\n * const PageSchema = v.object({\n *   id: v.string(),\n *   properties: v.object({\n *     Location: PlaceSchema,\n *   }),\n * });\n *\n * const page = await notion.pages.retrieve({ page_id: \"...\" });\n * const parsed = v.parse(PageSchema, page);\n * // parsed.properties.Location: { lat: number; lon: number; name?: string | null; address?: string | null }\n * ```\n */\nexport const PlaceSchema = v.pipe(\n\tv.object({\n\t\tplace: PlaceObjectSchema,\n\t}),\n\tv.transform((v) => v.place),\n);\n\n/**\n * Schema to extract the `place` property from a Notion page property or `null`.\n *\n * **Input:**\n * ```\n * {\n *   place: {\n *     lat: number;\n *     lon: number;\n *     name?: string | null;\n *     address?: string | null;\n *   } | null;\n * }\n * ```\n *\n * **Output:**\n * ```\n * {\n *   lat: number;\n *   lon: number;\n *   name?: string | null;\n *   address?: string | null;\n * } | null\n * ```\n *\n * @example\n * ```ts\n * import * as v from \"valibot\";\n * import { NullablePlaceSchema } from \"@nakanoaas/notion-valibot-utils\";\n *\n * const PageSchema = v.object({\n *   id: v.string(),\n *   properties: v.object({\n *     Location: NullablePlaceSchema,\n *   }),\n * });\n *\n * const page = await notion.pages.retrieve({ page_id: \"...\" });\n * const parsed = v.parse(PageSchema, page);\n * // parsed.properties.Location: { lat: number; lon: number; name?: string | null; address?: string | null } | null\n * ```\n */\nexport const NullablePlaceSchema = v.pipe(\n\tv.object({\n\t\tplace: v.nullable(PlaceObjectSchema),\n\t}),\n\tv.transform((v) => v.place),\n);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8CA,MAAM,oBAAoB,EAAE,OAAO;CAClC,KAAK,EAAE,QAAQ;CACf,KAAK,EAAE,QAAQ;CACf,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC;CAC3B,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC;CAC9B,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CF,MAAa,cAAc,EAAE,KAC5B,EAAE,OAAO,EACR,OAAO,mBACP,CAAC,EACF,EAAE,WAAW,QAAMA,IAAE,MAAM,CAC3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CD,MAAa,sBAAsB,EAAE,KACpC,EAAE,OAAO,EACR,OAAO,EAAE,SAAS,kBAAkB,EACpC,CAAC,EACF,EAAE,WAAW,QAAMA,IAAE,MAAM,CAC3B"}