@crawl-me-maybe/schema 0.1.0

package/README.md

@@ -0,0 +1,270 @@
+# @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.
+
+## Table of contents
+
+- [Install](#install)
+- [Features](#features)
+- [Why this exists](#why-this-exists)
+- [What `buildSchemaMarkup` generates](#what-buildschemamarkup-generates)
+- [Quick start](#quick-start)
+- [`mainEntity`](#mainentity)
+- [`@id` and de-duplication](#id-and-de-duplication)
+- [Rendering the graph](#rendering-the-graph)
+- [Supported schemas](#supported-schemas)
+- [With Sanity](#with-sanity)
+- [Core exports](#core-exports)
+- [License](#license)
+
+## Install
+
+```bash
+npm install @crawl-me-maybe/schema
+pnpm add @crawl-me-maybe/schema
+bun add @crawl-me-maybe/schema
+yarn add @crawl-me-maybe/schema
+```
+
+---
+
+## Features
+
+- `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`
+- Utility builders for breadcrumbs, FAQ pages, products, articles, events, and more
+
+## Why this exists
+
+Schema markup from CMS → frontend is usually handled with a bulk of fields that editors are forced to fill in. This library pushes a bit more work onto developers up front so editors don't have to duplicate content just to satisfy schema markup.
+
+---
+
+## What `buildSchemaMarkup` generates
+
+`buildSchemaMarkup` creates the page-level schema graph for a single URL. It always generates:
+
+- a site identity node (`Organization`, `Person`, or `LocalBusiness`)
+- a `WebSite` node
+- a `WebPage` node
+
+You can optionally attach additional entities such as:
+
+- `Article`
+- `Product`
+- `FAQPage`
+- `Event`
+- `BreadcrumbList`
+
+These are linked into the same graph as the page's main entity, breadcrumb trail, or supporting nodes.
+
+A typical article page graph looks like:
+
+- `Organization` — who owns the site
+- `WebSite` — the site itself
+- `WebPage` — the current page
+- `BreadcrumbList` — optional page hierarchy
+- `Article` — the page's main content entity
+
+---
+
+## Quick start
+
+```ts
+import {
+  buildArticle,
+  buildBreadcrumbListSchema,
+  buildSchemaMarkup,
+} from "@crawl-me-maybe/schema";
+
+const schemas = buildSchemaMarkup({
+  identity: {
+    type: "organization",
+    name: "Acme",
+    logo: "https://example.com/logo.png",
+  },
+  siteUrl: "https://example.com",
+  siteName: "Acme",
+  siteDescription: "Useful things from Acme.",
+  pageUrl: "https://example.com/blog/hello-world",
+  pageTitle: "Hello world",
+  pageDescription: "An intro post from Acme.",
+  breadcrumb: buildBreadcrumbListSchema({
+    pagePath: "/blog/hello-world",
+    pageTitle: "Hello world",
+  }),
+  mainEntity: buildArticle({
+    headline: "Hello world",
+    datePublished: "2026-06-23",
+    dateModified: "2026-06-23",
+    image: "https://example.com/og.jpg",
+  }),
+});
+```
+
+In this example, `buildSchemaMarkup` creates the site identity, `WebSite`, and `WebPage` nodes automatically, then attaches the breadcrumb and article as part of the same graph.
+
+`buildSchemaMarkup` returns a `string[]` of serialized JSON-LD script payloads, ready to render into `<script type="application/ld+json">` tags. No `JSON.stringify` needed.
+
+> 🧠 Note: Use `buildSchemaMarkup` to assemble the full page-level graph for a URL. Use the individual `build*` helpers to create entities that are passed into that graph as `mainEntity`, breadcrumbs, or nested supporting nodes.
+
+---
+
+## `mainEntity`
+
+Use `mainEntity` for the primary entity the page is about.
+
+Common examples:
+
+- blog post → `buildArticle(...)`
+- product page → `buildProduct(...)`
+- event page → `buildEvent(...)`
+- FAQ page → `buildFAQPage(...)`
+
+If a page has no clear primary entity, you can omit `mainEntity` and render just the page-level graph.
+
+---
+
+## `@id` and de-duplication
+
+If multiple nodes reference the same entity, give them the same `@id`. The library will collapse duplicates into a single graph node where possible.
+
+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.
+
+---
+
+## Rendering the graph
+
+```tsx
+{schemas.map((schema) => (
+  <script
+    key={schema}
+    type="application/ld+json"
+    dangerouslySetInnerHTML={{ __html: schema }}
+  />
+))}
+```
+
+---
+
+## Supported schemas
+
+Builders are exported from the package root.
+
+### Common page entities
+
+| Builder | Schema.org type |
+|---|---|
+| `buildArticle` | `Article` |
+| `buildProduct` | `Product` |
+| `buildEvent` | `Event` |
+| `buildFAQPage` | `FAQPage` |
+| `buildRecipe` | `Recipe` |
+| `buildSoftwareApplication` | `SoftwareApplication` |
+| `buildCourse` | `Course` |
+| `buildDataset` | `Dataset` |
+| `buildMovie` | `Movie` |
+| `buildVacationRental` | `VacationRental` |
+| `buildVideoObject` | `VideoObject` |
+| `buildJobPosting` | `JobPosting` |
+
+### Site / structural entities
+
+Site identity (`Organization`, `Person`, or `LocalBusiness`) is emitted by `buildSchemaMarkup` via the `identity` option — not a separate builder.
+
+| Builder | Schema.org type |
+|---|---|
+| `buildLocalBusiness` | `LocalBusiness` |
+| `buildWebSite` | `WebSite` |
+| `buildWebPage` | `WebPage` |
+| `buildBreadcrumbListSchema` | `BreadcrumbList` |
+| `buildAboutPage` | `AboutPage` |
+| `buildContactPage` | `ContactPage` |
+| `buildProfilePage` | `ProfilePage` |
+
+### Supporting / nested entities
+
+| Builder | Schema.org type |
+|---|---|
+| `buildAggregateRating` | `AggregateRating` |
+| `buildReview` | `Review` |
+| `buildComment` | `Comment` |
+| `buildQuestion` | `Question` |
+| `buildAnswer` | `Answer` |
+| `buildQAPage` | `QAPage` |
+| `buildDiscussionForumPosting` | `DiscussionForumPosting` |
+| `buildItemList` | `ItemList` |
+
+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.
+
+---
+
+## With Sanity
+
+This package has no Sanity dependency. You map your GROQ projections to builders in your app.
+
+If you use [`@crawl-me-maybe/sanity-plugin-seo`](https://github.com/nathannye/crawl-me-maybe/tree/main/packages/sanity-plugin-seo), `globalSeoSettings.logo` and `globalSeoSettings.siteUrl` are the usual sources for organization identity and absolute page URLs. Pair with [`@crawl-me-maybe/meta`](https://github.com/nathannye/crawl-me-maybe/tree/main/packages/meta) for page titles and descriptions.
+
+**Article page example:**
+
+```groq
+*[_type == "post" && slug.current == $slug][0]{
+  title,
+  publishedAt,
+  _updatedAt,
+  "slug": slug.current,
+  "image": mainImage.asset->url,
+  "body": body
+}
+```
+
+```ts
+import {
+  buildArticle,
+  buildBreadcrumbListSchema,
+  buildSchemaMarkup,
+} from "@crawl-me-maybe/schema";
+
+const pageUrl = `${siteUrl}/blog/${post.slug}`;
+const schemas = buildSchemaMarkup({
+  identity: {
+    type: "organization",
+    name: globalSeo.siteTitle,
+    logo: globalSeo.logoUrl,
+  },
+  siteUrl,
+  siteName: globalSeo.siteTitle,
+  pageUrl,
+  pageTitle: post.title,
+  breadcrumb: buildBreadcrumbListSchema({
+    pagePath: `/blog/${post.slug}`,
+    pageTitle: post.title,
+  }),
+  mainEntity: buildArticle({
+    headline: post.title,
+    datePublished: post.publishedAt,
+    dateModified: post._updatedAt,
+    image: post.image,
+  }),
+});
+```
+
+Pick the `build*` helper that matches your document type (`buildProduct`, `buildEvent`, `buildFAQPage`, etc.) and pass it as `mainEntity`. Omit `mainEntity` for generic pages that only need site-level graph nodes.
+
+---
+
+## Core exports
+
+- `buildSchemaMarkup` — builds the page-level JSON-LD graph
+- `build*` schema builders — typed builders for individual Schema.org nodes
+- `BuilderInput` — input helper type for builder functions
+- `BuildSchemaMarkupInput` — input type for `buildSchemaMarkup`
+- `Identity`, `PersonIdentity`, `OrganizationIdentity`, `LocalBusinessIdentity` — supported site identity roots
+
+---
+
+## License
+
+MIT

package/dist/build.d.ts

@@ -0,0 +1,42 @@
+import type { BreadcrumbList, OpeningHoursSpecification, PostalAddress, Thing, WithContext } from "schema-dts";
+import { type ImageInput } from "./utils/image";
+type SchemaNode = Record<string, unknown>;
+export type BuildSchemaMarkupInput = {
+    identity: Identity;
+    siteUrl: string;
+    siteName: string;
+    siteDescription?: string;
+    pageUrl: string;
+    pageTitle: string;
+    pageDescription?: string;
+    breadcrumb?: WithContext<BreadcrumbList>;
+    mainEntity?: Thing | SchemaNode;
+};
+export type PersonIdentity = {
+    type: "person";
+    name: string;
+    description?: string;
+    image?: ImageInput;
+    sameAs?: string[];
+};
+export type OrganizationIdentity = {
+    type: "organization";
+    name: string;
+    description?: string;
+    logo?: ImageInput;
+    sameAs?: string[];
+};
+export type LocalBusinessIdentity = {
+    type: "localBusiness";
+    name: string;
+    description?: string;
+    logo?: ImageInput;
+    phone?: string;
+    email?: string;
+    address?: PostalAddress;
+    openingHours?: OpeningHoursSpecification[];
+    sameAs?: string[];
+};
+export type Identity = PersonIdentity | OrganizationIdentity | LocalBusinessIdentity;
+export declare const buildSchemaMarkup: (input: BuildSchemaMarkupInput) => string[];
+export {};

package/dist/builders/about-page.d.ts

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

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

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

package/dist/builders/answer.d.ts

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

package/dist/builders/article.d.ts

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

package/dist/builders/breadcrumb-list.d.ts

@@ -0,0 +1,11 @@
+import type { BreadcrumbList, WithContext } from "schema-dts";
+export type BreadcrumbItemInput = {
+    title: string;
+    url: string;
+};
+export type BuildBreadcrumbListSchemaInput = {
+    pagePath: string;
+    pageTitle: string;
+    items?: BreadcrumbItemInput[];
+};
+export declare function buildBreadcrumbListSchema({ pagePath, pageTitle, items, }: BuildBreadcrumbListSchemaInput): WithContext<BreadcrumbList>;

package/dist/builders/comment.d.ts

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

package/dist/builders/contact-page.d.ts

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

package/dist/builders/course.d.ts

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

package/dist/builders/dataset.d.ts

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

package/dist/builders/discussion-forum-posting.d.ts

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

package/dist/builders/event.d.ts

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

package/dist/builders/faq.d.ts

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

package/dist/builders/fragments.d.ts

@@ -0,0 +1,13 @@
+type IdReference = {
+    "@id": string;
+};
+type SchemaIdOptions = {
+    kind: string;
+    name: string;
+    baseUrl?: string;
+    explicitId?: string;
+};
+export declare function normalizeId(name: string): string;
+export declare function createSchemaId({ kind, name, baseUrl, explicitId, }: SchemaIdOptions): string;
+export declare function asIdReference(id: string): IdReference;
+export {};

package/dist/builders/index.d.ts

@@ -0,0 +1,27 @@
+export * from "./about-page";
+export * from "./aggregate-rating";
+export * from "./answer";
+export * from "./article";
+export * from "./breadcrumb-list";
+export * from "./comment";
+export * from "./contact-page";
+export * from "./course";
+export * from "./dataset";
+export * from "./discussion-forum-posting";
+export * from "./event";
+export * from "./faq";
+export * from "./item-list";
+export * from "./job-posting";
+export * from "./local-business";
+export * from "./movie";
+export * from "./product";
+export * from "./profile-page";
+export * from "./qa-page";
+export * from "./question";
+export * from "./recipe";
+export * from "./review";
+export * from "./software-application";
+export * from "./vacation-rental";
+export * from "./video-object";
+export * from "./webpage";
+export * from "./website";

package/dist/builders/internal/slug-to-title.d.ts

@@ -0,0 +1 @@
+export declare function slugToTitle(segment: string): string;

package/dist/builders/item-list.d.ts

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

package/dist/builders/job-posting.d.ts

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

package/dist/builders/local-business.d.ts

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

package/dist/builders/movie.d.ts

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

package/dist/builders/product.d.ts

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

package/dist/builders/profile-page.d.ts

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

package/dist/builders/qa-page.d.ts

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

package/dist/builders/question.d.ts

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

package/dist/builders/recipe.d.ts

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

package/dist/builders/review.d.ts

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

package/dist/builders/software-application.d.ts

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

package/dist/builders/vacation-rental.d.ts

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

package/dist/builders/video-object.d.ts

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

package/dist/builders/webpage.d.ts

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

package/dist/builders/website.d.ts

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

package/dist/define-builder.d.ts

@@ -0,0 +1,8 @@
+import type { Thing, WithContext } from "schema-dts";
+type Simplify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+export type BuilderInput<T extends Thing> = Simplify<Omit<T, "@type" | "@context">>;
+export type SchemaBuilder<T extends Thing> = (input: BuilderInput<T>) => WithContext<T>;
+export declare function defineBuilder<T extends Thing>(type: string): SchemaBuilder<T>;
+export {};

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export type { BuildSchemaMarkupInput, Identity, LocalBusinessIdentity, OrganizationIdentity, PersonIdentity, } from "./build";
+export { buildSchemaMarkup } from "./build";
+export * from "./builders";
+export type { BuilderInput } from "./define-builder";

package/dist/index.js

@@ -0,0 +1,383 @@
+// 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) => ({
+    "@context": "https://schema.org",
+    "@type": type,
+    ...input
+  });
+}
+
+// src/builders/about-page.ts
+var buildAboutPage = defineBuilder("AboutPage");
+// 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/internal/slug-to-title.ts
+function slugToTitle(segment) {
+  const decoded = decodeURIComponent(segment || "");
+  const normalized = decoded.replace(/[-_]+/g, " ").replace(/\s+/g, " ").trim();
+  if (!normalized)
+    return "";
+  return normalized.replace(/\b\w/g, (char) => char.toUpperCase());
+}
+
+// src/builders/breadcrumb-list.ts
+function normalizePath(path) {
+  if (!path)
+    return "/";
+  const withoutHash = path.split("#")[0];
+  const withoutQuery = withoutHash.split("?")[0];
+  const prefixed = withoutQuery.startsWith("/") ? withoutQuery : `/${withoutQuery}`;
+  return prefixed.replace(/\/+$/, "") || "/";
+}
+function createDerivedParentItems(pagePath) {
+  const normalized = normalizePath(pagePath);
+  const segments = normalized.split("/").filter(Boolean);
+  if (segments.length <= 1)
+    return [];
+  return segments.slice(0, -1).map((segment, index) => ({
+    title: slugToTitle(segment),
+    url: `/${segments.slice(0, index + 1).join("/")}`
+  }));
+}
+function toListItems(items) {
+  return items.map((item, index) => ({
+    "@type": "ListItem",
+    position: index + 1,
+    name: item.title,
+    item: item.url
+  }));
+}
+function buildBreadcrumbListSchema({
+  pagePath,
+  pageTitle,
+  items
+}) {
+  const parentItems = items?.length ? items : createDerivedParentItems(pagePath);
+  const finalItems = [
+    ...parentItems,
+    {
+      title: pageTitle,
+      url: normalizePath(pagePath)
+    }
+  ];
+  return {
+    "@context": "https://schema.org",
+    "@type": "BreadcrumbList",
+    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/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/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/movie.ts
+var buildMovie = defineBuilder("Movie");
+// 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/question.ts
+var buildQuestion = defineBuilder("Question");
+// src/builders/recipe.ts
+var buildRecipe = defineBuilder("Recipe");
+// src/builders/review.ts
+var buildReview = defineBuilder("Review");
+// 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,
+  buildAggregateRating,
+  buildAboutPage
+};
+
+//# debugId=5F889F4F897E1F2564756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,41 @@
+{
+  "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"],
+  "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 { 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 { 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 { 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 { 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 { 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 { Movie } from \"schema-dts\";\nimport { defineBuilder, type SchemaBuilder } from \"../define-builder\";\n\nexport const buildMovie: SchemaBuilder<Movie> = defineBuilder<Movie>(\"Movie\");\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 { 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 { 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",
+  "names": []
+}

package/dist/utils/image.d.ts

@@ -0,0 +1,8 @@
+type ImageObjectInput = {
+    url: string;
+    width?: number;
+    height?: number;
+};
+export type ImageInput = string | ImageObjectInput;
+export declare function buildImageObject(input?: ImageInput): Record<string, unknown> | undefined;
+export {};

package/package.json

@@ -0,0 +1,30 @@
+{
+	"name": "@crawl-me-maybe/schema",
+	"version": "0.1.0",
+	"type": "module",
+	"author": "Nathan Nye <nathan@nye.dev> (https://nye.dev)",
+	"license": "MIT",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		}
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"files": [
+		"dist"
+	],
+	"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"
+	},
+	"dependencies": {
+		"schema-dts": "^1.1.5"
+	},
+	"devDependencies": {}
+}