@crawl-me-maybe/schema 0.1.0 → 0.2.0

package/README.md

@@ -1,3 +1,6 @@
+<img width="1590" height="408" alt="schema-thumb" src="https://github.com/user-attachments/assets/3afe5640-0396-48cd-abb9-8bfcae3ca7fc" />
+<br/>
+
 # @crawl-me-maybe/schema
 
 Schema markup should be generated from your content model, not rebuilt beside it. If editors update the content, the schema should update with it.
@@ -12,6 +15,11 @@ Schema markup should be generated from your content model, not rebuilt beside it
 - [`mainEntity`](#mainentity)
 - [`@id` and de-duplication](#id-and-de-duplication)
 - [Rendering the graph](#rendering-the-graph)
+- [Localized pages](#localized-pages)
+- [Nesting entities](#nesting-entities)
+- [Dates and durations](#dates-and-durations)
+- [Helpers](#helpers)
+- [Empty values](#empty-values)
 - [Supported schemas](#supported-schemas)
 - [With Sanity](#with-sanity)
 - [Core exports](#core-exports)
@@ -33,8 +41,11 @@ yarn add @crawl-me-maybe/schema
 - `buildSchemaMarkup` emits a JSON-LD graph for identity, `WebSite`, and `WebPage`
 - Typed builders for common Schema.org nodes, backed by `schema-dts`
 - Entity de-duping by `@id` when nested nodes reference the same entity
-- Identity roots for `Person`, `Organization`, and `LocalBusiness`
+- Identity roots for `Person`, `Organization`, and `LocalBusiness`, linkable from any page via `identityRef`
 - Utility builders for breadcrumbs, FAQ pages, products, articles, events, and more
+- Nested builders for offers, course instances, schedules, places, people, and more
+- Cleans the graph for you: nested `@context` and empty values (`null`, `""`, `[]`) are dropped
+- Small helpers for ISO 8601 durations and dates, and absolute URLs
 
 ## Why this exists
 
@@ -133,6 +144,10 @@ If multiple nodes reference the same entity, give them the same `@id`. The libra
 
 In most cases, `buildSchemaMarkup` handles page-level identity, `WebSite`, and `WebPage` IDs for you. You'll mainly care about `@id` when composing custom or nested entities manually.
 
+A nested node with both `@type` and `@id` is hoisted to its own top-level node in the graph, and replaced where it was nested with an `{ "@id": ... }` reference. To link to the site identity, use [`identityRef`](#identityref).
+
+Generated IDs ignore trailing slashes on `siteUrl`, so `https://example.com` and `https://example.com/` produce the same IDs.
+
 ---
 
 ## Rendering the graph
@@ -149,6 +164,229 @@ In most cases, `buildSchemaMarkup` handles page-level identity, `WebSite`, and `
 
 ---
 
+## Localized pages
+
+Pass `inLanguage` to set the language of the current page. It is emitted on the `WebPage` node only.
+
+```ts
+buildSchemaMarkup({
+  // ...
+  siteUrl: "https://example.com",
+  pageUrl: "https://example.com/fr/a-propos",
+  pageTitle: "À propos",
+  inLanguage: "fr",
+});
+```
+
+- Pass the language of the content that is actually rendered. If a `/fr/...` route falls back to English content, pass `"en"`.
+- Use a BCP 47 tag with hyphens (`fr-CA`, not `fr_CA`). Never pass `x-default`; it is an hreflang value, not a language.
+- Keep `siteUrl` as the root origin for every locale (`https://example.com`, not `https://example.com/fr`) so all locales share one `WebSite` `@id`.
+- Nested entities don't inherit it and don't need it. Set `inLanguage` on an entity only when its language differs from the page.
+- `inLanguage` does not replace hreflang. Localized alternates still come from your sitemap or `<link rel="alternate" hreflang>` tags.
+
+---
+
+## Nesting entities
+
+Nested values like a course's offers or instances need their own `@type`. Use a nested builder where one exists, or a plain object with `"@type"` for anything else:
+
+```ts
+import {
+  buildCourse,
+  buildCourseInstance,
+  buildOffer,
+  buildSchedule,
+  identityRef,
+  toIsoDate,
+  toIsoDuration,
+} from "@crawl-me-maybe/schema";
+
+const mainEntity = buildCourse({
+  name: course.title,
+  description: course.summary,
+  provider: identityRef,
+  offers: [
+    buildOffer({
+      category: "Paid",
+      price: course.price,
+      priceCurrency: "USD",
+    }),
+  ],
+  hasCourseInstance: [
+    buildCourseInstance({
+      courseMode: "Online",
+      courseWorkload: toIsoDuration({ hours: course.totalHours }),
+      courseSchedule: buildSchedule({
+        duration: toIsoDuration({ minutes: course.sessionMinutes }),
+        repeatFrequency: "P1W",
+        startDate: toIsoDate(course.startsAt),
+      }),
+    }),
+  ],
+  // No builder for this type — a plain object with "@type" works too.
+  audience: { "@type": "EducationalAudience", educationalRole: "student" },
+});
+```
+
+- Builders add their own `@context`. When nested, `buildSchemaMarkup` strips it, so only top-level nodes carry `@context`.
+- There is no automatic `@type` inference. Many properties accept more than one type (`author` can be a `Person` or `Organization`), and `@type` is what gives you accurate autocomplete from `schema-dts`.
+- The graph cleanup (nested `@context`, [empty values](#empty-values), and `identityRef`) only happens inside `buildSchemaMarkup`. If you serialize a builder's output yourself, it's emitted as-is.
+
+---
+
+## Dates and durations
+
+Schema.org expects ISO 8601 for dates and durations, but `schema-dts` types them as plain `string`, so nothing catches `"3 hours"` at compile time.
+
+| Format | Common fields |
+|---|---|
+| Duration (`PT1H30M`) | `Recipe.prepTime` / `cookTime` / `totalTime`, `VideoObject.duration`, `Movie.duration`, `Schedule.duration` / `repeatFrequency`, `CourseInstance.courseWorkload` |
+| Date / date-time (`2026-09-28`, `2026-09-28T13:00:00-06:00`) | `Article.datePublished` / `dateModified`, `Event.startDate` / `endDate`, `JobPosting.datePosted` / `validThrough`, `VideoObject.uploadDate`, `Offer.validFrom` / `validThrough` / `priceValidUntil`, `Schedule.startDate` / `endDate` |
+
+### `toIsoDuration(parts)`
+
+Takes an object of named parts, so the unit is always explicit:
+
+```ts
+toIsoDuration({ hours: 1, minutes: 30 });       // "PT1H30M"
+toIsoDuration({ seconds: video.duration });     // "PT183S"
+toIsoDuration({ minutes: recipe.cookMinutes }); // "PT45M"
+toIsoDuration({ weeks: 1 });                    // "P1W"
+toIsoDuration({ months: 1 });                   // "P1M"
+```
+
+- Accepts `years`, `months`, `weeks`, `days`, `hours`, `minutes`, and `seconds`.
+- Parts are emitted as given, without carrying over — `{ minutes: 90 }` is `"PT90M"`, which is valid ISO 8601.
+- Zero parts are omitted; all zeros gives `"PT0S"`.
+- Throws on negative or non-finite values, fractional values other than `seconds`, and `weeks` combined with other parts.
+
+### `toIsoDate(value)`
+
+Accepts a `Date` or an ISO 8601 string:
+
+```ts
+toIsoDate(new Date());                     // "2026-09-28T19:17:00.000Z"
+toIsoDate("2026-09-28T19:17:00.000Z");     // unchanged (Sanity datetime)
+toIsoDate("2026-09-28T13:00:00-06:00");    // unchanged, offset kept
+toIsoDate("2026-09-28T13:00+0600");        // "2026-09-28T13:00+06:00"
+toIsoDate("2026-09-28");                   // unchanged
+```
+
+- `Date` objects are converted to UTC with `toISOString()`.
+- Valid ISO strings are returned as written, so an editor's local time and offset survive. `+hhmm` offsets are rewritten to `+hh:mm`.
+- Date-times without an offset are passed through unchanged — the helper can't safely guess a timezone.
+- Anything else throws.
+
+---
+
+## Helpers
+
+### `identityRef`
+
+Page- and component-level code usually doesn't have the global identity config handy. Use `identityRef` anywhere an entity is expected, and `buildSchemaMarkup` resolves it to the `@id` of the identity node it emits:
+
+```ts
+// Page or component level
+const mainEntity = buildCourse({
+  name: course.title,
+  provider: identityRef,
+  publisher: identityRef,
+});
+
+// App level
+buildSchemaMarkup({
+  identity: { type: "organization", name: siteName },
+  siteUrl,
+  siteName,
+  pageUrl,
+  pageTitle,
+  mainEntity,
+});
+```
+
+Prefer this over inlining `{ "@type": "Organization", name: siteName, url: siteUrl }`. Without an `@id`, the inline version is a second organization that search engines can't link to your site identity.
+
+`identityRef` is a plain object (`{ "@id": "@identity" }`), so it survives being serialized across a server/client or loader boundary. It only resolves inside `buildSchemaMarkup`.
+
+### Reusing other entities
+
+For entities that appear in several places, like an instructor across courses, give them a stable `@id`. They're hoisted to top-level nodes and de-duplicated:
+
+```ts
+const instructor = buildPerson({
+  "@id": `${siteUrl}#instructor-jane`,
+  name: "Jane Doe",
+});
+
+buildCourse({
+  name: "Intro",
+  hasCourseInstance: [
+    buildCourseInstance({ courseMode: "Online", instructor: [instructor] }),
+  ],
+});
+```
+
+### `toAbsoluteUrl(value, siteUrl)`
+
+Search engines expect absolute URLs for `url`, `image`, and breadcrumb `item` values. CMS content usually gives you slugs or relative paths:
+
+```ts
+toAbsoluteUrl("/blog/post", "https://example.com");        // "https://example.com/blog/post"
+toAbsoluteUrl("blog/post", "https://example.com/");        // "https://example.com/blog/post"
+toAbsoluteUrl("/a", "https://example.com/docs");           // "https://example.com/docs/a"
+toAbsoluteUrl("https://cdn.sanity.io/x.jpg", siteUrl);     // unchanged
+toAbsoluteUrl("//cdn.example.com/x.jpg", "https://example.com"); // "https://cdn.example.com/x.jpg"
+toAbsoluteUrl(null, siteUrl);                              // undefined
+```
+
+Relative values are joined to `siteUrl`, keeping any base path. Empty input returns `undefined`, so the field is dropped from the graph.
+
+### `buildImageObject(input)`
+
+Turns a URL string or an object into an `ImageObject`, typed so it can be passed straight to any `image` or `logo` field. Returns `undefined` for empty input.
+
+```ts
+buildImageObject("https://example.com/logo.png");
+buildImageObject({ url: image.url, width: 1200, height: 630 });
+```
+
+The output always includes `contentUrl` alongside `url`, with the same value. Google's [image metadata](https://developers.google.com/search/docs/appearance/structured-data/image-license-metadata) feature requires `contentUrl`, and other uses such as logos read `url`.
+
+To show license and credit details in Google Images, add any of the image metadata fields:
+
+```ts
+buildImageObject({
+  url: image.url,
+  caption: image.alt,
+  creditText: "Acme Photography",
+  copyrightNotice: "© 2026 Acme",
+  license: "https://example.com/image-license",
+  acquireLicensePage: "https://example.com/licensing",
+  creator: identityRef,
+});
+```
+
+`creator` accepts `identityRef`, `buildPerson(...)`, `buildOrganization(...)`, or an `{ "@id" }` reference.
+
+### Portable Text
+
+For descriptions stored as Portable Text, convert to a plain string first — for example with `toPlainText` from [`@portabletext/toolkit`](https://github.com/portabletext/toolkit). This package has no Sanity dependency.
+
+---
+
+## Empty values
+
+`buildSchemaMarkup` drops values that carry no information before serializing:
+
+- `null` and `undefined`
+- empty or whitespace-only strings
+- empty arrays (after removing empty items)
+- objects with nothing besides `@type`
+
+`0` and `false` are kept. GROQ returns `null` for unset fields, so projections don't need `coalesce()` just to keep `null` out of the markup.
+
+---
+
 ## Supported schemas
 
 Builders are exported from the package root.
@@ -197,8 +435,67 @@ Site identity (`Organization`, `Person`, or `LocalBusiness`) is emitted by `buil
 | `buildDiscussionForumPosting` | `DiscussionForumPosting` |
 | `buildItemList` | `ItemList` |
 
+### Nested values
+
+Building blocks for properties like `offers`, `hasCourseInstance`, `location`, or `author`. See [Nesting entities](#nesting-entities).
+
+| Builder | Schema.org type | Typical parent properties |
+|---|---|---|
+| `buildOffer` | `Offer` | `offers` on Product, Course, Event, SoftwareApplication |
+| `buildAggregateOffer` | `AggregateOffer` | `offers` with a price range (`lowPrice`, `highPrice`, `offerCount`) |
+| `buildMonetaryAmount` | `MonetaryAmount` | `baseSalary` on JobPosting |
+| `buildQuantitativeValue` | `QuantitativeValue` | `value` in MonetaryAmount, product dimensions |
+| `buildBrand` | `Brand` | `brand` on Product |
+| `buildCourseInstance` | `CourseInstance` | `hasCourseInstance` on Course |
+| `buildSchedule` | `Schedule` | `courseSchedule`, `eventSchedule` |
+| `buildPlace` | `Place` | `location` on Event, `jobLocation` on JobPosting |
+| `buildPostalAddress` | `PostalAddress` | `address` on Place, Organization, LocalBusiness |
+| `buildGeoCoordinates` | `GeoCoordinates` | `geo` on Place, LocalBusiness |
+| `buildPerson` | `Person` | `author`, `actor`, `director`, `instructor` on CourseInstance |
+| `buildOrganization` | `Organization` | `hiringOrganization`, `organizer`, `productionCompany` |
+| `buildHowToStep` | `HowToStep` | `recipeInstructions` on Recipe |
+| `buildNutritionInformation` | `NutritionInformation` | `nutrition` on Recipe |
+| `buildOfferShippingDetails` | `OfferShippingDetails` | `shippingDetails` on Offer |
+| `buildMerchantReturnPolicy` | `MerchantReturnPolicy` | `hasMerchantReturnPolicy` on Offer or Organization |
+
+`buildPerson` and `buildOrganization` are for other people and organizations on the page. For the site owner, use `identity` on `buildSchemaMarkup` and link to it with [`identityRef`](#identityref).
+
+**Product merchant listing example:**
+
+```ts
+buildProduct({
+  name: product.title,
+  image: buildImageObject(product.imageUrl),
+  offers: [
+    buildOffer({
+      price: product.price,
+      priceCurrency: "USD",
+      availability: "InStock",
+      shippingDetails: buildOfferShippingDetails({
+        shippingRate: buildMonetaryAmount({ value: 0, currency: "USD" }),
+        shippingDestination: { "@type": "DefinedRegion", addressCountry: "US" },
+        deliveryTime: {
+          "@type": "ShippingDeliveryTime",
+          handlingTime: { "@type": "QuantitativeValue", minValue: 0, maxValue: 1, unitCode: "DAY" },
+          transitTime: { "@type": "QuantitativeValue", minValue: 1, maxValue: 5, unitCode: "DAY" },
+        },
+      }),
+      hasMerchantReturnPolicy: buildMerchantReturnPolicy({
+        applicableCountry: "US",
+        returnPolicyCategory: "MerchantReturnFiniteReturnWindow",
+        merchantReturnDays: 30,
+        returnMethod: "ReturnByMail",
+        returnFees: "FreeReturn",
+      }),
+    }),
+  ],
+});
+```
+
 See Google's [structured data gallery](https://developers.google.com/search/docs/appearance/structured-data/search-gallery) for which schema types are eligible for rich results.
 
+> Google no longer lists FAQ or Course info rich results. `buildFAQPage`, and `offers` / `hasCourseInstance` on a Course, still produce valid Schema.org markup but won't earn a rich result. Google's Course list only needs `name`, `description`, and `provider` on each `Course`, plus an `ItemList` for the carousel.
+
 ---
 
 ## With Sanity
@@ -259,6 +556,10 @@ Pick the `build*` helper that matches your document type (`buildProduct`, `build
 
 - `buildSchemaMarkup` — builds the page-level JSON-LD graph
 - `build*` schema builders — typed builders for individual Schema.org nodes
+- `identityRef` — reference to the site identity, resolved by `buildSchemaMarkup`
+- `toIsoDuration`, `toIsoDate`, `DurationParts` — ISO 8601 duration and date helpers
+- `toAbsoluteUrl` — resolves slugs and relative paths against `siteUrl`
+- `buildImageObject`, `ImageInput` — `ImageObject` helper
 - `BuilderInput` — input helper type for builder functions
 - `BuildSchemaMarkupInput` — input type for `buildSchemaMarkup`
 - `Identity`, `PersonIdentity`, `OrganizationIdentity`, `LocalBusinessIdentity` — supported site identity roots

package/dist/build.d.ts

@@ -9,6 +9,8 @@ export type BuildSchemaMarkupInput = {
     pageUrl: string;
     pageTitle: string;
     pageDescription?: string;
+    /** BCP 47 language tag for the page content, e.g. `"fr"` or `"fr-CA"`. */
+    inLanguage?: string;
     breadcrumb?: WithContext<BreadcrumbList>;
     mainEntity?: Thing | SchemaNode;
 };

package/dist/builders/aggregate-offer.d.ts

@@ -0,0 +1,3 @@
+import type { AggregateOffer } from "schema-dts";
+import { type SchemaBuilder } from "../define-builder";
+export declare const buildAggregateOffer: SchemaBuilder<AggregateOffer>;

package/dist/builders/brand.d.ts

@@ -0,0 +1,3 @@
+import type { Brand } from "schema-dts";
+import { type SchemaBuilder } from "../define-builder";
+export declare const buildBrand: SchemaBuilder<Brand>;

package/dist/builders/course-instance.d.ts

@@ -0,0 +1,3 @@
+import type { CourseInstance } from "schema-dts";
+import { type SchemaBuilder } from "../define-builder";
+export declare const buildCourseInstance: SchemaBuilder<CourseInstance>;

package/dist/builders/geo-coordinates.d.ts

@@ -0,0 +1,3 @@
+import type { GeoCoordinates } from "schema-dts";
+import { type SchemaBuilder } from "../define-builder";
+export declare const buildGeoCoordinates: SchemaBuilder<GeoCoordinates>;

package/dist/builders/how-to-step.d.ts

@@ -0,0 +1,3 @@
+import type { HowToStep } from "schema-dts";
+import { type SchemaBuilder } from "../define-builder";
+export declare const buildHowToStep: SchemaBuilder<HowToStep>;

package/dist/builders/index.d.ts

@@ -1,25 +1,41 @@
 export * from "./about-page";
+export * from "./aggregate-offer";
 export * from "./aggregate-rating";
 export * from "./answer";
 export * from "./article";
+export * from "./brand";
 export * from "./breadcrumb-list";
 export * from "./comment";
 export * from "./contact-page";
 export * from "./course";
+export * from "./course-instance";
 export * from "./dataset";
 export * from "./discussion-forum-posting";
 export * from "./event";
 export * from "./faq";
+export * from "./geo-coordinates";
+export * from "./how-to-step";
 export * from "./item-list";
 export * from "./job-posting";
 export * from "./local-business";
+export * from "./merchant-return-policy";
+export * from "./monetary-amount";
 export * from "./movie";
+export * from "./nutrition-information";
+export * from "./offer";
+export * from "./offer-shipping-details";
+export * from "./organization";
+export * from "./person";
+export * from "./place";
+export * from "./postal-address";
 export * from "./product";
 export * from "./profile-page";
 export * from "./qa-page";
+export * from "./quantitative-value";
 export * from "./question";
 export * from "./recipe";
 export * from "./review";
+export * from "./schedule";
 export * from "./software-application";
 export * from "./vacation-rental";
 export * from "./video-object";

package/dist/builders/merchant-return-policy.d.ts

@@ -0,0 +1,3 @@
+import type { MerchantReturnPolicy } from "schema-dts";
+import { type SchemaBuilder } from "../define-builder";
+export declare const buildMerchantReturnPolicy: SchemaBuilder<MerchantReturnPolicy>;

package/dist/builders/monetary-amount.d.ts

@@ -0,0 +1,3 @@
+import type { MonetaryAmount } from "schema-dts";
+import { type SchemaBuilder } from "../define-builder";
+export declare const buildMonetaryAmount: SchemaBuilder<MonetaryAmount>;

package/dist/builders/nutrition-information.d.ts

@@ -0,0 +1,3 @@
+import type { NutritionInformation } from "schema-dts";
+import { type SchemaBuilder } from "../define-builder";
+export declare const buildNutritionInformation: SchemaBuilder<NutritionInformation>;

package/dist/builders/offer-shipping-details.d.ts

@@ -0,0 +1,3 @@
+import type { OfferShippingDetails } from "schema-dts";
+import { type SchemaBuilder } from "../define-builder";
+export declare const buildOfferShippingDetails: SchemaBuilder<OfferShippingDetails>;

package/dist/builders/offer.d.ts

@@ -0,0 +1,3 @@
+import type { Offer } from "schema-dts";
+import { type SchemaBuilder } from "../define-builder";
+export declare const buildOffer: SchemaBuilder<Offer>;

package/dist/builders/organization.d.ts

@@ -0,0 +1,3 @@
+import type { Organization } from "schema-dts";
+import { type SchemaBuilder } from "../define-builder";
+export declare const buildOrganization: SchemaBuilder<Organization>;

package/dist/builders/person.d.ts

@@ -0,0 +1,3 @@
+import type { Person } from "schema-dts";
+import { type SchemaBuilder } from "../define-builder";
+export declare const buildPerson: SchemaBuilder<Person>;

package/dist/builders/place.d.ts

@@ -0,0 +1,3 @@
+import type { Place } from "schema-dts";
+import { type SchemaBuilder } from "../define-builder";
+export declare const buildPlace: SchemaBuilder<Place>;

package/dist/builders/postal-address.d.ts

@@ -0,0 +1,3 @@
+import type { PostalAddress } from "schema-dts";
+import { type SchemaBuilder } from "../define-builder";
+export declare const buildPostalAddress: SchemaBuilder<PostalAddress>;

package/dist/builders/quantitative-value.d.ts

@@ -0,0 +1,3 @@
+import type { QuantitativeValue } from "schema-dts";
+import { type SchemaBuilder } from "../define-builder";
+export declare const buildQuantitativeValue: SchemaBuilder<QuantitativeValue>;

package/dist/builders/schedule.d.ts

@@ -0,0 +1,3 @@
+import type { Schedule } from "schema-dts";
+import { type SchemaBuilder } from "../define-builder";
+export declare const buildSchedule: SchemaBuilder<Schedule>;

package/dist/identity-ref.d.ts

@@ -0,0 +1,4 @@
+export declare const IDENTITY_REF_ID = "@identity";
+export declare const identityRef: {
+    readonly "@id": "@identity";
+};

package/dist/index.d.ts

@@ -2,3 +2,7 @@ export type { BuildSchemaMarkupInput, Identity, LocalBusinessIdentity, Organizat
 export { buildSchemaMarkup } from "./build";
 export * from "./builders";
 export type { BuilderInput } from "./define-builder";
+export { identityRef } from "./identity-ref";
+export { type DurationParts, toIsoDate, toIsoDuration } from "./utils/datetime";
+export { buildImageObject, type ImageInput } from "./utils/image";
+export { toAbsoluteUrl } from "./utils/url";

package/dist/index.js

@@ -1,237 +1,3 @@
-// src/builders/fragments.ts
-function normalizeId(name) {
-  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
-}
-function createSchemaId({
-  kind,
-  name,
-  baseUrl = "",
-  explicitId
-}) {
-  if (explicitId) {
-    return explicitId.startsWith("http") ? explicitId : `${baseUrl}${explicitId}`;
-  }
-  return `${baseUrl}#${kind}-${normalizeId(name)}`;
-}
-
-// src/utils/image.ts
-function buildImageObject(input) {
-  if (!input) {
-    return;
-  }
-  if (typeof input === "string") {
-    return {
-      "@type": "ImageObject",
-      url: input
-    };
-  }
-  return {
-    "@type": "ImageObject",
-    url: input.url,
-    width: input.width,
-    height: input.height
-  };
-}
-
-// src/build.ts
-var TYPE_PRIORITY = [
-  "Organization",
-  "Person",
-  "LocalBusiness",
-  "WebSite",
-  "WebPage",
-  "ProfilePage",
-  "QAPage",
-  "BreadcrumbList",
-  "Article",
-  "Course",
-  "Dataset",
-  "DiscussionForumPosting",
-  "JobPosting",
-  "Movie",
-  "Product",
-  "Recipe",
-  "SoftwareApplication",
-  "VacationRental",
-  "VideoObject",
-  "Event",
-  "ItemList",
-  "Question",
-  "Answer",
-  "Review",
-  "Comment",
-  "AggregateRating"
-];
-var typeWeight = new Map(TYPE_PRIORITY.map((type, index) => [type, index]));
-var hasObjectShape = (value) => {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-};
-var hasType = (value) => {
-  return typeof value["@type"] === "string";
-};
-var hasId = (value) => {
-  return typeof value["@id"] === "string" && value["@id"].length > 0;
-};
-var ensureContext = (node) => {
-  if (hasType(node) && node["@context"] === undefined) {
-    return {
-      "@context": "https://schema.org",
-      ...node
-    };
-  }
-  return node;
-};
-var assembleNodes = (nodes) => {
-  const collected = [];
-  const seenIds = new Set;
-  const processingIds = new Set;
-  let orderCounter = 0;
-  const addNode = (node) => {
-    const normalized = ensureContext(node);
-    if (hasId(normalized)) {
-      if (seenIds.has(normalized["@id"]))
-        return;
-      seenIds.add(normalized["@id"]);
-    }
-    collected.push({
-      node: normalized,
-      order: orderCounter++
-    });
-  };
-  const processValue = (value, isRoot = false) => {
-    if (Array.isArray(value)) {
-      return value.map((item) => processValue(item, false));
-    }
-    if (!hasObjectShape(value))
-      return value;
-    if (!isRoot && hasType(value) && hasId(value)) {
-      registerEntity(value);
-      return { "@id": value["@id"] };
-    }
-    const output = {};
-    for (const [key, child] of Object.entries(value)) {
-      output[key] = processValue(child, false);
-    }
-    return output;
-  };
-  const registerEntity = (entity) => {
-    const id = entity["@id"];
-    if (seenIds.has(id) || processingIds.has(id))
-      return;
-    processingIds.add(id);
-    const processedEntity = processValue(entity, true);
-    if (hasObjectShape(processedEntity)) {
-      addNode(processedEntity);
-    }
-    processingIds.delete(id);
-  };
-  for (const node of nodes) {
-    if (!node)
-      continue;
-    const processed = processValue(node, true);
-    if (!hasObjectShape(processed))
-      continue;
-    addNode(processed);
-  }
-  const ranked = collected.sort((a, b) => {
-    const aType = hasType(a.node) ? a.node["@type"] : "";
-    const bType = hasType(b.node) ? b.node["@type"] : "";
-    const aWeight = typeWeight.get(aType) ?? Number.MAX_SAFE_INTEGER;
-    const bWeight = typeWeight.get(bType) ?? Number.MAX_SAFE_INTEGER;
-    if (aWeight !== bWeight)
-      return aWeight - bWeight;
-    return a.order - b.order;
-  });
-  return ranked.map(({ node }) => JSON.stringify(node));
-};
-var buildIdentityNodes = (identity, siteUrl) => {
-  switch (identity.type) {
-    case "person": {
-      const id = createSchemaId({
-        kind: "person",
-        name: identity.name,
-        baseUrl: siteUrl
-      });
-      return {
-        node: {
-          "@type": "Person",
-          "@id": id,
-          name: identity.name,
-          description: identity.description,
-          image: buildImageObject(identity.image),
-          sameAs: identity.sameAs,
-          url: siteUrl
-        },
-        ref: { "@id": id }
-      };
-    }
-    case "organization": {
-      const id = createSchemaId({
-        kind: "organization",
-        name: identity.name,
-        baseUrl: siteUrl
-      });
-      return {
-        node: {
-          "@type": "Organization",
-          "@id": id,
-          name: identity.name,
-          description: identity.description,
-          logo: buildImageObject(identity.logo),
-          sameAs: identity.sameAs,
-          url: siteUrl
-        },
-        ref: { "@id": id }
-      };
-    }
-    case "localBusiness": {
-      const id = createSchemaId({
-        kind: "local-business",
-        name: identity.name,
-        baseUrl: siteUrl
-      });
-      return {
-        node: {
-          "@type": "LocalBusiness",
-          "@id": id,
-          name: identity.name,
-          description: identity.description,
-          logo: buildImageObject(identity.logo),
-          telephone: identity.phone,
-          email: identity.email,
-          address: identity.address,
-          openingHoursSpecification: identity.openingHours,
-          sameAs: identity.sameAs,
-          url: siteUrl
-        },
-        ref: { "@id": id }
-      };
-    }
-  }
-};
-var buildSchemaMarkup = (input) => {
-  const { node: identityNode, ref: identityRef } = buildIdentityNodes(input.identity, input.siteUrl);
-  const websiteId = `${input.siteUrl}#website`;
-  const websiteNode = {
-    "@type": "WebSite",
-    "@id": websiteId,
-    name: input.siteName,
-    url: input.siteUrl,
-    description: input.siteDescription,
-    publisher: identityRef
-  };
-  const webpageNode = {
-    "@type": "WebPage",
-    "@id": `${input.pageUrl}#webpage`,
-    url: input.pageUrl,
-    name: input.pageTitle,
-    description: input.pageDescription,
-    isPartOf: { "@id": websiteId },
-    breadcrumb: input.breadcrumb,
-    mainEntity: input.mainEntity
-  };
-  return assembleNodes([identityNode, websiteNode, webpageNode]);
-};
 // src/define-builder.ts
 function defineBuilder(type) {
   return (input) => ({
@@ -243,12 +9,22 @@ function defineBuilder(type) {
 
 // src/builders/about-page.ts
 var buildAboutPage = defineBuilder("AboutPage");
+
+// src/builders/aggregate-offer.ts
+var buildAggregateOffer = defineBuilder("AggregateOffer");
+
 // src/builders/aggregate-rating.ts
 var buildAggregateRating = defineBuilder("AggregateRating");
+
 // src/builders/answer.ts
 var buildAnswer = defineBuilder("Answer");
+
 // src/builders/article.ts
 var buildArticle = defineBuilder("Article");
+
+// src/builders/brand.ts
+var buildBrand = defineBuilder("Brand");
+
 // src/builders/internal/slug-to-title.ts
 function slugToTitle(segment) {
   const decoded = decodeURIComponent(segment || "");
@@ -304,80 +80,165 @@ function buildBreadcrumbListSchema({
     itemListElement: toListItems(finalItems)
   };
 }
+
 // src/builders/comment.ts
 var buildComment = defineBuilder("Comment");
+
 // src/builders/contact-page.ts
 var buildContactPage = defineBuilder("ContactPage");
+
 // src/builders/course.ts
 var buildCourse = defineBuilder("Course");
+
+// src/builders/course-instance.ts
+var buildCourseInstance = defineBuilder("CourseInstance");
+
 // src/builders/dataset.ts
 var buildDataset = defineBuilder("Dataset");
+
 // src/builders/discussion-forum-posting.ts
 var buildDiscussionForumPosting = defineBuilder("DiscussionForumPosting");
+
 // src/builders/event.ts
 var buildEvent = defineBuilder("Event");
+
 // src/builders/faq.ts
 var buildFAQPage = defineBuilder("FAQPage");
+
+// src/builders/geo-coordinates.ts
+var buildGeoCoordinates = defineBuilder("GeoCoordinates");
+
+// src/builders/how-to-step.ts
+var buildHowToStep = defineBuilder("HowToStep");
+
 // src/builders/item-list.ts
 var buildItemList = defineBuilder("ItemList");
+
 // src/builders/job-posting.ts
 var buildJobPosting = defineBuilder("JobPosting");
+
 // src/builders/local-business.ts
 var buildLocalBusiness = defineBuilder("LocalBusiness");
+
+// src/builders/merchant-return-policy.ts
+var buildMerchantReturnPolicy = defineBuilder("MerchantReturnPolicy");
+
+// src/builders/monetary-amount.ts
+var buildMonetaryAmount = defineBuilder("MonetaryAmount");
+
 // src/builders/movie.ts
 var buildMovie = defineBuilder("Movie");
+
+// src/builders/nutrition-information.ts
+var buildNutritionInformation = defineBuilder("NutritionInformation");
+
+// src/builders/offer.ts
+var buildOffer = defineBuilder("Offer");
+
+// src/builders/offer-shipping-details.ts
+var buildOfferShippingDetails = defineBuilder("OfferShippingDetails");
+
+// src/builders/organization.ts
+var buildOrganization = defineBuilder("Organization");
+
+// src/builders/person.ts
+var buildPerson = defineBuilder("Person");
+
+// src/builders/place.ts
+var buildPlace = defineBuilder("Place");
+
+// src/builders/postal-address.ts
+var buildPostalAddress = defineBuilder("PostalAddress");
+
 // src/builders/product.ts
 var buildProduct = defineBuilder("Product");
+
 // src/builders/profile-page.ts
 var buildProfilePage = defineBuilder("ProfilePage");
+
 // src/builders/qa-page.ts
 var buildQAPage = defineBuilder("QAPage");
+
+// src/builders/quantitative-value.ts
+var buildQuantitativeValue = defineBuilder("QuantitativeValue");
+
 // src/builders/question.ts
 var buildQuestion = defineBuilder("Question");
+
 // src/builders/recipe.ts
 var buildRecipe = defineBuilder("Recipe");
+
 // src/builders/review.ts
 var buildReview = defineBuilder("Review");
+
+// src/builders/schedule.ts
+var buildSchedule = defineBuilder("Schedule");
+
 // src/builders/software-application.ts
 var buildSoftwareApplication = defineBuilder("SoftwareApplication");
+
 // src/builders/vacation-rental.ts
 var buildVacationRental = defineBuilder("VacationRental");
+
 // src/builders/video-object.ts
 var buildVideoObject = defineBuilder("VideoObject");
+
 // src/builders/webpage.ts
 var buildWebPage = defineBuilder("WebPage");
+
 // src/builders/website.ts
 var buildWebSite = defineBuilder("WebSite");
 export {
-  buildWebSite,
-  buildWebPage,
-  buildVideoObject,
-  buildVacationRental,
-  buildSoftwareApplication,
-  buildSchemaMarkup,
-  buildReview,
-  buildRecipe,
-  buildQuestion,
-  buildQAPage,
-  buildProfilePage,
-  buildProduct,
-  buildMovie,
-  buildLocalBusiness,
-  buildJobPosting,
-  buildItemList,
-  buildFAQPage,
-  buildEvent,
-  buildDiscussionForumPosting,
-  buildDataset,
-  buildCourse,
-  buildContactPage,
-  buildComment,
-  buildBreadcrumbListSchema,
-  buildArticle,
-  buildAnswer,
+  buildAboutPage,
+  buildAggregateOffer,
   buildAggregateRating,
-  buildAboutPage
+  buildAnswer,
+  buildArticle,
+  buildBrand,
+  buildBreadcrumbListSchema,
+  buildComment,
+  buildContactPage,
+  buildCourse,
+  buildCourseInstance,
+  buildDataset,
+  buildDiscussionForumPosting,
+  buildEvent,
+  buildFAQPage,
+  buildGeoCoordinates,
+  buildHowToStep,
+  buildImageObject,
+  buildItemList,
+  buildJobPosting,
+  buildLocalBusiness,
+  buildMerchantReturnPolicy,
+  buildMonetaryAmount,
+  buildMovie,
+  buildNutritionInformation,
+  buildOffer,
+  buildOfferShippingDetails,
+  buildOrganization,
+  buildPerson,
+  buildPlace,
+  buildPostalAddress,
+  buildProduct,
+  buildProfilePage,
+  buildQAPage,
+  buildQuantitativeValue,
+  buildQuestion,
+  buildRecipe,
+  buildReview,
+  buildSchedule,
+  buildSchemaMarkup,
+  buildSoftwareApplication,
+  buildVacationRental,
+  buildVideoObject,
+  buildWebPage,
+  buildWebSite,
+  identityRef,
+  toAbsoluteUrl,
+  toIsoDate,
+  toIsoDuration
 };
 
-//# debugId=5F889F4F897E1F2564756E2164756E21
+//# debugId=AC1EB3C8028F80A664756E2164756E21
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1,41 +1,54 @@
 {
   "version": 3,
-  "sources": ["../src/builders/fragments.ts", "../src/utils/image.ts", "../src/build.ts", "../src/define-builder.ts", "../src/builders/about-page.ts", "../src/builders/aggregate-rating.ts", "../src/builders/answer.ts", "../src/builders/article.ts", "../src/builders/internal/slug-to-title.ts", "../src/builders/breadcrumb-list.ts", "../src/builders/comment.ts", "../src/builders/contact-page.ts", "../src/builders/course.ts", "../src/builders/dataset.ts", "../src/builders/discussion-forum-posting.ts", "../src/builders/event.ts", "../src/builders/faq.ts", "../src/builders/item-list.ts", "../src/builders/job-posting.ts", "../src/builders/local-business.ts", "../src/builders/movie.ts", "../src/builders/product.ts", "../src/builders/profile-page.ts", "../src/builders/qa-page.ts", "../src/builders/question.ts", "../src/builders/recipe.ts", "../src/builders/review.ts", "../src/builders/software-application.ts", "../src/builders/vacation-rental.ts", "../src/builders/video-object.ts", "../src/builders/webpage.ts", "../src/builders/website.ts"],
+  "sources": ["../src/define-builder.ts", "../src/builders/about-page.ts", "../src/builders/aggregate-offer.ts", "../src/builders/aggregate-rating.ts", "../src/builders/answer.ts", "../src/builders/article.ts", "../src/builders/brand.ts", "../src/builders/internal/slug-to-title.ts", "../src/builders/breadcrumb-list.ts", "../src/builders/comment.ts", "../src/builders/contact-page.ts", "../src/builders/course.ts", "../src/builders/course-instance.ts", "../src/builders/dataset.ts", "../src/builders/discussion-forum-posting.ts", "../src/builders/event.ts", "../src/builders/faq.ts", "../src/builders/geo-coordinates.ts", "../src/builders/how-to-step.ts", "../src/builders/item-list.ts", "../src/builders/job-posting.ts", "../src/builders/local-business.ts", "../src/builders/merchant-return-policy.ts", "../src/builders/monetary-amount.ts", "../src/builders/movie.ts", "../src/builders/nutrition-information.ts", "../src/builders/offer.ts", "../src/builders/offer-shipping-details.ts", "../src/builders/organization.ts", "../src/builders/person.ts", "../src/builders/place.ts", "../src/builders/postal-address.ts", "../src/builders/product.ts", "../src/builders/profile-page.ts", "../src/builders/qa-page.ts", "../src/builders/quantitative-value.ts", "../src/builders/question.ts", "../src/builders/recipe.ts", "../src/builders/review.ts", "../src/builders/schedule.ts", "../src/builders/software-application.ts", "../src/builders/vacation-rental.ts", "../src/builders/video-object.ts", "../src/builders/webpage.ts", "../src/builders/website.ts"],
   "sourcesContent": [
-    "type IdReference = { \"@id\": string };\n\ntype SchemaIdOptions = {\n\tkind: string;\n\tname: string;\n\tbaseUrl?: string;\n\texplicitId?: string;\n};\n\nexport function normalizeId(name: string): string {\n\treturn name\n\t\t.toLowerCase()\n\t\t.replace(/[^a-z0-9]+/g, \"-\")\n\t\t.replace(/^-|-$/g, \"\");\n}\n\nexport function createSchemaId({\n\tkind,\n\tname,\n\tbaseUrl = \"\",\n\texplicitId,\n}: SchemaIdOptions): string {\n\tif (explicitId) {\n\t\treturn explicitId.startsWith(\"http\")\n\t\t\t? explicitId\n\t\t\t: `${baseUrl}${explicitId}`;\n\t}\n\n\treturn `${baseUrl}#${kind}-${normalizeId(name)}`;\n}\n\nexport function asIdReference(id: string): IdReference {\n\treturn { \"@id\": id };\n}\n",
-    "type ImageObjectInput = {\n\turl: string;\n\twidth?: number;\n\theight?: number;\n};\n\nexport type ImageInput = string | ImageObjectInput;\n\nexport function buildImageObject(\n\tinput?: ImageInput,\n): Record<string, unknown> | undefined {\n\tif (!input) {\n\t\treturn undefined;\n\t}\n\n\tif (typeof input === \"string\") {\n\t\treturn {\n\t\t\t\"@type\": \"ImageObject\",\n\t\t\turl: input,\n\t\t};\n\t}\n\n\treturn {\n\t\t\"@type\": \"ImageObject\",\n\t\turl: input.url,\n\t\twidth: input.width,\n\t\theight: input.height,\n\t};\n}\n",
-    "import type {\n\tBreadcrumbList,\n\tOpeningHoursSpecification,\n\tPostalAddress,\n\tThing,\n\tWithContext,\n} from \"schema-dts\";\nimport { createSchemaId } from \"./builders/fragments\";\nimport { buildImageObject, type ImageInput } from \"./utils/image\";\n\ntype SchemaNode = Record<string, unknown>;\n\nexport type BuildSchemaMarkupInput = {\n\tidentity: Identity;\n\tsiteUrl: string;\n\tsiteName: string;\n\tsiteDescription?: string;\n\tpageUrl: string;\n\tpageTitle: string;\n\tpageDescription?: string;\n\tbreadcrumb?: WithContext<BreadcrumbList>;\n\tmainEntity?: Thing | SchemaNode;\n};\n\nexport type PersonIdentity = {\n\ttype: \"person\";\n\tname: string;\n\tdescription?: string;\n\timage?: ImageInput;\n\tsameAs?: string[];\n};\n\nexport type OrganizationIdentity = {\n\ttype: \"organization\";\n\tname: string;\n\tdescription?: string;\n\tlogo?: ImageInput;\n\tsameAs?: string[];\n};\n\nexport type LocalBusinessIdentity = {\n\ttype: \"localBusiness\";\n\tname: string;\n\tdescription?: string;\n\tlogo?: ImageInput;\n\tphone?: string;\n\temail?: string;\n\taddress?: PostalAddress;\n\topeningHours?: OpeningHoursSpecification[];\n\tsameAs?: string[];\n};\n\nexport type Identity =\n\t| PersonIdentity\n\t| OrganizationIdentity\n\t| LocalBusinessIdentity;\n\nconst TYPE_PRIORITY = [\n\t\"Organization\",\n\t\"Person\",\n\t\"LocalBusiness\",\n\t\"WebSite\",\n\t\"WebPage\",\n\t\"ProfilePage\",\n\t\"QAPage\",\n\t\"BreadcrumbList\",\n\t\"Article\",\n\t\"Course\",\n\t\"Dataset\",\n\t\"DiscussionForumPosting\",\n\t\"JobPosting\",\n\t\"Movie\",\n\t\"Product\",\n\t\"Recipe\",\n\t\"SoftwareApplication\",\n\t\"VacationRental\",\n\t\"VideoObject\",\n\t\"Event\",\n\t\"ItemList\",\n\t\"Question\",\n\t\"Answer\",\n\t\"Review\",\n\t\"Comment\",\n\t\"AggregateRating\",\n] as const;\n\nconst typeWeight = new Map<string, number>(\n\tTYPE_PRIORITY.map((type, index) => [type, index]),\n);\n\nconst hasObjectShape = (value: unknown): value is SchemaNode => {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n};\n\nconst hasType = (value: SchemaNode): value is SchemaNode & { \"@type\": string } => {\n\treturn typeof value[\"@type\"] === \"string\";\n};\n\nconst hasId = (value: SchemaNode): value is SchemaNode & { \"@id\": string } => {\n\treturn typeof value[\"@id\"] === \"string\" && value[\"@id\"].length > 0;\n};\n\nconst ensureContext = (node: SchemaNode): SchemaNode => {\n\tif (hasType(node) && node[\"@context\"] === undefined) {\n\t\treturn {\n\t\t\t\"@context\": \"https://schema.org\",\n\t\t\t...node,\n\t\t};\n\t}\n\n\treturn node;\n};\n\ntype RankedNode = {\n\tnode: SchemaNode;\n\torder: number;\n};\n\nconst assembleNodes = (nodes: Array<Thing | SchemaNode | undefined>): string[] => {\n\tconst collected: RankedNode[] = [];\n\tconst seenIds = new Set<string>();\n\tconst processingIds = new Set<string>();\n\tlet orderCounter = 0;\n\n\tconst addNode = (node: SchemaNode) => {\n\t\tconst normalized = ensureContext(node);\n\t\tif (hasId(normalized)) {\n\t\t\tif (seenIds.has(normalized[\"@id\"])) return;\n\t\t\tseenIds.add(normalized[\"@id\"]);\n\t\t}\n\n\t\tcollected.push({\n\t\t\tnode: normalized,\n\t\t\torder: orderCounter++,\n\t\t});\n\t};\n\n\tconst processValue = (value: unknown, isRoot = false): unknown => {\n\t\tif (Array.isArray(value)) {\n\t\t\treturn value.map((item) => processValue(item, false));\n\t\t}\n\n\t\tif (!hasObjectShape(value)) return value;\n\n\t\tif (!isRoot && hasType(value) && hasId(value)) {\n\t\t\tregisterEntity(value);\n\t\t\treturn { \"@id\": value[\"@id\"] };\n\t\t}\n\n\t\tconst output: SchemaNode = {};\n\t\tfor (const [key, child] of Object.entries(value)) {\n\t\t\toutput[key] = processValue(child, false);\n\t\t}\n\t\treturn output;\n\t};\n\n\tconst registerEntity = (entity: SchemaNode & { \"@id\": string }) => {\n\t\tconst id = entity[\"@id\"];\n\t\tif (seenIds.has(id) || processingIds.has(id)) return;\n\n\t\tprocessingIds.add(id);\n\t\tconst processedEntity = processValue(entity, true);\n\t\tif (hasObjectShape(processedEntity)) {\n\t\t\taddNode(processedEntity);\n\t\t}\n\t\tprocessingIds.delete(id);\n\t};\n\n\tfor (const node of nodes) {\n\t\tif (!node) continue;\n\t\tconst processed = processValue(node, true);\n\t\tif (!hasObjectShape(processed)) continue;\n\t\taddNode(processed);\n\t}\n\n\tconst ranked = collected.sort((a, b) => {\n\t\tconst aType = hasType(a.node) ? a.node[\"@type\"] : \"\";\n\t\tconst bType = hasType(b.node) ? b.node[\"@type\"] : \"\";\n\t\tconst aWeight = typeWeight.get(aType) ?? Number.MAX_SAFE_INTEGER;\n\t\tconst bWeight = typeWeight.get(bType) ?? Number.MAX_SAFE_INTEGER;\n\n\t\tif (aWeight !== bWeight) return aWeight - bWeight;\n\t\treturn a.order - b.order;\n\t});\n\n\treturn ranked.map(({ node }) => JSON.stringify(node));\n};\n\nconst buildIdentityNodes = (\n\tidentity: Identity,\n\tsiteUrl: string,\n): { node: SchemaNode; ref: { \"@id\": string } } => {\n\tswitch (identity.type) {\n\t\tcase \"person\": {\n\t\t\tconst id = createSchemaId({\n\t\t\t\tkind: \"person\",\n\t\t\t\tname: identity.name,\n\t\t\t\tbaseUrl: siteUrl,\n\t\t\t});\n\t\t\treturn {\n\t\t\t\tnode: {\n\t\t\t\t\t\"@type\": \"Person\",\n\t\t\t\t\t\"@id\": id,\n\t\t\t\t\tname: identity.name,\n\t\t\t\t\tdescription: identity.description,\n\t\t\t\t\timage: buildImageObject(identity.image),\n\t\t\t\t\tsameAs: identity.sameAs,\n\t\t\t\t\turl: siteUrl,\n\t\t\t\t},\n\t\t\t\tref: { \"@id\": id },\n\t\t\t};\n\t\t}\n\t\tcase \"organization\": {\n\t\t\tconst id = createSchemaId({\n\t\t\t\tkind: \"organization\",\n\t\t\t\tname: identity.name,\n\t\t\t\tbaseUrl: siteUrl,\n\t\t\t});\n\t\t\treturn {\n\t\t\t\tnode: {\n\t\t\t\t\t\"@type\": \"Organization\",\n\t\t\t\t\t\"@id\": id,\n\t\t\t\t\tname: identity.name,\n\t\t\t\t\tdescription: identity.description,\n\t\t\t\t\tlogo: buildImageObject(identity.logo),\n\t\t\t\t\tsameAs: identity.sameAs,\n\t\t\t\t\turl: siteUrl,\n\t\t\t\t},\n\t\t\t\tref: { \"@id\": id },\n\t\t\t};\n\t\t}\n\t\tcase \"localBusiness\": {\n\t\t\tconst id = createSchemaId({\n\t\t\t\tkind: \"local-business\",\n\t\t\t\tname: identity.name,\n\t\t\t\tbaseUrl: siteUrl,\n\t\t\t});\n\t\t\treturn {\n\t\t\t\tnode: {\n\t\t\t\t\t\"@type\": \"LocalBusiness\",\n\t\t\t\t\t\"@id\": id,\n\t\t\t\t\tname: identity.name,\n\t\t\t\t\tdescription: identity.description,\n\t\t\t\t\tlogo: buildImageObject(identity.logo),\n\t\t\t\t\ttelephone: identity.phone,\n\t\t\t\t\temail: identity.email,\n\t\t\t\t\taddress: identity.address,\n\t\t\t\t\topeningHoursSpecification: identity.openingHours,\n\t\t\t\t\tsameAs: identity.sameAs,\n\t\t\t\t\turl: siteUrl,\n\t\t\t\t},\n\t\t\t\tref: { \"@id\": id },\n\t\t\t};\n\t\t}\n\t}\n};\n\nexport const buildSchemaMarkup = (input: BuildSchemaMarkupInput): string[] => {\n\tconst { node: identityNode, ref: identityRef } = buildIdentityNodes(\n\t\tinput.identity,\n\t\tinput.siteUrl,\n\t);\n\tconst websiteId = `${input.siteUrl}#website`;\n\n\tconst websiteNode: SchemaNode = {\n\t\t\"@type\": \"WebSite\",\n\t\t\"@id\": websiteId,\n\t\tname: input.siteName,\n\t\turl: input.siteUrl,\n\t\tdescription: input.siteDescription,\n\t\tpublisher: identityRef,\n\t};\n\n\tconst webpageNode: SchemaNode = {\n\t\t\"@type\": \"WebPage\",\n\t\t\"@id\": `${input.pageUrl}#webpage`,\n\t\turl: input.pageUrl,\n\t\tname: input.pageTitle,\n\t\tdescription: input.pageDescription,\n\t\tisPartOf: { \"@id\": websiteId },\n\t\tbreadcrumb: input.breadcrumb,\n\t\tmainEntity: input.mainEntity,\n\t};\n\n\treturn assembleNodes([identityNode, websiteNode, webpageNode]);\n};\n",
     "import type { Thing, WithContext } from \"schema-dts\";\n\ntype Simplify<T> = { [K in keyof T]: T[K] } & {};\n\nexport type BuilderInput<T extends Thing> = Simplify<\n\tOmit<T, \"@type\" | \"@context\">\n>;\n\nexport type SchemaBuilder<T extends Thing> = (\n\tinput: BuilderInput<T>,\n) => WithContext<T>;\n\nexport function defineBuilder<T extends Thing>(type: string): SchemaBuilder<T> {\n\treturn (input: BuilderInput<T>) =>\n\t\t({\n\t\t\t\"@context\": \"https://schema.org\",\n\t\t\t\"@type\": type,\n\t\t\t...input,\n\t\t}) as unknown as WithContext<T>;\n}\n",
     "import type { AboutPage } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildAboutPage: SchemaBuilder<AboutPage> =\n\tdefineBuilder<AboutPage>(\"AboutPage\");\n",
+    "import type { AggregateOffer } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildAggregateOffer: SchemaBuilder<AggregateOffer> =\n\tdefineBuilder<AggregateOffer>(\"AggregateOffer\");\n",
     "import type { AggregateRating } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildAggregateRating: SchemaBuilder<AggregateRating> =\n\tdefineBuilder<AggregateRating>(\"AggregateRating\");\n",
-    "import type { Answer } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildAnswer: SchemaBuilder<Answer> = defineBuilder<Answer>(\"Answer\");\n",
+    "import type { Answer } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildAnswer: SchemaBuilder<Answer> =\n\tdefineBuilder<Answer>(\"Answer\");\n",
     "import type { Article } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildArticle: SchemaBuilder<Article> =\n\tdefineBuilder<Article>(\"Article\");\n",
-    "export function slugToTitle(segment: string): string {\n\tconst decoded = decodeURIComponent(segment || \"\");\n\tconst normalized = decoded\n\t\t.replace(/[-_]+/g, \" \")\n\t\t.replace(/\\s+/g, \" \")\n\t\t.trim();\n\n\tif (!normalized) return \"\";\n\n\treturn normalized.replace(/\\b\\w/g, (char) => char.toUpperCase());\n}\n",
-    "import type { BreadcrumbList, ListItem, WithContext } from \"schema-dts\";\nimport { slugToTitle } from \"./internal/slug-to-title\";\n\nexport type BreadcrumbItemInput = {\n\ttitle: string;\n\turl: string;\n};\n\nexport type BuildBreadcrumbListSchemaInput = {\n\tpagePath: string;\n\tpageTitle: string;\n\titems?: BreadcrumbItemInput[];\n};\n\nfunction normalizePath(path: string): string {\n\tif (!path) return \"/\";\n\tconst withoutHash = path.split(\"#\")[0];\n\tconst withoutQuery = withoutHash.split(\"?\")[0];\n\tconst prefixed = withoutQuery.startsWith(\"/\") ? withoutQuery : `/${withoutQuery}`;\n\treturn prefixed.replace(/\\/+$/, \"\") || \"/\";\n}\n\nfunction createDerivedParentItems(pagePath: string): BreadcrumbItemInput[] {\n\tconst normalized = normalizePath(pagePath);\n\tconst segments = normalized.split(\"/\").filter(Boolean);\n\n\tif (segments.length <= 1) return [];\n\n\treturn segments.slice(0, -1).map((segment, index) => ({\n\t\ttitle: slugToTitle(segment),\n\t\turl: `/${segments.slice(0, index + 1).join(\"/\")}`,\n\t}));\n}\n\nfunction toListItems(items: BreadcrumbItemInput[]): ListItem[] {\n\treturn items.map((item, index) => ({\n\t\t\"@type\": \"ListItem\",\n\t\tposition: index + 1,\n\t\tname: item.title,\n\t\titem: item.url,\n\t}));\n}\n\nexport function buildBreadcrumbListSchema({\n\tpagePath,\n\tpageTitle,\n\titems,\n}: BuildBreadcrumbListSchemaInput): WithContext<BreadcrumbList> {\n\tconst parentItems = items?.length ? items : createDerivedParentItems(pagePath);\n\tconst finalItems = [\n\t\t...parentItems,\n\t\t{\n\t\t\ttitle: pageTitle,\n\t\t\turl: normalizePath(pagePath),\n\t\t},\n\t];\n\n\treturn {\n\t\t\"@context\": \"https://schema.org\",\n\t\t\"@type\": \"BreadcrumbList\",\n\t\titemListElement: toListItems(finalItems),\n\t};\n}\n",
+    "import type { Brand } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildBrand: SchemaBuilder<Brand> = defineBuilder<Brand>(\"Brand\");\n",
+    "export function slugToTitle(segment: string): string {\n\tconst decoded = decodeURIComponent(segment || \"\");\n\tconst normalized = decoded.replace(/[-_]+/g, \" \").replace(/\\s+/g, \" \").trim();\n\n\tif (!normalized) return \"\";\n\n\treturn normalized.replace(/\\b\\w/g, (char) => char.toUpperCase());\n}\n",
+    "import type { BreadcrumbList, ListItem, WithContext } from \"schema-dts\";\nimport { slugToTitle } from \"./internal/slug-to-title\";\n\nexport type BreadcrumbItemInput = {\n\ttitle: string;\n\turl: string;\n};\n\nexport type BuildBreadcrumbListSchemaInput = {\n\tpagePath: string;\n\tpageTitle: string;\n\titems?: BreadcrumbItemInput[];\n};\n\nfunction normalizePath(path: string): string {\n\tif (!path) return \"/\";\n\tconst withoutHash = path.split(\"#\")[0];\n\tconst withoutQuery = withoutHash.split(\"?\")[0];\n\tconst prefixed = withoutQuery.startsWith(\"/\")\n\t\t? withoutQuery\n\t\t: `/${withoutQuery}`;\n\treturn prefixed.replace(/\\/+$/, \"\") || \"/\";\n}\n\nfunction createDerivedParentItems(pagePath: string): BreadcrumbItemInput[] {\n\tconst normalized = normalizePath(pagePath);\n\tconst segments = normalized.split(\"/\").filter(Boolean);\n\n\tif (segments.length <= 1) return [];\n\n\treturn segments.slice(0, -1).map((segment, index) => ({\n\t\ttitle: slugToTitle(segment),\n\t\turl: `/${segments.slice(0, index + 1).join(\"/\")}`,\n\t}));\n}\n\nfunction toListItems(items: BreadcrumbItemInput[]): ListItem[] {\n\treturn items.map((item, index) => ({\n\t\t\"@type\": \"ListItem\",\n\t\tposition: index + 1,\n\t\tname: item.title,\n\t\titem: item.url,\n\t}));\n}\n\nexport function buildBreadcrumbListSchema({\n\tpagePath,\n\tpageTitle,\n\titems,\n}: BuildBreadcrumbListSchemaInput): WithContext<BreadcrumbList> {\n\tconst parentItems = items?.length\n\t\t? items\n\t\t: createDerivedParentItems(pagePath);\n\tconst finalItems = [\n\t\t...parentItems,\n\t\t{\n\t\t\ttitle: pageTitle,\n\t\t\turl: normalizePath(pagePath),\n\t\t},\n\t];\n\n\treturn {\n\t\t\"@context\": \"https://schema.org\",\n\t\t\"@type\": \"BreadcrumbList\",\n\t\titemListElement: toListItems(finalItems),\n\t};\n}\n",
     "import type { Comment } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildComment: SchemaBuilder<Comment> =\n\tdefineBuilder<Comment>(\"Comment\");\n",
     "import type { ContactPage } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildContactPage: SchemaBuilder<ContactPage> =\n\tdefineBuilder<ContactPage>(\"ContactPage\");\n",
-    "import type { Course } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildCourse: SchemaBuilder<Course> = defineBuilder<Course>(\"Course\");\n",
+    "import type { Course } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildCourse: SchemaBuilder<Course> =\n\tdefineBuilder<Course>(\"Course\");\n",
+    "import type { CourseInstance } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildCourseInstance: SchemaBuilder<CourseInstance> =\n\tdefineBuilder<CourseInstance>(\"CourseInstance\");\n",
     "import type { Dataset } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildDataset: SchemaBuilder<Dataset> =\n\tdefineBuilder<Dataset>(\"Dataset\");\n",
     "import type { DiscussionForumPosting } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildDiscussionForumPosting: SchemaBuilder<DiscussionForumPosting> =\n\tdefineBuilder<DiscussionForumPosting>(\"DiscussionForumPosting\");\n",
     "import type { Event } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildEvent: SchemaBuilder<Event> = defineBuilder<Event>(\"Event\");\n",
     "import type { FAQPage } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildFAQPage: SchemaBuilder<FAQPage> =\n\tdefineBuilder<FAQPage>(\"FAQPage\");\n",
+    "import type { GeoCoordinates } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildGeoCoordinates: SchemaBuilder<GeoCoordinates> =\n\tdefineBuilder<GeoCoordinates>(\"GeoCoordinates\");\n",
+    "import type { HowToStep } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildHowToStep: SchemaBuilder<HowToStep> =\n\tdefineBuilder<HowToStep>(\"HowToStep\");\n",
     "import type { ItemList } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildItemList: SchemaBuilder<ItemList> =\n\tdefineBuilder<ItemList>(\"ItemList\");\n",
     "import type { JobPosting } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildJobPosting: SchemaBuilder<JobPosting> =\n\tdefineBuilder<JobPosting>(\"JobPosting\");\n",
     "import type { LocalBusiness } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildLocalBusiness: SchemaBuilder<LocalBusiness> =\n\tdefineBuilder<LocalBusiness>(\"LocalBusiness\");\n",
+    "import type { MerchantReturnPolicy } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildMerchantReturnPolicy: SchemaBuilder<MerchantReturnPolicy> =\n\tdefineBuilder<MerchantReturnPolicy>(\"MerchantReturnPolicy\");\n",
+    "import type { MonetaryAmount } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildMonetaryAmount: SchemaBuilder<MonetaryAmount> =\n\tdefineBuilder<MonetaryAmount>(\"MonetaryAmount\");\n",
     "import type { Movie } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildMovie: SchemaBuilder<Movie> = defineBuilder<Movie>(\"Movie\");\n",
+    "import type { NutritionInformation } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildNutritionInformation: SchemaBuilder<NutritionInformation> =\n\tdefineBuilder<NutritionInformation>(\"NutritionInformation\");\n",
+    "import type { Offer } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildOffer: SchemaBuilder<Offer> = defineBuilder<Offer>(\"Offer\");\n",
+    "import type { OfferShippingDetails } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildOfferShippingDetails: SchemaBuilder<OfferShippingDetails> =\n\tdefineBuilder<OfferShippingDetails>(\"OfferShippingDetails\");\n",
+    "import type { Organization } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildOrganization: SchemaBuilder<Organization> =\n\tdefineBuilder<Organization>(\"Organization\");\n",
+    "import type { Person } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildPerson: SchemaBuilder<Person> =\n\tdefineBuilder<Person>(\"Person\");\n",
+    "import type { Place } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildPlace: SchemaBuilder<Place> = defineBuilder<Place>(\"Place\");\n",
+    "import type { PostalAddress } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildPostalAddress: SchemaBuilder<PostalAddress> =\n\tdefineBuilder<PostalAddress>(\"PostalAddress\");\n",
     "import type { Product } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildProduct: SchemaBuilder<Product> =\n\tdefineBuilder<Product>(\"Product\");\n",
     "import type { ProfilePage } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildProfilePage: SchemaBuilder<ProfilePage> =\n\tdefineBuilder<ProfilePage>(\"ProfilePage\");\n",
-    "import type { QAPage } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildQAPage: SchemaBuilder<QAPage> = defineBuilder<QAPage>(\"QAPage\");\n",
+    "import type { QAPage } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildQAPage: SchemaBuilder<QAPage> =\n\tdefineBuilder<QAPage>(\"QAPage\");\n",
+    "import type { QuantitativeValue } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildQuantitativeValue: SchemaBuilder<QuantitativeValue> =\n\tdefineBuilder<QuantitativeValue>(\"QuantitativeValue\");\n",
     "import type { Question } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildQuestion: SchemaBuilder<Question> =\n\tdefineBuilder<Question>(\"Question\");\n",
-    "import type { Recipe } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildRecipe: SchemaBuilder<Recipe> = defineBuilder<Recipe>(\"Recipe\");\n",
-    "import type { Review } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildReview: SchemaBuilder<Review> = defineBuilder<Review>(\"Review\");\n",
+    "import type { Recipe } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildRecipe: SchemaBuilder<Recipe> =\n\tdefineBuilder<Recipe>(\"Recipe\");\n",
+    "import type { Review } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildReview: SchemaBuilder<Review> =\n\tdefineBuilder<Review>(\"Review\");\n",
+    "import type { Schedule } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildSchedule: SchemaBuilder<Schedule> =\n\tdefineBuilder<Schedule>(\"Schedule\");\n",
     "import type { SoftwareApplication } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildSoftwareApplication: SchemaBuilder<SoftwareApplication> =\n\tdefineBuilder<SoftwareApplication>(\"SoftwareApplication\");\n",
     "import type { VacationRental } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildVacationRental: SchemaBuilder<VacationRental> =\n\tdefineBuilder<VacationRental>(\"VacationRental\");\n",
     "import type { VideoObject } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildVideoObject: SchemaBuilder<VideoObject> =\n\tdefineBuilder<VideoObject>(\"VideoObject\");\n",
     "import type { WebPage } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildWebPage: SchemaBuilder<WebPage> =\n\tdefineBuilder<WebPage>(\"WebPage\");\n",
     "import type { WebSite } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildWebSite: SchemaBuilder<WebSite> =\n\tdefineBuilder<WebSite>(\"WebSite\");\n"
   ],
-  "mappings": "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",
-  "debugId": "5F889F4F897E1F2564756E2164756E21",
+  "mappings": ";AAYO,SAAS,aAA8B,CAAC,MAAgC;AAAA,EAC9E,OAAO,CAAC,WACN;AAAA,IACA,YAAY;AAAA,IACZ,SAAS;AAAA,OACN;AAAA,EACJ;AAAA;;;ACfK,IAAM,iBACZ,cAAyB,WAAW;;;ACD9B,IAAM,sBACZ,cAA8B,gBAAgB;;;ACDxC,IAAM,uBACZ,cAA+B,iBAAiB;;;ACD1C,IAAM,cACZ,cAAsB,QAAQ;;;ACDxB,IAAM,eACZ,cAAuB,SAAS;;;ACD1B,IAAM,aAAmC,cAAqB,OAAO;;;ACHrE,SAAS,WAAW,CAAC,SAAyB;AAAA,EACpD,MAAM,UAAU,mBAAmB,WAAW,EAAE;AAAA,EAChD,MAAM,aAAa,QAAQ,QAAQ,UAAU,GAAG,EAAE,QAAQ,QAAQ,GAAG,EAAE,KAAK;AAAA,EAE5E,IAAI,CAAC;AAAA,IAAY,OAAO;AAAA,EAExB,OAAO,WAAW,QAAQ,SAAS,CAAC,SAAS,KAAK,YAAY,CAAC;AAAA;;;ACQhE,SAAS,aAAa,CAAC,MAAsB;AAAA,EAC5C,IAAI,CAAC;AAAA,IAAM,OAAO;AAAA,EAClB,MAAM,cAAc,KAAK,MAAM,GAAG,EAAE;AAAA,EACpC,MAAM,eAAe,YAAY,MAAM,GAAG,EAAE;AAAA,EAC5C,MAAM,WAAW,aAAa,WAAW,GAAG,IACzC,eACA,IAAI;AAAA,EACP,OAAO,SAAS,QAAQ,QAAQ,EAAE,KAAK;AAAA;AAGxC,SAAS,wBAAwB,CAAC,UAAyC;AAAA,EAC1E,MAAM,aAAa,cAAc,QAAQ;AAAA,EACzC,MAAM,WAAW,WAAW,MAAM,GAAG,EAAE,OAAO,OAAO;AAAA,EAErD,IAAI,SAAS,UAAU;AAAA,IAAG,OAAO,CAAC;AAAA,EAElC,OAAO,SAAS,MAAM,GAAG,EAAE,EAAE,IAAI,CAAC,SAAS,WAAW;AAAA,IACrD,OAAO,YAAY,OAAO;AAAA,IAC1B,KAAK,IAAI,SAAS,MAAM,GAAG,QAAQ,CAAC,EAAE,KAAK,GAAG;AAAA,EAC/C,EAAE;AAAA;AAGH,SAAS,WAAW,CAAC,OAA0C;AAAA,EAC9D,OAAO,MAAM,IAAI,CAAC,MAAM,WAAW;AAAA,IAClC,SAAS;AAAA,IACT,UAAU,QAAQ;AAAA,IAClB,MAAM,KAAK;AAAA,IACX,MAAM,KAAK;AAAA,EACZ,EAAE;AAAA;AAGI,SAAS,yBAAyB;AAAA,EACxC;AAAA,EACA;AAAA,EACA;AAAA,GAC+D;AAAA,EAC/D,MAAM,cAAc,OAAO,SACxB,QACA,yBAAyB,QAAQ;AAAA,EACpC,MAAM,aAAa;AAAA,IAClB,GAAG;AAAA,IACH;AAAA,MACC,OAAO;AAAA,MACP,KAAK,cAAc,QAAQ;AAAA,IAC5B;AAAA,EACD;AAAA,EAEA,OAAO;AAAA,IACN,YAAY;AAAA,IACZ,SAAS;AAAA,IACT,iBAAiB,YAAY,UAAU;AAAA,EACxC;AAAA;;;AC9DM,IAAM,eACZ,cAAuB,SAAS;;;ACD1B,IAAM,mBACZ,cAA2B,aAAa;;;ACDlC,IAAM,cACZ,cAAsB,QAAQ;;;ACDxB,IAAM,sBACZ,cAA8B,gBAAgB;;;ACDxC,IAAM,eACZ,cAAuB,SAAS;;;ACD1B,IAAM,8BACZ,cAAsC,wBAAwB;;;ACDxD,IAAM,aAAmC,cAAqB,OAAO;;;ACArE,IAAM,eACZ,cAAuB,SAAS;;;ACD1B,IAAM,sBACZ,cAA8B,gBAAgB;;;ACDxC,IAAM,iBACZ,cAAyB,WAAW;;;ACD9B,IAAM,gBACZ,cAAwB,UAAU;;;ACD5B,IAAM,kBACZ,cAA0B,YAAY;;;ACDhC,IAAM,qBACZ,cAA6B,eAAe;;;ACDtC,IAAM,4BACZ,cAAoC,sBAAsB;;;ACDpD,IAAM,sBACZ,cAA8B,gBAAgB;;;ACDxC,IAAM,aAAmC,cAAqB,OAAO;;;ACArE,IAAM,4BACZ,cAAoC,sBAAsB;;;ACDpD,IAAM,aAAmC,cAAqB,OAAO;;;ACArE,IAAM,4BACZ,cAAoC,sBAAsB;;;ACDpD,IAAM,oBACZ,cAA4B,cAAc;;;ACDpC,IAAM,cACZ,cAAsB,QAAQ;;;ACDxB,IAAM,aAAmC,cAAqB,OAAO;;;ACArE,IAAM,qBACZ,cAA6B,eAAe;;;ACDtC,IAAM,eACZ,cAAuB,SAAS;;;ACD1B,IAAM,mBACZ,cAA2B,aAAa;;;ACDlC,IAAM,cACZ,cAAsB,QAAQ;;;ACDxB,IAAM,yBACZ,cAAiC,mBAAmB;;;ACD9C,IAAM,gBACZ,cAAwB,UAAU;;;ACD5B,IAAM,cACZ,cAAsB,QAAQ;;;ACDxB,IAAM,cACZ,cAAsB,QAAQ;;;ACDxB,IAAM,gBACZ,cAAwB,UAAU;;;ACD5B,IAAM,2BACZ,cAAmC,qBAAqB;;;ACDlD,IAAM,sBACZ,cAA8B,gBAAgB;;;ACDxC,IAAM,mBACZ,cAA2B,aAAa;;;ACDlC,IAAM,eACZ,cAAuB,SAAS;;;ACD1B,IAAM,eACZ,cAAuB,SAAS;",
+  "debugId": "AC1EB3C8028F80A664756E2164756E21",
   "names": []
 }

package/dist/utils/datetime.d.ts

@@ -0,0 +1,11 @@
+export type DurationParts = {
+    years?: number;
+    months?: number;
+    weeks?: number;
+    days?: number;
+    hours?: number;
+    minutes?: number;
+    seconds?: number;
+};
+export declare function toIsoDuration(parts: DurationParts): string;
+export declare function toIsoDate(value: Date | string): string;

package/dist/utils/image.d.ts

@@ -1,8 +1,15 @@
+import type { IdReference, ImageObjectLeaf, Organization, Person } from "schema-dts";
 type ImageObjectInput = {
     url: string;
     width?: number;
     height?: number;
+    caption?: string;
+    creditText?: string;
+    copyrightNotice?: string;
+    license?: string;
+    acquireLicensePage?: string;
+    creator?: Person | Organization | IdReference;
 };
 export type ImageInput = string | ImageObjectInput;
-export declare function buildImageObject(input?: ImageInput): Record<string, unknown> | undefined;
+export declare function buildImageObject(input?: ImageInput): ImageObjectLeaf | undefined;
 export {};

package/dist/utils/url.d.ts

@@ -0,0 +1 @@
+export declare function toAbsoluteUrl(value: string | null | undefined, siteUrl: string): string | undefined;

package/package.json

@@ -1,6 +1,7 @@
 {
 	"name": "@crawl-me-maybe/schema",
-	"version": "0.1.0",
+	"version": "0.2.0",
+	"sideEffects": false,
 	"type": "module",
 	"author": "Nathan Nye <nathan@nye.dev> (https://nye.dev)",
 	"license": "MIT",
@@ -21,10 +22,11 @@
 	"scripts": {
 		"lint": "biome check .",
 		"fix": "biome check --write .",
-		"build": "rm -rf dist && bun build src/index.ts --outdir dist --format esm --sourcemap --external schema-dts && tsc -p tsconfig.json --declaration --emitDeclarationOnly --declarationDir dist --rootDir src"
+		"build": "rm -rf dist && bun build src/index.ts --outdir dist --format esm --sourcemap --external schema-dts && tsc -p tsconfig.json --declaration --emitDeclarationOnly --declarationDir dist --rootDir src",
+		"prepublishOnly": "bun run build"
 	},
 	"dependencies": {
-		"schema-dts": "^1.1.5"
+		"schema-dts": "^2.0.0"
 	},
 	"devDependencies": {}
 }