schemaorg-kit 1.0.1

package/dist/index.mjs

@@ -0,0 +1,1991 @@
+// src/core/base.ts
+import { z } from "zod";
+var SchemaNode = class {
+  constructor(schema2, data) {
+    this.schema = schema2;
+    this.data = data;
+  }
+  /** Returns the raw validated object */
+  toObject() {
+    return this.data;
+  }
+  /** Returns a JSON-LD ready object with @context */
+  toJsonLd() {
+    return {
+      "@context": "https://schema.org",
+      ...this.data
+    };
+  }
+  /** Returns a <script type="application/ld+json"> tag string */
+  toScript() {
+    return `<script type="application/ld+json">
+${JSON.stringify(this.toJsonLd(), null, 2)}
+</script>`;
+  }
+  /** Returns prettified JSON string */
+  toString() {
+    return JSON.stringify(this.toJsonLd(), null, 2);
+  }
+  /** Validates and throws if invalid — useful in CI/build steps */
+  validate() {
+    this.schema.parse(this.data);
+    return this;
+  }
+  /** Safe validation — returns errors without throwing */
+  safeParse() {
+    return this.schema.safeParse(this.data);
+  }
+};
+function makeFactory(schema2) {
+  return (data) => {
+    const parsed = schema2.parse(data);
+    return new SchemaNode(schema2, parsed);
+  };
+}
+
+// src/types/things/Person.ts
+import { z as z5 } from "zod";
+
+// src/types/things/Thing.ts
+import { z as z4 } from "zod";
+
+// src/types/shared/ImageObject.ts
+import { z as z3 } from "zod";
+
+// src/types/shared/PersonOrOrgRef.ts
+import { z as z2 } from "zod";
+var PersonOrOrgRef = z2.union([
+  z2.string(),
+  // Accept any Person or Organization object — including full schema outputs via .toObject().
+  // .catchall() allows extra fields; name/url are optional to match ThingSchema's base types.
+  z2.object({ "@type": z2.literal("Person") }).catchall(z2.unknown()),
+  z2.object({ "@type": z2.literal("Organization") }).catchall(z2.unknown())
+]);
+
+// src/types/shared/ImageObject.ts
+var ImageObjectSchema = z3.object({
+  "@type": z3.literal("ImageObject").default("ImageObject"),
+  url: z3.url(),
+  contentUrl: z3.url().optional(),
+  width: z3.union([
+    z3.number(),
+    z3.object({ "@type": z3.literal("QuantitativeValue"), value: z3.number(), unitCode: z3.string().optional() })
+  ]).optional(),
+  height: z3.union([
+    z3.number(),
+    z3.object({ "@type": z3.literal("QuantitativeValue"), value: z3.number(), unitCode: z3.string().optional() })
+  ]).optional(),
+  caption: z3.string().optional(),
+  description: z3.string().optional(),
+  name: z3.string().optional(),
+  // Google image metadata requirements:
+  creator: PersonOrOrgRef.optional(),
+  creditText: z3.string().optional(),
+  copyrightNotice: z3.string().optional(),
+  license: z3.url().optional(),
+  acquireLicensePage: z3.url().optional(),
+  representativeOfPage: z3.boolean().optional(),
+  encodingFormat: z3.string().optional(),
+  // MIME type, e.g. "image/jpeg"
+  uploadDate: z3.string().optional(),
+  thumbnailUrl: z3.url().optional(),
+  embedUrl: z3.url().optional()
+});
+var ImageOrUrl = z3.union([z3.url(), ImageObjectSchema]);
+var createImageObject = makeFactory(ImageObjectSchema);
+
+// src/types/things/Thing.ts
+var AnyThingRef = z4.lazy(
+  () => z4.object({ "@type": z4.string() }).catchall(z4.unknown())
+);
+var ThingSchema = z4.object({
+  "@type": z4.string(),
+  // JSON-LD node identifier — useful for @graph cross-references
+  "@id": z4.string().optional(),
+  // Core identity
+  name: z4.string().optional(),
+  description: z4.string().optional(),
+  url: z4.url().optional(),
+  identifier: z4.union([z4.string(), z4.number()]).optional(),
+  // Media — single image or array (Google recommends multiple aspect ratios)
+  image: z4.union([ImageOrUrl, z4.array(ImageOrUrl)]).optional(),
+  // Discovery
+  sameAs: z4.union([z4.url(), z4.array(z4.url())]).optional(),
+  alternateName: z4.string().optional(),
+  // Relationships (loose refs to avoid circular type inference)
+  subjectOf: AnyThingRef.optional(),
+  mainEntityOfPage: z4.union([z4.url(), AnyThingRef]).optional()
+});
+function extendThing(type, shape) {
+  return ThingSchema.extend({
+    "@type": z4.literal(type).default(type),
+    ...shape
+  });
+}
+
+// src/types/things/Person.ts
+var PersonSchema = extendThing("Person", {
+  givenName: z5.string().optional(),
+  familyName: z5.string().optional(),
+  email: z5.string().email().optional(),
+  telephone: z5.string().optional(),
+  jobTitle: z5.string().optional(),
+  worksFor: z5.lazy(() => z5.object({ "@type": z5.string(), name: z5.string() })).optional(),
+  birthDate: z5.string().optional(),
+  // ISO 8601
+  gender: z5.enum(["Male", "Female", "Unknown"]).optional(),
+  nationality: z5.string().optional(),
+  address: z5.object({
+    "@type": z5.literal("PostalAddress"),
+    streetAddress: z5.string().optional(),
+    addressLocality: z5.string().optional(),
+    addressRegion: z5.string().optional(),
+    postalCode: z5.string().optional(),
+    addressCountry: z5.string().optional()
+  }).optional()
+});
+var createPerson = makeFactory(PersonSchema);
+
+// src/types/things/Organization.ts
+import { z as z11 } from "zod";
+
+// src/types/shared/PostalAddress.ts
+import { z as z6 } from "zod";
+var PostalAddressSchema = z6.object({
+  "@type": z6.literal("PostalAddress").default("PostalAddress"),
+  streetAddress: z6.string().optional(),
+  addressLocality: z6.string().optional(),
+  // city
+  addressRegion: z6.string().optional(),
+  // state/province
+  postalCode: z6.string().optional(),
+  addressCountry: z6.string().optional(),
+  // ISO 3166-1 alpha-2, e.g. "US"
+  postOfficeBoxNumber: z6.string().optional()
+});
+
+// src/types/shared/ContactPoint.ts
+import { z as z7 } from "zod";
+var ContactPointSchema = z7.object({
+  "@type": z7.literal("ContactPoint").default("ContactPoint"),
+  telephone: z7.string().optional(),
+  contactType: z7.string().optional(),
+  // e.g. "customer support", "sales"
+  email: z7.string().email().optional(),
+  areaServed: z7.union([z7.string(), z7.array(z7.string())]).optional(),
+  availableLanguage: z7.union([z7.string(), z7.array(z7.string())]).optional(),
+  hoursAvailable: z7.string().optional(),
+  contactOption: z7.string().optional()
+  // e.g. "TollFree", "HearingImpairedSupported"
+});
+
+// src/types/shared/Offer.ts
+import { z as z10 } from "zod";
+
+// src/types/shared/ShippingDetails.ts
+import { z as z9 } from "zod";
+
+// src/types/shared/OpeningHoursSpecification.ts
+import { z as z8 } from "zod";
+var DayOfWeek = z8.enum([
+  "Monday",
+  "Tuesday",
+  "Wednesday",
+  "Thursday",
+  "Friday",
+  "Saturday",
+  "Sunday"
+]);
+var OpeningHoursSpecificationSchema = z8.object({
+  "@type": z8.literal("OpeningHoursSpecification").default("OpeningHoursSpecification"),
+  dayOfWeek: z8.union([DayOfWeek, z8.array(DayOfWeek)]),
+  opens: z8.string().optional(),
+  // "HH:MM:SS" e.g. "09:00:00"
+  closes: z8.string().optional(),
+  // "HH:MM:SS" e.g. "17:00:00"
+  validFrom: z8.string().optional(),
+  // ISO 8601 date — for seasonal hours
+  validThrough: z8.string().optional()
+  // ISO 8601 date
+});
+
+// src/types/shared/ShippingDetails.ts
+var DefinedRegionSchema = z9.object({
+  "@type": z9.literal("DefinedRegion").default("DefinedRegion"),
+  name: z9.string().optional(),
+  /** ISO 3166-1 alpha-2 country code, e.g. "US", "GB" */
+  addressCountry: z9.string().optional(),
+  /** State/province code(s) */
+  addressRegion: z9.union([z9.string(), z9.array(z9.string())]).optional(),
+  /** Postal code prefix(es) */
+  postalCodePrefix: z9.union([z9.string(), z9.array(z9.string())]).optional(),
+  /** Postal code range */
+  postalCodeRange: z9.object({
+    postalCodeBegin: z9.string(),
+    postalCodeEnd: z9.string()
+  }).optional()
+});
+var QuantitativeDaysSchema = z9.object({
+  "@type": z9.literal("QuantitativeValue").default("QuantitativeValue"),
+  minValue: z9.number().int().nonnegative().optional(),
+  maxValue: z9.number().int().nonnegative().optional(),
+  /** Unit code — always "DAY" for delivery times */
+  unitCode: z9.string().default("DAY")
+});
+var ShippingDeliveryTimeSchema = z9.object({
+  "@type": z9.literal("ShippingDeliveryTime").default("ShippingDeliveryTime"),
+  /** Days the warehouse processes orders (e.g. Mon–Fri) */
+  businessDays: z9.object({
+    "@type": z9.literal("OpeningHoursSpecification").default("OpeningHoursSpecification"),
+    dayOfWeek: z9.union([DayOfWeek, z9.array(DayOfWeek)])
+  }).optional(),
+  /** Order processing/packing time in days */
+  handlingTime: QuantitativeDaysSchema.optional(),
+  /** Transit time in days after dispatch */
+  transitTime: QuantitativeDaysSchema.optional(),
+  /** Cutoff time for same-day processing, ISO 8601 time, e.g. "14:00:00" */
+  cutoffTime: z9.string().optional()
+});
+var OfferShippingDetailsSchema = z9.object({
+  "@type": z9.literal("OfferShippingDetails").default("OfferShippingDetails"),
+  /** Shipping cost as a MonetaryAmount (use value: 0 for free shipping) */
+  shippingRate: z9.object({
+    "@type": z9.literal("MonetaryAmount").default("MonetaryAmount"),
+    value: z9.number(),
+    currency: z9.string()
+  }).optional(),
+  /** Region(s) this shipping option applies to */
+  shippingDestination: z9.union([
+    DefinedRegionSchema,
+    z9.array(DefinedRegionSchema)
+  ]).optional(),
+  /** Expected delivery time */
+  deliveryTime: ShippingDeliveryTimeSchema.optional(),
+  /** Set to true to indicate item cannot be shipped to a destination */
+  doesNotShip: z9.boolean().optional(),
+  /** Human-readable shipping label, e.g. "Free Shipping", "Express Delivery" */
+  shippingLabel: z9.string().optional()
+});
+
+// src/types/shared/Offer.ts
+var ItemAvailability = z10.enum([
+  "InStock",
+  "OutOfStock",
+  "PreOrder",
+  "Discontinued",
+  "LimitedAvailability",
+  "SoldOut",
+  "OnlineOnly",
+  "InStoreOnly",
+  "BackOrder"
+]).transform((v) => `https://schema.org/${v}`);
+var OfferSchema = z10.object({
+  "@type": z10.literal("Offer").default("Offer"),
+  price: z10.union([z10.number(), z10.string()]),
+  priceCurrency: z10.string().length(3),
+  // ISO 4217, e.g. "USD"
+  availability: ItemAvailability.optional(),
+  validFrom: z10.string().optional(),
+  // ISO 8601
+  validThrough: z10.string().optional(),
+  // ISO 8601
+  url: z10.url().optional(),
+  seller: z10.object({ "@type": z10.string(), name: z10.string() }).optional(),
+  category: z10.string().optional(),
+  inventoryLevel: z10.object({
+    "@type": z10.literal("QuantitativeValue").default("QuantitativeValue"),
+    value: z10.number()
+  }).optional(),
+  priceValidUntil: z10.string().optional(),
+  // ISO 8601 date — Google Product requirement
+  shippingDetails: z10.union([
+    OfferShippingDetailsSchema,
+    z10.array(OfferShippingDetailsSchema)
+  ]).optional(),
+  hasMerchantReturnPolicy: z10.lazy(
+    () => z10.object({ "@type": z10.string() }).catchall(z10.unknown())
+  ).optional()
+});
+var MerchantReturnPolicySchema = z10.object({
+  "@type": z10.literal("MerchantReturnPolicy").default("MerchantReturnPolicy"),
+  applicableCountry: z10.union([z10.string(), z10.array(z10.string())]).optional(),
+  returnPolicyCategory: z10.string().optional(),
+  // schema.org enum URL
+  merchantReturnDays: z10.number().int().nonnegative().optional(),
+  returnMethod: z10.string().optional(),
+  // schema.org enum URL
+  returnFees: z10.string().optional(),
+  // schema.org enum URL
+  refundType: z10.string().optional()
+  // schema.org enum URL
+});
+var createOffer = makeFactory(OfferSchema);
+var AggregateOfferSchema = z10.object({
+  "@type": z10.literal("AggregateOffer").default("AggregateOffer"),
+  lowPrice: z10.number().optional(),
+  highPrice: z10.number().optional(),
+  priceCurrency: z10.string().length(3).optional(),
+  // ISO 4217
+  offerCount: z10.number().int().nonnegative().optional(),
+  offers: z10.union([OfferSchema, z10.array(OfferSchema)]).optional(),
+  availability: ItemAvailability.optional(),
+  url: z10.url().optional()
+});
+
+// src/types/things/Organization.ts
+var NestedOrgRef = z11.lazy(
+  () => z11.object({ "@type": z11.string(), name: z11.string().optional() }).catchall(z11.unknown())
+);
+var OrganizationSchema = extendThing("Organization", {
+  legalName: z11.string().optional(),
+  email: z11.email().optional(),
+  telephone: z11.string().optional(),
+  logo: ImageOrUrl.optional(),
+  foundingDate: z11.string().optional(),
+  // ISO 8601 date
+  numberOfEmployees: z11.object({
+    "@type": z11.literal("QuantitativeValue").default("QuantitativeValue"),
+    value: z11.number()
+  }).optional(),
+  address: z11.union([z11.string(), PostalAddressSchema]).optional(),
+  contactPoint: z11.union([ContactPointSchema, z11.array(ContactPointSchema)]).optional(),
+  // Google Organization requirements:
+  vatID: z11.string().optional(),
+  iso6523Code: z11.string().optional(),
+  // e.g. "0060:123456789" (DUNS)
+  taxID: z11.string().optional(),
+  leiCode: z11.string().optional(),
+  duns: z11.string().optional(),
+  // Merchant-related (Google seller identity signals):
+  hasMerchantReturnPolicy: MerchantReturnPolicySchema.optional(),
+  hasShippingService: z11.lazy(
+    () => z11.object({ "@type": z11.string() }).catchall(z11.unknown())
+  ).optional(),
+  // Hierarchical organization (loose refs to avoid circular type inference):
+  subOrganization: NestedOrgRef.optional(),
+  parentOrganization: NestedOrgRef.optional(),
+  sameAs: z11.union([z11.url(), z11.array(z11.url())]).optional()
+});
+var createOrganization = makeFactory(OrganizationSchema);
+var createNGO = makeFactory(
+  OrganizationSchema.extend({ "@type": z11.literal("NGO").default("NGO") })
+);
+var createCorporation = makeFactory(
+  OrganizationSchema.extend({ "@type": z11.literal("Corporation").default("Corporation") })
+);
+var createOnlineStore = makeFactory(
+  OrganizationSchema.extend({ "@type": z11.literal("OnlineStore").default("OnlineStore") })
+);
+var createOnlineBusiness = makeFactory(
+  OrganizationSchema.extend({ "@type": z11.literal("OnlineBusiness").default("OnlineBusiness") })
+);
+
+// src/types/things/Product.ts
+import { z as z13 } from "zod";
+
+// src/types/shared/Rating.ts
+import { z as z12 } from "zod";
+var RatingSchema = z12.object({
+  "@type": z12.literal("Rating").default("Rating"),
+  ratingValue: z12.union([z12.number(), z12.string()]),
+  bestRating: z12.union([z12.number(), z12.string()]).default(5),
+  worstRating: z12.union([z12.number(), z12.string()]).default(1),
+  ratingExplanation: z12.string().optional(),
+  reviewAspect: z12.string().optional()
+});
+var AggregateRatingSchema = z12.object({
+  "@type": z12.literal("AggregateRating").default("AggregateRating"),
+  ratingValue: z12.union([z12.number(), z12.string()]),
+  reviewCount: z12.number().int().nonnegative().optional(),
+  ratingCount: z12.number().int().nonnegative().optional(),
+  bestRating: z12.union([z12.number(), z12.string()]).default(5),
+  worstRating: z12.union([z12.number(), z12.string()]).default(1)
+});
+var ReviewSchema = z12.object({
+  "@type": z12.literal("Review").default("Review"),
+  reviewBody: z12.string().optional(),
+  reviewRating: RatingSchema.optional(),
+  author: PersonOrOrgRef,
+  datePublished: z12.string().optional(),
+  // ISO 8601 date
+  publisher: PersonOrOrgRef.optional(),
+  // itemReviewed: any Thing — kept loose to avoid circular imports
+  itemReviewed: z12.lazy(
+    () => z12.object({ "@type": z12.string() }).passthrough()
+  ).optional(),
+  name: z12.string().optional(),
+  // Review headline
+  url: z12.string().url().optional()
+});
+var EmployerAggregateRatingSchema = AggregateRatingSchema.extend({
+  "@type": z12.literal("EmployerAggregateRating").default("EmployerAggregateRating"),
+  itemReviewed: z12.lazy(
+    () => z12.object({ "@type": z12.string(), name: z12.string() }).passthrough()
+  ).optional()
+});
+
+// src/types/things/Product.ts
+var CertificationSchema = z13.object({
+  "@type": z13.literal("Certification").default("Certification"),
+  name: z13.string(),
+  url: z13.url().optional(),
+  issuedBy: z13.object({
+    "@type": z13.literal("Organization").default("Organization"),
+    name: z13.string(),
+    url: z13.url().optional()
+  }).optional(),
+  certificationRatingValue: z13.string().optional(),
+  certificationStatus: z13.string().optional(),
+  validFrom: z13.string().optional(),
+  validThrough: z13.string().optional()
+});
+var ThreeDModelSchema = z13.object({
+  "@type": z13.literal("3DModel").default("3DModel"),
+  contentUrl: z13.url(),
+  /** MIME type, e.g. "model/gltf-binary", "model/gltf+json" */
+  encodingFormat: z13.string().optional(),
+  name: z13.string().optional()
+});
+var LooseProductRef = z13.lazy(
+  () => z13.object({ "@type": z13.string() }).catchall(z13.unknown())
+);
+var LooseProductGroupRef = z13.lazy(
+  () => z13.object({ "@type": z13.string() }).catchall(z13.unknown())
+);
+var ProductSchema = extendThing("Product", {
+  sku: z13.string().optional(),
+  // GTIN identifiers (Google Product requirement):
+  gtin: z13.string().optional(),
+  gtin8: z13.string().optional(),
+  gtin12: z13.string().optional(),
+  gtin13: z13.string().optional(),
+  gtin14: z13.string().optional(),
+  mpn: z13.string().optional(),
+  // Manufacturer Part Number
+  brand: z13.union([
+    z13.string(),
+    z13.object({
+      "@type": z13.union([z13.literal("Brand"), z13.literal("Organization")]),
+      name: z13.string()
+    })
+  ]).optional(),
+  offers: z13.union([
+    OfferSchema,
+    AggregateOfferSchema,
+    z13.array(z13.union([OfferSchema, AggregateOfferSchema]))
+  ]).optional(),
+  aggregateRating: AggregateRatingSchema.optional(),
+  review: z13.union([ReviewSchema, z13.array(ReviewSchema)]).optional(),
+  category: z13.string().optional(),
+  color: z13.string().optional(),
+  material: z13.string().optional(),
+  weight: z13.object({
+    "@type": z13.literal("QuantitativeValue").default("QuantitativeValue"),
+    value: z13.number(),
+    unitCode: z13.string()
+  }).optional(),
+  image: z13.union([ImageOrUrl, z13.array(ImageOrUrl)]).optional(),
+  hasMerchantReturnPolicy: MerchantReturnPolicySchema.optional(),
+  isVariantOf: LooseProductGroupRef.optional(),
+  /** Certifications (CE, Energy Star, Fair Trade, etc.) */
+  hasCertification: z13.union([CertificationSchema, z13.array(CertificationSchema)]).optional(),
+  /** 3D models for interactive product views in Google Search/Images */
+  subjectOf: z13.union([ThreeDModelSchema, z13.array(ThreeDModelSchema)]).optional()
+});
+var ProductGroupSchema = extendThing("ProductGroup", {
+  variesBy: z13.union([z13.string(), z13.array(z13.string())]).optional(),
+  hasVariant: z13.array(LooseProductRef).optional(),
+  productGroupID: z13.string().optional(),
+  sku: z13.string().optional(),
+  gtin: z13.string().optional(),
+  brand: z13.union([
+    z13.string(),
+    z13.object({
+      "@type": z13.union([z13.literal("Brand"), z13.literal("Organization")]),
+      name: z13.string()
+    })
+  ]).optional(),
+  offers: z13.union([OfferSchema, z13.array(OfferSchema)]).optional(),
+  aggregateRating: AggregateRatingSchema.optional(),
+  image: z13.union([ImageOrUrl, z13.array(ImageOrUrl)]).optional()
+});
+var createProduct = makeFactory(ProductSchema);
+var createProductGroup = makeFactory(ProductGroupSchema);
+
+// src/types/things/Event.ts
+import { z as z15 } from "zod";
+
+// src/types/shared/VideoObject.ts
+import { z as z14 } from "zod";
+var ClipSchema = z14.object({
+  "@type": z14.literal("Clip").default("Clip"),
+  name: z14.string(),
+  startOffset: z14.number(),
+  // seconds from start
+  endOffset: z14.number().optional(),
+  // seconds from start
+  url: z14.url().optional()
+  // URL pointing to this clip
+});
+var BroadcastEventSchema = z14.object({
+  "@type": z14.literal("BroadcastEvent").default("BroadcastEvent"),
+  isLiveBroadcast: z14.boolean().optional(),
+  startDate: z14.string().optional(),
+  // ISO 8601
+  endDate: z14.string().optional()
+});
+var VideoObjectSchema = z14.object({
+  "@type": z14.literal("VideoObject").default("VideoObject"),
+  // Required by Google:
+  name: z14.string(),
+  thumbnailUrl: z14.union([z14.url(), z14.array(z14.url())]),
+  uploadDate: z14.string(),
+  // ISO 8601 date
+  // Recommended by Google:
+  description: z14.string().optional(),
+  duration: z14.string().optional(),
+  // ISO 8601 duration, e.g. "PT1M54S"
+  contentUrl: z14.url().optional(),
+  embedUrl: z14.url().optional(),
+  // Optional:
+  expires: z14.string().optional(),
+  // ISO 8601 — when video is no longer available
+  hasPart: z14.array(ClipSchema).optional(),
+  interactionStatistic: z14.object({
+    "@type": z14.literal("InteractionCounter").default("InteractionCounter"),
+    interactionType: z14.literal("https://schema.org/WatchAction").default("https://schema.org/WatchAction"),
+    userInteractionCount: z14.number().int().nonnegative()
+  }).optional(),
+  regionsAllowed: z14.union([z14.string(), z14.array(z14.string())]).optional(),
+  ineligibleRegion: z14.union([z14.string(), z14.array(z14.string())]).optional(),
+  requiresSubscription: z14.boolean().optional(),
+  isLiveBroadcast: z14.boolean().optional(),
+  publication: BroadcastEventSchema.optional(),
+  thumbnail: ImageOrUrl.optional()
+});
+var createVideoObject = makeFactory(VideoObjectSchema);
+
+// src/types/things/Event.ts
+var EventStatusType = z15.enum([
+  "EventScheduled",
+  "EventCancelled",
+  "EventMovedOnline",
+  "EventPostponed",
+  "EventRescheduled"
+]).transform((v) => `https://schema.org/${v}`);
+var EventAttendanceMode = z15.enum([
+  "OfflineEventAttendanceMode",
+  "OnlineEventAttendanceMode",
+  "MixedEventAttendanceMode"
+]).transform((v) => `https://schema.org/${v}`);
+var PlaceRef = z15.union([
+  z15.string(),
+  z15.object({
+    "@type": z15.literal("Place"),
+    name: z15.string().optional(),
+    address: z15.union([z15.string(), PostalAddressSchema]).optional(),
+    url: z15.url().optional()
+  }),
+  z15.object({
+    "@type": z15.literal("VirtualLocation"),
+    url: z15.url(),
+    name: z15.string().optional()
+  }),
+  PostalAddressSchema
+]);
+var EventSchema = extendThing("Event", {
+  // Required by Google:
+  name: z15.string(),
+  startDate: z15.string(),
+  // ISO 8601
+  // Recommended by Google:
+  endDate: z15.string().optional(),
+  // ISO 8601
+  location: PlaceRef.optional(),
+  eventStatus: EventStatusType.optional(),
+  eventAttendanceMode: EventAttendanceMode.optional(),
+  offers: z15.union([OfferSchema, z15.array(OfferSchema)]).optional(),
+  performer: z15.union([PersonOrOrgRef, z15.array(PersonOrOrgRef)]).optional(),
+  organizer: z15.union([PersonOrOrgRef, z15.array(PersonOrOrgRef)]).optional(),
+  image: z15.union([ImageOrUrl, z15.array(ImageOrUrl)]).optional(),
+  description: z15.string().optional(),
+  previousStartDate: z15.string().optional(),
+  // ISO 8601 — for rescheduled events
+  aggregateRating: AggregateRatingSchema.optional(),
+  // Sub-events:
+  subEvent: z15.lazy(
+    () => z15.array(z15.object({ "@type": z15.string() }).catchall(z15.unknown()))
+  ).optional(),
+  superEvent: z15.lazy(
+    () => z15.object({ "@type": z15.string() }).catchall(z15.unknown())
+  ).optional(),
+  // Additional:
+  inLanguage: z15.union([z15.string(), z15.object({ "@type": z15.literal("Language"), name: z15.string() })]).optional(),
+  isAccessibleForFree: z15.boolean().optional(),
+  maximumAttendeeCapacity: z15.number().int().nonnegative().optional(),
+  remainingAttendeeCapacity: z15.number().int().nonnegative().optional(),
+  typicalAgeRange: z15.string().optional(),
+  video: VideoObjectSchema.optional()
+});
+var createEvent = makeFactory(EventSchema);
+
+// src/types/things/Place.ts
+import { z as z17 } from "zod";
+
+// src/types/shared/GeoCoordinates.ts
+import { z as z16 } from "zod";
+var GeoCoordinatesSchema = z16.object({
+  "@type": z16.literal("GeoCoordinates").default("GeoCoordinates"),
+  latitude: z16.union([z16.number(), z16.string()]),
+  longitude: z16.union([z16.number(), z16.string()]),
+  elevation: z16.union([z16.number(), z16.string()]).optional()
+});
+
+// src/types/things/Place.ts
+var PlaceSchema = extendThing("Place", {
+  address: z17.union([z17.string(), PostalAddressSchema]).optional(),
+  geo: GeoCoordinatesSchema.optional(),
+  hasMap: z17.url().optional(),
+  photo: z17.union([ImageOrUrl, z17.array(ImageOrUrl)]).optional(),
+  telephone: z17.string().optional(),
+  faxNumber: z17.string().optional(),
+  openingHoursSpecification: z17.union([
+    OpeningHoursSpecificationSchema,
+    z17.array(OpeningHoursSpecificationSchema)
+  ]).optional(),
+  specialOpeningHoursSpecification: z17.union([
+    OpeningHoursSpecificationSchema,
+    z17.array(OpeningHoursSpecificationSchema)
+  ]).optional(),
+  maximumAttendeeCapacity: z17.number().int().nonnegative().optional(),
+  isAccessibleForFree: z17.boolean().optional(),
+  publicAccess: z17.boolean().optional(),
+  amenityFeature: z17.array(z17.object({
+    "@type": z17.literal("LocationFeatureSpecification").default("LocationFeatureSpecification"),
+    name: z17.string(),
+    value: z17.union([z17.boolean(), z17.string(), z17.number()])
+  })).optional(),
+  containedInPlace: z17.lazy(
+    () => z17.object({ "@type": z17.string(), name: z17.string().optional() }).catchall(z17.unknown())
+  ).optional()
+});
+var createPlace = makeFactory(PlaceSchema);
+
+// src/types/things/LocalBusiness.ts
+import { z as z18 } from "zod";
+var LocalBusinessSchema = PlaceSchema.extend({
+  "@type": z18.union([
+    z18.literal("LocalBusiness"),
+    z18.literal("Restaurant"),
+    z18.literal("Store"),
+    z18.literal("FoodEstablishment"),
+    z18.literal("HealthAndBeautyBusiness"),
+    z18.literal("MedicalBusiness"),
+    z18.literal("FinancialService"),
+    z18.literal("LegalService"),
+    z18.literal("RealEstateAgent"),
+    z18.literal("AutoDealer"),
+    z18.literal("DaySpa"),
+    z18.literal("HairSalon"),
+    z18.literal("Hotel"),
+    z18.literal("LodgingBusiness"),
+    z18.literal("GroceryStore"),
+    z18.literal("ShoppingCenter"),
+    z18.literal("TravelAgency")
+  ]).default("LocalBusiness"),
+  // Business identity:
+  legalName: z18.string().optional(),
+  email: z18.email().optional(),
+  logo: ImageOrUrl.optional(),
+  contactPoint: z18.union([ContactPointSchema, z18.array(ContactPointSchema)]).optional(),
+  // Ratings & reviews:
+  aggregateRating: z18.union([AggregateRatingSchema, EmployerAggregateRatingSchema]).optional(),
+  review: z18.union([ReviewSchema, z18.array(ReviewSchema)]).optional(),
+  // Pricing:
+  priceRange: z18.string().optional(),
+  // e.g. "$$$"
+  currenciesAccepted: z18.string().optional(),
+  paymentAccepted: z18.string().optional(),
+  // Food establishment specific:
+  servesCuisine: z18.union([z18.string(), z18.array(z18.string())]).optional(),
+  hasMenu: z18.url().optional(),
+  acceptsReservations: z18.union([z18.boolean(), z18.url()]).optional(),
+  // Merchant signals:
+  vatID: z18.string().optional(),
+  iso6523Code: z18.string().optional(),
+  hasMerchantReturnPolicy: MerchantReturnPolicySchema.optional(),
+  sameAs: z18.union([z18.url(), z18.array(z18.url())]).optional(),
+  // Departments (nested LocalBusiness):
+  department: z18.lazy(
+    () => z18.union([
+      z18.object({ "@type": z18.string() }).catchall(z18.unknown()),
+      z18.array(z18.object({ "@type": z18.string() }).catchall(z18.unknown()))
+    ])
+  ).optional(),
+  // Opening hours in string format (alternative to openingHoursSpecification):
+  openingHours: z18.union([z18.string(), z18.array(z18.string())]).optional()
+});
+var createLocalBusiness = makeFactory(LocalBusinessSchema);
+var createRestaurant = makeFactory(
+  LocalBusinessSchema.extend({ "@type": z18.literal("Restaurant").default("Restaurant") })
+);
+var createHotel = makeFactory(
+  LocalBusinessSchema.extend({ "@type": z18.literal("Hotel").default("Hotel") })
+);
+
+// src/types/things/Movie.ts
+import { z as z19 } from "zod";
+var MovieSchema = extendThing("Movie", {
+  // Recommended by Google:
+  director: z19.union([PersonOrOrgRef, z19.array(PersonOrOrgRef)]).optional(),
+  actor: z19.union([PersonOrOrgRef, z19.array(PersonOrOrgRef)]).optional(),
+  author: z19.union([PersonOrOrgRef, z19.array(PersonOrOrgRef)]).optional(),
+  producer: PersonOrOrgRef.optional(),
+  musicBy: PersonOrOrgRef.optional(),
+  duration: z19.string().optional(),
+  // ISO 8601, e.g. "PT2H15M"
+  dateCreated: z19.string().optional(),
+  // ISO 8601
+  datePublished: z19.string().optional(),
+  // ISO 8601
+  countryOfOrigin: z19.string().optional(),
+  // ISO 3166
+  inLanguage: z19.union([
+    z19.string(),
+    z19.object({ "@type": z19.literal("Language"), name: z19.string() })
+  ]).optional(),
+  aggregateRating: AggregateRatingSchema.optional(),
+  review: z19.union([ReviewSchema, z19.array(ReviewSchema)]).optional(),
+  trailer: VideoObjectSchema.optional(),
+  image: z19.union([ImageOrUrl, z19.array(ImageOrUrl)]).optional(),
+  // Classification:
+  contentRating: z19.string().optional(),
+  // e.g. "MPAA PG-13"
+  genre: z19.union([z19.string(), z19.array(z19.string())]).optional(),
+  // For carousels: itemListElement links
+  sameAs: z19.union([z19.url(), z19.array(z19.url())]).optional()
+});
+var createMovie = makeFactory(MovieSchema);
+
+// src/types/creative-works/Book.ts
+import { z as z20 } from "zod";
+var BookFormatType = z20.enum([
+  "EBook",
+  "Hardcover",
+  "Paperback",
+  "AudioBook",
+  "GraphicNovel"
+]);
+var EntryPointSchema = z20.object({
+  "@type": z20.literal("EntryPoint").default("EntryPoint"),
+  /** URL template with optional {isbn} / {id} placeholder, or a plain URL */
+  urlTemplate: z20.string(),
+  /** MIME type of the action target */
+  encodingType: z20.string().optional(),
+  /** HTTP method */
+  httpMethod: z20.string().optional()
+});
+var ReadActionSchema = z20.object({
+  "@type": z20.literal("ReadAction").default("ReadAction"),
+  /** Where the book can be read */
+  target: z20.union([EntryPointSchema, z20.string()]),
+  /** Offer describing subscription / purchase required to read */
+  expectsAcceptanceOf: OfferSchema.optional()
+});
+var BorrowActionSchema = z20.object({
+  "@type": z20.literal("BorrowAction").default("BorrowAction"),
+  /** Library system or library lending this book */
+  lender: z20.object({
+    "@type": z20.union([
+      z20.literal("LibrarySystem"),
+      z20.literal("Library")
+    ]),
+    name: z20.string(),
+    url: z20.url().optional(),
+    /** Unique identifier for the library system */
+    "@id": z20.string().optional()
+  }),
+  /** Where the borrow action is performed */
+  target: z20.union([EntryPointSchema, z20.string()])
+});
+var BookEditionSchema = z20.object({
+  "@type": z20.literal("Book").default("Book"),
+  /** Unique stable URL identifying this edition */
+  "@id": z20.string().optional(),
+  /** Edition title — may differ from the work title */
+  name: z20.string().optional(),
+  /** Physical/digital format */
+  bookFormat: BookFormatType.optional(),
+  /** BCP 47 language tag, e.g. "en", "fr" */
+  inLanguage: z20.string().optional(),
+  /** ISBN-13 preferred; ISBN-10 also accepted */
+  isbn: z20.string().optional(),
+  /** OCLC number (for library systems) */
+  sameAs: z20.union([z20.string(), z20.array(z20.string())]).optional(),
+  /** Edition number, e.g. "2nd" */
+  bookEdition: z20.string().optional(),
+  /** Publication date for this edition */
+  datePublished: z20.string().optional(),
+  /** Landing page for this edition */
+  url: z20.url().optional(),
+  /** Authors of this edition (may differ from work author) */
+  author: z20.union([PersonOrOrgRef, z20.array(PersonOrOrgRef)]).optional(),
+  /** ReadAction or BorrowAction for Google Book Actions */
+  potentialAction: z20.union([
+    ReadActionSchema,
+    BorrowActionSchema,
+    z20.array(z20.union([ReadActionSchema, BorrowActionSchema]))
+  ]).optional(),
+  /** Offer — purchase price */
+  offers: z20.union([OfferSchema, z20.array(OfferSchema)]).optional()
+});
+var BookSchema = z20.object({
+  "@type": z20.literal("Book").default("Book"),
+  /** Stable URL identifying this work */
+  "@id": z20.string().optional(),
+  name: z20.string(),
+  /** Primary author(s) of the work */
+  author: z20.union([PersonOrOrgRef, z20.array(PersonOrOrgRef)]),
+  /** Canonical URL for the book's landing page */
+  url: z20.url().optional(),
+  /** Cover image */
+  image: z20.union([ImageOrUrl, z20.array(ImageOrUrl)]).optional(),
+  description: z20.string().optional(),
+  /** ISBN of the primary edition */
+  isbn: z20.string().optional(),
+  /** Same-as links (e.g., Open Library, WorldCat) */
+  sameAs: z20.union([z20.string(), z20.array(z20.string())]).optional(),
+  /** Specific editions — each may have ReadAction / BorrowAction */
+  workExample: z20.union([BookEditionSchema, z20.array(BookEditionSchema)]).optional(),
+  /** Publisher of the primary edition */
+  publisher: z20.object({
+    "@type": z20.union([z20.literal("Organization"), z20.literal("Person")]),
+    name: z20.string(),
+    url: z20.url().optional()
+  }).optional(),
+  /** Number of pages */
+  numberOfPages: z20.number().int().positive().optional(),
+  /** Original publication year */
+  datePublished: z20.string().optional(),
+  /** Genres */
+  genre: z20.union([z20.string(), z20.array(z20.string())]).optional(),
+  /** BCP 47 language tag */
+  inLanguage: z20.string().optional(),
+  /** Aggregate rating across editions */
+  aggregateRating: z20.lazy(
+    () => z20.object({ "@type": z20.string() }).catchall(z20.unknown())
+  ).optional()
+});
+var createBook = makeFactory(BookSchema);
+
+// src/types/creative-works/Article.ts
+import { z as z22 } from "zod";
+
+// src/types/creative-works/CreativeWork.ts
+import { z as z21 } from "zod";
+var CreativeWorkSchema = extendThing("CreativeWork", {
+  author: PersonOrOrgRef.optional(),
+  publisher: PersonOrOrgRef.optional(),
+  datePublished: z21.string().optional(),
+  // ISO 8601
+  dateModified: z21.string().optional(),
+  // ISO 8601
+  headline: z21.string().max(110).optional(),
+  // Google recommends max 110 chars
+  keywords: z21.union([z21.string(), z21.array(z21.string())]).optional(),
+  inLanguage: z21.union([
+    z21.string(),
+    // BCP 47, e.g. "en-US"
+    z21.object({ "@type": z21.literal("Language"), name: z21.string() })
+  ]).optional(),
+  license: z21.url().optional(),
+  thumbnailUrl: z21.url().optional(),
+  isAccessibleForFree: z21.boolean().optional(),
+  image: z21.union([ImageOrUrl, z21.array(ImageOrUrl)]).optional(),
+  // Paywalled content support:
+  hasPart: z21.array(z21.object({
+    "@type": z21.string(),
+    isAccessibleForFree: z21.boolean().optional(),
+    cssSelector: z21.string().optional()
+  })).optional(),
+  // For subscription / paywalled content
+  isPartOf: z21.object({
+    "@type": z21.string(),
+    name: z21.string().optional()
+  }).optional(),
+  text: z21.string().optional(),
+  abstract: z21.string().optional(),
+  encodingFormat: z21.string().optional(),
+  // MIME type
+  contentUrl: z21.url().optional(),
+  copyrightYear: z21.number().int().optional(),
+  copyrightHolder: PersonOrOrgRef.optional()
+});
+
+// src/types/creative-works/Article.ts
+var ArticleSchema = CreativeWorkSchema.extend({
+  "@type": z22.literal("Article").default("Article"),
+  articleBody: z22.string().optional(),
+  articleSection: z22.string().optional(),
+  wordCount: z22.number().int().nonnegative().optional(),
+  // Google Article requires image to be at least 1200px wide
+  image: z22.union([ImageOrUrl, z22.array(ImageOrUrl)]).optional(),
+  video: z22.union([VideoObjectSchema, z22.array(VideoObjectSchema)]).optional(),
+  // Speakable for Article (Google Assistant)
+  speakable: z22.object({
+    "@type": z22.literal("SpeakableSpecification").default("SpeakableSpecification"),
+    cssSelector: z22.union([z22.string(), z22.array(z22.string())]).optional(),
+    xpath: z22.union([z22.string(), z22.array(z22.string())]).optional()
+  }).optional()
+});
+var NewsArticleSchema = ArticleSchema.extend({
+  "@type": z22.literal("NewsArticle").default("NewsArticle"),
+  dateline: z22.string().optional(),
+  printColumn: z22.string().optional(),
+  printEdition: z22.string().optional(),
+  printPage: z22.string().optional(),
+  printSection: z22.string().optional()
+});
+var BlogPostingSchema = ArticleSchema.extend({
+  "@type": z22.literal("BlogPosting").default("BlogPosting"),
+  sharedContent: z22.lazy(
+    () => z22.object({ "@type": z22.string() }).passthrough()
+  ).optional()
+});
+var createArticle = makeFactory(ArticleSchema);
+var createNewsArticle = makeFactory(NewsArticleSchema);
+var createBlogPosting = makeFactory(BlogPostingSchema);
+
+// src/types/creative-works/WebPage.ts
+import { z as z23 } from "zod";
+var WebPageSchema = CreativeWorkSchema.extend({
+  "@type": z23.literal("WebPage").default("WebPage"),
+  breadcrumb: z23.lazy(
+    () => z23.object({ "@type": z23.literal("BreadcrumbList") }).catchall(z23.unknown())
+  ).optional(),
+  lastReviewed: z23.string().optional(),
+  reviewedBy: PersonOrOrgRef.optional(),
+  speakable: z23.object({
+    "@type": z23.literal("SpeakableSpecification").default("SpeakableSpecification"),
+    cssSelector: z23.union([z23.string(), z23.array(z23.string())]).optional(),
+    xpath: z23.union([z23.string(), z23.array(z23.string())]).optional()
+  }).optional(),
+  significantLink: z23.union([z23.url(), z23.array(z23.url())]).optional(),
+  mainContentOfPage: z23.object({ "@type": z23.string() }).catchall(z23.unknown()).optional(),
+  primaryImageOfPage: z23.object({ "@type": z23.string() }).catchall(z23.unknown()).optional(),
+  relatedLink: z23.union([z23.url(), z23.array(z23.url())]).optional()
+});
+var createWebPage = makeFactory(WebPageSchema);
+
+// src/types/creative-works/WebSite.ts
+import { z as z24 } from "zod";
+var WebSiteSchema = CreativeWorkSchema.extend({
+  "@type": z24.literal("WebSite").default("WebSite"),
+  url: z24.url().optional(),
+  name: z24.string().optional(),
+  /**
+   * Sitelinks Searchbox via SearchAction.
+   * @deprecated Google removed the Sitelinks Searchbox feature in November 2024.
+   * This field is still valid JSON-LD and harmless to include, but Google no
+   * longer displays a search box in branded search results.
+   * See: https://developers.google.com/search/blog/2024/11/retiring-sitelinks-searchbox
+   */
+  potentialAction: z24.object({
+    "@type": z24.literal("SearchAction"),
+    target: z24.union([
+      z24.string(),
+      z24.object({
+        "@type": z24.literal("EntryPoint"),
+        urlTemplate: z24.string()
+      })
+    ]),
+    "query-input": z24.string().optional()
+  }).optional(),
+  // Content language(s)
+  inLanguage: z24.union([z24.string(), z24.array(z24.string())]).optional(),
+  // Authorship / ownership
+  publisher: PersonOrOrgRef.optional(),
+  // Site-level metadata
+  copyrightYear: z24.number().int().optional(),
+  // isPartOf — rarely used for WebSite itself but allowed
+  isPartOf: z24.lazy(
+    () => z24.object({ "@type": z24.string() }).catchall(z24.unknown())
+  ).optional()
+});
+var createWebSite = makeFactory(WebSiteSchema);
+
+// src/types/creative-works/Dataset.ts
+import { z as z25 } from "zod";
+var PropertyValueSchema = z25.object({
+  "@type": z25.literal("PropertyValue").default("PropertyValue"),
+  propertyID: z25.string().optional(),
+  // e.g. "DOI", "SPDX"
+  name: z25.string().optional(),
+  value: z25.union([z25.string(), z25.number()]),
+  url: z25.url().optional(),
+  description: z25.string().optional()
+});
+var DatasetSchema = CreativeWorkSchema.extend({
+  "@type": z25.literal("Dataset").default("Dataset"),
+  // Required by Google:
+  name: z25.string(),
+  description: z25.string(),
+  // Recommended by Google:
+  url: z25.url().optional(),
+  sameAs: z25.union([z25.url(), z25.array(z25.url())]).optional(),
+  identifier: z25.union([
+    z25.string(),
+    PropertyValueSchema,
+    z25.array(z25.union([z25.string(), PropertyValueSchema]))
+  ]).optional(),
+  keywords: z25.union([z25.string(), z25.array(z25.string())]).optional(),
+  license: z25.url().optional(),
+  isAccessibleForFree: z25.boolean().optional(),
+  creator: z25.union([PersonOrOrgRef, z25.array(PersonOrOrgRef)]).optional(),
+  citation: z25.union([z25.string(), z25.array(z25.string())]).optional(),
+  variableMeasured: z25.union([z25.string(), z25.array(z25.string())]).optional(),
+  measurementTechnique: z25.union([z25.string(), z25.array(z25.string())]).optional(),
+  temporalCoverage: z25.string().optional(),
+  // ISO 8601 or date range string
+  spatialCoverage: z25.union([
+    z25.string(),
+    z25.object({ "@type": z25.literal("Place"), name: z25.string() })
+  ]).optional(),
+  distribution: z25.array(z25.object({
+    "@type": z25.literal("DataDownload").default("DataDownload"),
+    encodingFormat: z25.string(),
+    // MIME type or format name
+    contentUrl: z25.url(),
+    name: z25.string().optional(),
+    description: z25.string().optional()
+  })).optional(),
+  includedInDataCatalog: z25.object({
+    "@type": z25.literal("DataCatalog").default("DataCatalog"),
+    name: z25.string(),
+    url: z25.url().optional()
+  }).optional(),
+  datePublished: z25.string().optional(),
+  // ISO 8601
+  dateModified: z25.string().optional(),
+  version: z25.union([z25.string(), z25.number()]).optional()
+});
+var createDataset = makeFactory(DatasetSchema);
+
+// src/types/creative-works/Recipe.ts
+import { z as z27 } from "zod";
+
+// src/types/shared/HowToStep.ts
+import { z as z26 } from "zod";
+var HowToStepSchema = z26.object({
+  "@type": z26.literal("HowToStep").default("HowToStep"),
+  name: z26.string().optional(),
+  // Step title (avoid "Step 1" format per Google)
+  text: z26.string(),
+  // Step description
+  url: z26.string().url().optional(),
+  // Anchor link to step
+  image: ImageOrUrl.optional()
+});
+var HowToSectionSchema = z26.object({
+  "@type": z26.literal("HowToSection").default("HowToSection"),
+  name: z26.string(),
+  itemListElement: z26.array(HowToStepSchema),
+  description: z26.string().optional()
+});
+
+// src/types/creative-works/Recipe.ts
+var NutritionInformationSchema = z27.object({
+  "@type": z27.literal("NutritionInformation").default("NutritionInformation"),
+  calories: z27.string().optional(),
+  // e.g. "270 calories"
+  carbohydrateContent: z27.string().optional(),
+  // e.g. "20 grams"
+  cholesterolContent: z27.string().optional(),
+  fatContent: z27.string().optional(),
+  fiberContent: z27.string().optional(),
+  proteinContent: z27.string().optional(),
+  saturatedFatContent: z27.string().optional(),
+  servingSize: z27.string().optional(),
+  sodiumContent: z27.string().optional(),
+  sugarContent: z27.string().optional(),
+  transFatContent: z27.string().optional(),
+  unsaturatedFatContent: z27.string().optional()
+});
+var RecipeSchema = CreativeWorkSchema.extend({
+  "@type": z27.literal("Recipe").default("Recipe"),
+  // Required by Google:
+  name: z27.string(),
+  image: z27.union([ImageOrUrl, z27.array(ImageOrUrl)]),
+  // Recommended by Google:
+  author: z27.union([PersonOrOrgRef, z27.array(PersonOrOrgRef)]).optional(),
+  datePublished: z27.string().optional(),
+  // ISO 8601 date
+  description: z27.string().optional(),
+  prepTime: z27.string().optional(),
+  // ISO 8601 duration, e.g. "PT15M"
+  cookTime: z27.string().optional(),
+  // ISO 8601 duration
+  totalTime: z27.string().optional(),
+  // ISO 8601 duration
+  recipeYield: z27.union([z27.string(), z27.number(), z27.array(z27.string())]).optional(),
+  recipeCategory: z27.string().optional(),
+  // e.g. "Dessert", "Dinner"
+  recipeCuisine: z27.string().optional(),
+  // e.g. "Italian", "French"
+  recipeIngredient: z27.array(z27.string()).optional(),
+  recipeInstructions: z27.array(
+    z27.union([z27.string(), HowToStepSchema, HowToSectionSchema])
+  ).optional(),
+  nutrition: NutritionInformationSchema.optional(),
+  video: z27.union([VideoObjectSchema, z27.array(VideoObjectSchema)]).optional(),
+  aggregateRating: AggregateRatingSchema.optional(),
+  review: z27.union([ReviewSchema, z27.array(ReviewSchema)]).optional(),
+  keywords: z27.union([z27.string(), z27.array(z27.string())]).optional(),
+  cookingMethod: z27.string().optional(),
+  suitableForDiet: z27.union([z27.string(), z27.array(z27.string())]).optional(),
+  // schema.org enum URL
+  estimatedCost: z27.string().optional()
+});
+var createRecipe = makeFactory(RecipeSchema);
+
+// src/types/creative-works/Course.ts
+import { z as z28 } from "zod";
+var CourseInstanceSchema = z28.object({
+  "@type": z28.literal("CourseInstance").default("CourseInstance"),
+  courseMode: z28.union([z28.string(), z28.array(z28.string())]),
+  // "online", "onsite", "blended"
+  instructor: z28.union([PersonOrOrgRef, z28.array(PersonOrOrgRef)]).optional(),
+  startDate: z28.string().optional(),
+  // ISO 8601
+  endDate: z28.string().optional(),
+  // ISO 8601
+  location: z28.union([z28.string(), PostalAddressSchema]).optional(),
+  offers: z28.union([OfferSchema, z28.array(OfferSchema)]).optional(),
+  courseWorkload: z28.string().optional(),
+  // ISO 8601 duration, e.g. "PT10H"
+  courseSchedule: z28.object({
+    "@type": z28.literal("Schedule").default("Schedule"),
+    repeatFrequency: z28.string().optional(),
+    // e.g. "P1W"
+    repeatCount: z28.number().optional(),
+    startDate: z28.string().optional(),
+    endDate: z28.string().optional()
+  }).optional()
+});
+var CourseSchema = CreativeWorkSchema.extend({
+  "@type": z28.literal("Course").default("Course"),
+  // Required by Google:
+  name: z28.string(),
+  description: z28.string(),
+  // Recommended by Google:
+  provider: z28.union([PersonOrOrgRef, z28.array(PersonOrOrgRef)]).optional(),
+  hasCourseInstance: z28.union([CourseInstanceSchema, z28.array(CourseInstanceSchema)]).optional(),
+  // Optional:
+  coursePrerequisites: z28.union([z28.string(), z28.array(z28.string())]).optional(),
+  educationalCredentialAwarded: z28.union([
+    z28.string(),
+    z28.object({
+      "@type": z28.literal("EducationalOccupationalCredential").default("EducationalOccupationalCredential"),
+      name: z28.string(),
+      url: z28.url().optional()
+    })
+  ]).optional(),
+  occupationalCredentialAwarded: z28.union([z28.string(), z28.array(z28.string())]).optional(),
+  numberOfCredits: z28.union([
+    z28.number(),
+    z28.object({
+      "@type": z28.literal("StructuredValue").default("StructuredValue"),
+      value: z28.number()
+    })
+  ]).optional(),
+  financialAidEligible: z28.union([z28.string(), z28.boolean()]).optional(),
+  aggregateRating: AggregateRatingSchema.optional(),
+  image: z28.union([ImageOrUrl, z28.array(ImageOrUrl)]).optional(),
+  offers: z28.union([OfferSchema, z28.array(OfferSchema)]).optional(),
+  inLanguage: z28.union([z28.string(), z28.array(z28.string())]).optional(),
+  syllabusSections: z28.array(z28.object({
+    "@type": z28.literal("Syllabus").default("Syllabus"),
+    name: z28.string(),
+    description: z28.string().optional()
+  })).optional()
+});
+var createCourse = makeFactory(CourseSchema);
+
+// src/types/creative-works/SoftwareApplication.ts
+import { z as z29 } from "zod";
+var ApplicationCategory = z29.enum([
+  "GameApplication",
+  "SocialNetworkingApplication",
+  "TravelApplication",
+  "ShoppingApplication",
+  "SportsApplication",
+  "LifestyleApplication",
+  "BusinessApplication",
+  "DesignApplication",
+  "DeveloperApplication",
+  "DriverApplication",
+  "EducationalApplication",
+  "HealthApplication",
+  "FinanceApplication",
+  "SecurityApplication",
+  "BrowserApplication",
+  "CommunicationApplication",
+  "DesktopEnhancementApplication",
+  "EntertainmentApplication",
+  "MultimediaApplication",
+  "HomeApplication",
+  "UtilitiesApplication",
+  "ReferenceApplication"
+]);
+var SoftwareApplicationSchema = CreativeWorkSchema.extend({
+  "@type": z29.union([
+    z29.literal("SoftwareApplication"),
+    z29.literal("MobileApplication"),
+    z29.literal("WebApplication"),
+    z29.literal("VideoGame")
+  ]).default("SoftwareApplication"),
+  // Required by Google:
+  name: z29.string(),
+  // Recommended by Google:
+  operatingSystem: z29.union([z29.string(), z29.array(z29.string())]).optional(),
+  applicationCategory: z29.union([ApplicationCategory, z29.string()]).optional(),
+  offers: z29.union([OfferSchema, z29.array(OfferSchema)]).optional(),
+  aggregateRating: AggregateRatingSchema.optional(),
+  review: z29.union([ReviewSchema, z29.array(ReviewSchema)]).optional(),
+  // Optional:
+  softwareVersion: z29.string().optional(),
+  fileSize: z29.string().optional(),
+  downloadUrl: z29.url().optional(),
+  screenshot: z29.union([ImageOrUrl, z29.array(ImageOrUrl)]).optional(),
+  featureList: z29.union([z29.string(), z29.array(z29.string())]).optional(),
+  installUrl: z29.url().optional(),
+  softwareRequirements: z29.string().optional(),
+  permissions: z29.string().optional(),
+  // WebApplication specific:
+  browserRequirements: z29.string().optional(),
+  // MobileApplication specific:
+  countriesSupported: z29.union([z29.string(), z29.array(z29.string())]).optional(),
+  countriesNotSupported: z29.union([z29.string(), z29.array(z29.string())]).optional(),
+  availableOnDevice: z29.union([z29.string(), z29.array(z29.string())]).optional(),
+  // VideoGame specific:
+  gamePlatform: z29.union([z29.string(), z29.array(z29.string())]).optional(),
+  playMode: z29.string().optional(),
+  genre: z29.union([z29.string(), z29.array(z29.string())]).optional()
+});
+var createSoftwareApplication = makeFactory(SoftwareApplicationSchema);
+var createMobileApplication = makeFactory(
+  SoftwareApplicationSchema.extend({
+    "@type": z29.literal("MobileApplication").default("MobileApplication")
+  })
+);
+var createWebApplication = makeFactory(
+  SoftwareApplicationSchema.extend({
+    "@type": z29.literal("WebApplication").default("WebApplication")
+  })
+);
+
+// src/types/creative-works/MathSolver.ts
+import { z as z30 } from "zod";
+var SolveMathActionSchema = z30.object({
+  "@type": z30.literal("SolveMathAction").default("SolveMathAction"),
+  eduQuestionType: z30.string().optional(),
+  // e.g. "Algebra", "Calculus"
+  mathExpression: z30.string().optional(),
+  target: z30.object({
+    "@type": z30.literal("EntryPoint").default("EntryPoint"),
+    urlTemplate: z30.string().optional(),
+    actionAccessibilityRequirement: z30.object({
+      "@type": z30.literal("ActionAccessSpecification").default("ActionAccessSpecification"),
+      requiresSubscription: z30.boolean().optional()
+    }).optional()
+  }).optional()
+});
+var MathSolverSchema = CreativeWorkSchema.extend({
+  "@type": z30.literal("MathSolver").default("MathSolver"),
+  name: z30.string(),
+  url: z30.url().optional(),
+  potentialAction: z30.union([SolveMathActionSchema, z30.array(SolveMathActionSchema)]).optional(),
+  mathExpression: z30.union([z30.string(), z30.array(z30.string())]).optional(),
+  educationalLevel: z30.string().optional(),
+  teaches: z30.union([z30.string(), z30.array(z30.string())]).optional()
+});
+var createMathSolver = makeFactory(MathSolverSchema);
+
+// src/types/intangibles/Language.ts
+import { z as z31 } from "zod";
+var LanguageSchema = extendThing("Language", {
+  // No additional properties beyond Thing for Language
+  // But you can attach any Thing props: name, alternateName, url, etc.
+});
+var createLanguage = makeFactory(LanguageSchema);
+var PronounceableTextSchema = z31.object({
+  "@type": z31.literal("PronounceableText").default("PronounceableText"),
+  textValue: z31.string(),
+  // Accepts either a BCP 47 string like "en-US" or a full Language object
+  inLanguage: z31.union([z31.string(), LanguageSchema]).optional(),
+  phoneticText: z31.string().optional(),
+  speechToTextMarkup: z31.string().optional()
+});
+var createPronounceableText = makeFactory(PronounceableTextSchema);
+
+// src/types/intangibles/JobPosting.ts
+import { z as z33 } from "zod";
+
+// src/types/shared/MonetaryAmount.ts
+import { z as z32 } from "zod";
+var MonetaryAmountSchema = z32.object({
+  "@type": z32.literal("MonetaryAmount").default("MonetaryAmount"),
+  currency: z32.string().length(3),
+  // ISO 4217, e.g. "USD"
+  value: z32.union([
+    z32.number(),
+    z32.object({
+      "@type": z32.literal("QuantitativeValue").default("QuantitativeValue"),
+      value: z32.number().optional(),
+      minValue: z32.number().optional(),
+      maxValue: z32.number().optional(),
+      unitText: z32.string().optional()
+      // e.g. "HOUR", "MONTH", "YEAR"
+    })
+  ]).optional(),
+  minValue: z32.number().optional(),
+  maxValue: z32.number().optional()
+});
+var PriceSpecificationSchema = z32.object({
+  "@type": z32.literal("PriceSpecification").default("PriceSpecification"),
+  price: z32.union([z32.number(), z32.string()]),
+  priceCurrency: z32.string().length(3),
+  // ISO 4217
+  minPrice: z32.number().optional(),
+  maxPrice: z32.number().optional(),
+  validFrom: z32.string().optional(),
+  // ISO 8601
+  validThrough: z32.string().optional(),
+  eligibleQuantity: z32.object({
+    "@type": z32.literal("QuantitativeValue").default("QuantitativeValue"),
+    value: z32.number().optional(),
+    minValue: z32.number().optional(),
+    maxValue: z32.number().optional()
+  }).optional()
+});
+
+// src/types/intangibles/JobPosting.ts
+var EmploymentType = z33.enum([
+  "FULL_TIME",
+  "PART_TIME",
+  "CONTRACTOR",
+  "TEMPORARY",
+  "INTERN",
+  "VOLUNTEER",
+  "PER_DIEM",
+  "OTHER"
+]);
+var HiringOrgRef = z33.object({
+  "@type": z33.union([z33.literal("Organization"), z33.literal("LocalBusiness")]).default("Organization"),
+  name: z33.string(),
+  sameAs: z33.url().optional(),
+  logo: ImageOrUrl.optional(),
+  url: z33.url().optional()
+});
+var JobLocationRef = z33.object({
+  "@type": z33.literal("Place").default("Place"),
+  address: z33.union([z33.string(), PostalAddressSchema])
+});
+var JobPostingSchema = z33.object({
+  "@type": z33.literal("JobPosting").default("JobPosting"),
+  // Required by Google:
+  title: z33.string(),
+  description: z33.string(),
+  hiringOrganization: HiringOrgRef,
+  jobLocation: z33.union([JobLocationRef, z33.array(JobLocationRef)]).optional(),
+  datePosted: z33.string(),
+  // ISO 8601 date
+  // Recommended by Google:
+  validThrough: z33.string().optional(),
+  // ISO 8601 datetime
+  employmentType: z33.union([EmploymentType, z33.array(EmploymentType)]).optional(),
+  baseSalary: MonetaryAmountSchema.optional(),
+  jobLocationType: z33.string().optional(),
+  // "TELECOMMUTE" for remote
+  applicantLocationRequirements: z33.union([
+    z33.object({ "@type": z33.string(), name: z33.string() }),
+    z33.array(z33.object({ "@type": z33.string(), name: z33.string() }))
+  ]).optional(),
+  directApply: z33.boolean().optional(),
+  // Optional:
+  identifier: z33.object({
+    "@type": z33.literal("PropertyValue").default("PropertyValue"),
+    name: z33.string().optional(),
+    value: z33.union([z33.string(), z33.number()])
+  }).optional(),
+  experienceRequirements: z33.union([
+    z33.string(),
+    z33.object({
+      "@type": z33.literal("OccupationalExperienceRequirements").default("OccupationalExperienceRequirements"),
+      monthsOfExperience: z33.number()
+    })
+  ]).optional(),
+  educationRequirements: z33.union([
+    z33.string(),
+    z33.object({
+      "@type": z33.literal("EducationalOccupationalCredential").default("EducationalOccupationalCredential"),
+      credentialCategory: z33.string()
+      // e.g. "bachelor degree", "high school"
+    })
+  ]).optional(),
+  experienceInPlaceOfEducation: z33.boolean().optional(),
+  qualifications: z33.string().optional(),
+  responsibilities: z33.string().optional(),
+  skills: z33.union([z33.string(), z33.array(z33.string())]).optional(),
+  industry: z33.string().optional(),
+  occupationalCategory: z33.string().optional(),
+  // O*NET-SOC codes
+  workHours: z33.string().optional(),
+  url: z33.url().optional(),
+  sameAs: z33.url().optional()
+});
+var createJobPosting = makeFactory(JobPostingSchema);
+
+// src/types/intangibles/QAPage.ts
+import { z as z34 } from "zod";
+var AnswerSchema = z34.object({
+  "@type": z34.literal("Answer").default("Answer"),
+  text: z34.string(),
+  dateCreated: z34.string().optional(),
+  // ISO 8601
+  upvoteCount: z34.number().int().nonnegative().optional(),
+  url: z34.url().optional(),
+  author: PersonOrOrgRef.optional()
+});
+var QuestionSchema = z34.object({
+  "@type": z34.literal("Question").default("Question"),
+  name: z34.string(),
+  // The question text (also used as headline)
+  text: z34.string().optional(),
+  // Extended question text
+  acceptedAnswer: z34.union([AnswerSchema, z34.array(AnswerSchema)]).optional(),
+  suggestedAnswer: z34.union([AnswerSchema, z34.array(AnswerSchema)]).optional(),
+  answerCount: z34.number().int().nonnegative().optional(),
+  upvoteCount: z34.number().int().nonnegative().optional(),
+  author: PersonOrOrgRef.optional(),
+  dateCreated: z34.string().optional(),
+  datePublished: z34.string().optional(),
+  url: z34.url().optional()
+});
+var FAQPageSchema = WebPageSchema.extend({
+  "@type": z34.literal("FAQPage").default("FAQPage"),
+  mainEntity: z34.array(QuestionSchema)
+});
+var QAPageSchema = WebPageSchema.extend({
+  "@type": z34.literal("QAPage").default("QAPage"),
+  mainEntity: QuestionSchema
+});
+var QuizSchema = CreativeWorkSchema.extend({
+  "@type": z34.literal("Quiz").default("Quiz"),
+  name: z34.string().optional(),
+  educationalLevel: z34.string().optional(),
+  about: z34.lazy(
+    () => z34.object({ "@type": z34.string() }).catchall(z34.unknown())
+  ).optional(),
+  hasPart: z34.array(QuestionSchema).optional(),
+  educationalAlignment: z34.object({
+    "@type": z34.literal("AlignmentObject").default("AlignmentObject"),
+    alignmentType: z34.string().optional(),
+    targetName: z34.string().optional(),
+    targetUrl: z34.url().optional()
+  }).optional()
+});
+var createFAQPage = makeFactory(FAQPageSchema);
+var createQAPage = makeFactory(QAPageSchema);
+var createQuiz = makeFactory(QuizSchema);
+var createQuestion = makeFactory(QuestionSchema);
+
+// src/types/intangibles/DiscussionForum.ts
+import { z as z35 } from "zod";
+var DiscussionForumPostingSchema = CreativeWorkSchema.extend({
+  "@type": z35.literal("DiscussionForumPosting").default("DiscussionForumPosting"),
+  // Required by Google:
+  headline: z35.string(),
+  author: PersonOrOrgRef,
+  // Recommended:
+  text: z35.string().optional(),
+  datePublished: z35.string().optional(),
+  // ISO 8601
+  url: z35.url().optional(),
+  comment: z35.array(z35.object({
+    "@type": z35.literal("Comment").default("Comment"),
+    text: z35.string(),
+    author: PersonOrOrgRef.optional(),
+    datePublished: z35.string().optional(),
+    upvoteCount: z35.number().int().nonnegative().optional(),
+    downvoteCount: z35.number().int().nonnegative().optional(),
+    url: z35.url().optional()
+  })).optional(),
+  commentCount: z35.number().int().nonnegative().optional(),
+  upvoteCount: z35.number().int().nonnegative().optional(),
+  downvoteCount: z35.number().int().nonnegative().optional(),
+  image: ImageOrUrl.optional(),
+  // For reposts:
+  sharedContent: z35.lazy(
+    () => z35.object({ "@type": z35.string() }).catchall(z35.unknown())
+  ).optional(),
+  interactionStatistic: z35.array(z35.object({
+    "@type": z35.literal("InteractionCounter").default("InteractionCounter"),
+    interactionType: z35.string(),
+    userInteractionCount: z35.number().int().nonnegative()
+  })).optional()
+});
+var createDiscussionForumPosting = makeFactory(DiscussionForumPostingSchema);
+
+// src/types/intangibles/ItemList.ts
+import { z as z36 } from "zod";
+var ListItemSchema = z36.object({
+  "@type": z36.literal("ListItem").default("ListItem"),
+  position: z36.number().int().positive(),
+  url: z36.url().optional(),
+  name: z36.string().optional(),
+  // item: the actual entity being listed (loose ref to any schema node)
+  item: z36.lazy(
+    () => z36.object({ "@type": z36.string() }).catchall(z36.unknown())
+  ).optional()
+});
+var ItemListSchema = z36.object({
+  "@type": z36.literal("ItemList").default("ItemList"),
+  name: z36.string().optional(),
+  description: z36.string().optional(),
+  url: z36.url().optional(),
+  itemListOrder: z36.enum(["Ascending", "Descending", "Unordered"]).transform((v) => `https://schema.org/ItemListOrder${v}`).optional(),
+  numberOfItems: z36.number().int().nonnegative().optional(),
+  itemListElement: z36.array(
+    z36.union([
+      ListItemSchema,
+      z36.object({ "@type": z36.string() }).catchall(z36.unknown())
+    ])
+  )
+});
+var createItemList = makeFactory(ItemListSchema);
+
+// src/types/intangibles/ProfilePage.ts
+import { z as z37 } from "zod";
+var ProfilePageSchema = WebPageSchema.extend({
+  "@type": z37.literal("ProfilePage").default("ProfilePage"),
+  // mainEntity: the person or org this profile is about (loose ref to avoid circular imports)
+  mainEntity: z37.lazy(
+    () => z37.object({ "@type": z37.string() }).catchall(z37.unknown())
+  ).optional(),
+  // hasPart: content published by/about this profile subject
+  hasPart: z37.array(
+    z37.lazy(() => z37.object({ "@type": z37.string() }).catchall(z37.unknown()))
+  ).optional(),
+  dateCreated: z37.string().optional(),
+  dateModified: z37.string().optional()
+});
+var createProfilePage = makeFactory(ProfilePageSchema);
+
+// src/types/lodging/VacationRental.ts
+import { z as z38 } from "zod";
+var BedTypeEnum = z38.enum([
+  "Single bed",
+  "Double bed",
+  "Bunk bed",
+  "Queen bed",
+  "King bed",
+  "Sofa bed",
+  "Cot",
+  "Waterbed",
+  "Toddler bed"
+]);
+var BedDetailsSchema = z38.object({
+  "@type": z38.literal("BedDetails").default("BedDetails"),
+  numberOfBeds: z38.number().int().positive().optional(),
+  typeOfBed: z38.union([BedTypeEnum, z38.string()]).optional()
+});
+var LocationFeatureSpecificationSchema = z38.object({
+  "@type": z38.literal("LocationFeatureSpecification").default("LocationFeatureSpecification"),
+  name: z38.string(),
+  value: z38.union([z38.boolean(), z38.string(), z38.number()]).optional()
+});
+var AccommodationSchema = z38.object({
+  "@type": z38.literal("Accommodation").default("Accommodation"),
+  name: z38.string().optional(),
+  occupancy: z38.object({
+    "@type": z38.literal("QuantitativeValue").default("QuantitativeValue"),
+    value: z38.number().int().positive().optional(),
+    maxValue: z38.number().int().positive().optional(),
+    minValue: z38.number().int().positive().optional()
+  }).optional(),
+  numberOfRooms: z38.number().int().nonnegative().optional(),
+  numberOfBedrooms: z38.number().int().nonnegative().optional(),
+  numberOfBathroomsTotal: z38.number().int().nonnegative().optional(),
+  floorSize: z38.object({
+    "@type": z38.literal("QuantitativeValue").default("QuantitativeValue"),
+    value: z38.number(),
+    /** "MTK" = sq metres, "FTK" = sq ft */
+    unitCode: z38.string().optional()
+  }).optional(),
+  bed: z38.union([BedDetailsSchema, z38.array(BedDetailsSchema)]).optional(),
+  amenityFeature: z38.union([
+    LocationFeatureSpecificationSchema,
+    z38.array(LocationFeatureSpecificationSchema)
+  ]).optional(),
+  petsAllowed: z38.union([z38.boolean(), z38.string()]).optional(),
+  url: z38.url().optional()
+});
+var VacationRentalSchema = LocalBusinessSchema.extend({
+  "@type": z38.literal("VacationRental").default("VacationRental"),
+  // Required by Google:
+  name: z38.string(),
+  // Recommended by Google:
+  description: z38.string().optional(),
+  image: z38.union([ImageOrUrl, z38.array(ImageOrUrl)]).optional(),
+  // Lodging-specific:
+  petsAllowed: z38.union([z38.boolean(), z38.string()]).optional(),
+  checkinTime: z38.string().optional(),
+  // e.g. "15:00"
+  checkoutTime: z38.string().optional(),
+  // e.g. "11:00"
+  numberOfRooms: z38.union([
+    z38.number(),
+    z38.object({
+      "@type": z38.literal("QuantitativeValue").default("QuantitativeValue"),
+      value: z38.number()
+    })
+  ]).optional(),
+  occupancy: z38.object({
+    "@type": z38.literal("QuantitativeValue").default("QuantitativeValue"),
+    maxValue: z38.number(),
+    minValue: z38.number().optional()
+  }).optional(),
+  starRating: z38.object({
+    "@type": z38.literal("Rating").default("Rating"),
+    ratingValue: z38.number().min(0).max(5)
+  }).optional(),
+  offers: z38.union([OfferSchema, z38.array(OfferSchema)]).optional(),
+  leaseLength: z38.union([z38.string(), z38.object({
+    "@type": z38.literal("QuantitativeValue").default("QuantitativeValue"),
+    value: z38.number(),
+    unitCode: z38.string().optional()
+  })]).optional(),
+  floorSize: z38.object({
+    "@type": z38.literal("QuantitativeValue").default("QuantitativeValue"),
+    value: z38.number(),
+    unitCode: z38.string().optional()
+    // e.g. "MTK" (square meters), "FTK" (sq ft)
+  }).optional(),
+  numberOfBathroomsTotal: z38.number().int().nonnegative().optional(),
+  numberOfBedrooms: z38.number().int().nonnegative().optional(),
+  tourBookingPage: z38.url().optional(),
+  /** Accommodation unit(s) within the rental property — required by Google */
+  containsPlace: z38.union([AccommodationSchema, z38.array(AccommodationSchema)]).optional()
+});
+var createVacationRental = makeFactory(VacationRentalSchema);
+
+// src/core/registry.ts
+var REGISTRY = {
+  // Things
+  Person: PersonSchema,
+  Organization: OrganizationSchema,
+  Product: ProductSchema,
+  ProductGroup: ProductGroupSchema,
+  Event: EventSchema,
+  Place: PlaceSchema,
+  LocalBusiness: LocalBusinessSchema,
+  Movie: MovieSchema,
+  // Creative Works
+  Book: BookSchema,
+  Article: ArticleSchema,
+  NewsArticle: NewsArticleSchema,
+  BlogPosting: BlogPostingSchema,
+  WebPage: WebPageSchema,
+  WebSite: WebSiteSchema,
+  Dataset: DatasetSchema,
+  Recipe: RecipeSchema,
+  Course: CourseSchema,
+  SoftwareApplication: SoftwareApplicationSchema,
+  MathSolver: MathSolverSchema,
+  // Intangibles
+  Language: LanguageSchema,
+  PronounceableText: PronounceableTextSchema,
+  JobPosting: JobPostingSchema,
+  FAQPage: FAQPageSchema,
+  QAPage: QAPageSchema,
+  Quiz: QuizSchema,
+  Question: QuestionSchema,
+  DiscussionForumPosting: DiscussionForumPostingSchema,
+  ItemList: ItemListSchema,
+  ProfilePage: ProfilePageSchema,
+  // Lodging
+  VacationRental: VacationRentalSchema,
+  // Shared types (useful in unified factory)
+  ImageObject: ImageObjectSchema,
+  Offer: OfferSchema,
+  Review: ReviewSchema,
+  VideoObject: VideoObjectSchema
+};
+function schema(type, data) {
+  const zodSchema = REGISTRY[type];
+  const parsed = zodSchema.parse(data);
+  return new SchemaNode(zodSchema, parsed);
+}
+
+// src/core/graph.ts
+var SchemaGraph = class {
+  constructor() {
+    this.items = [];
+  }
+  /**
+   * Add a SchemaNode or plain object to the graph.
+   * Returns `this` for fluent chaining.
+   */
+  add(node) {
+    if (node instanceof SchemaNode) {
+      this.items.push(node.toObject());
+    } else {
+      this.items.push(node);
+    }
+    return this;
+  }
+  /** Returns the raw array of graph items (without @context). */
+  toArray() {
+    return [...this.items];
+  }
+  /** Returns the full JSON-LD object with @context and @graph. */
+  toJsonLd() {
+    return {
+      "@context": "https://schema.org",
+      "@graph": this.items
+    };
+  }
+  /** Returns a <script type="application/ld+json"> tag string. */
+  toScript() {
+    return `<script type="application/ld+json">
+${JSON.stringify(this.toJsonLd(), null, 2)}
+</script>`;
+  }
+  /** Returns prettified JSON string. */
+  toString() {
+    return JSON.stringify(this.toJsonLd(), null, 2);
+  }
+};
+function createGraph(nodes) {
+  const graph = new SchemaGraph();
+  for (const node of nodes) {
+    graph.add(node);
+  }
+  return graph;
+}
+
+// src/helpers/breadcrumb.ts
+import { z as z39 } from "zod";
+var BreadcrumbListSchema = z39.object({
+  "@type": z39.literal("BreadcrumbList").default("BreadcrumbList"),
+  itemListElement: z39.array(
+    z39.object({
+      "@type": z39.literal("ListItem").default("ListItem"),
+      position: z39.number().int().positive(),
+      name: z39.string(),
+      item: z39.url().optional()
+    })
+  )
+});
+function createBreadcrumbList(items) {
+  const data = BreadcrumbListSchema.parse({
+    itemListElement: items.map((item, index) => ({
+      "@type": "ListItem",
+      position: index + 1,
+      name: item.name,
+      ...item.url ? { item: item.url } : {}
+    }))
+  });
+  return new SchemaNode(BreadcrumbListSchema, data);
+}
+
+// src/helpers/faq.ts
+function createFAQPage2(items) {
+  const data = FAQPageSchema.parse({
+    mainEntity: items.map(({ question, answer }) => ({
+      "@type": "Question",
+      name: question,
+      acceptedAnswer: {
+        "@type": "Answer",
+        text: answer
+      }
+    }))
+  });
+  return new SchemaNode(FAQPageSchema, data);
+}
+
+// src/helpers/itemlist.ts
+function createCarousel(items) {
+  const elements = items.map((item, index) => {
+    if (item instanceof SchemaNode) {
+      return {
+        "@type": "ListItem",
+        position: index + 1,
+        item: item.toObject()
+      };
+    }
+    return {
+      "@type": "ListItem",
+      position: index + 1,
+      url: item.url,
+      ...item.name ? { name: item.name } : {}
+    };
+  });
+  const data = ItemListSchema.parse({ itemListElement: elements });
+  return new SchemaNode(ItemListSchema, data);
+}
+
+// src/helpers/paywalled.ts
+function createPaywalledArticle(data, options) {
+  return createArticle({
+    ...data,
+    isAccessibleForFree: false,
+    hasPart: [{
+      "@type": "WebPageElement",
+      isAccessibleForFree: false,
+      cssSelector: options.cssSelector
+    }]
+  });
+}
+function createPaywalledWebPage(data, options) {
+  return createWebPage({
+    ...data,
+    isAccessibleForFree: false,
+    hasPart: [{
+      "@type": "WebPageElement",
+      isAccessibleForFree: false,
+      cssSelector: options.cssSelector
+    }]
+  });
+}
+export {
+  AccommodationSchema,
+  AggregateOfferSchema,
+  AggregateRatingSchema,
+  AnswerSchema,
+  ApplicationCategory,
+  ArticleSchema,
+  BedDetailsSchema,
+  BedTypeEnum,
+  BlogPostingSchema,
+  BookEditionSchema,
+  BookFormatType,
+  BookSchema,
+  BorrowActionSchema,
+  BroadcastEventSchema,
+  CertificationSchema,
+  ClipSchema,
+  ContactPointSchema,
+  CourseInstanceSchema,
+  CourseSchema,
+  CreativeWorkSchema,
+  DatasetSchema,
+  DayOfWeek,
+  DefinedRegionSchema,
+  DiscussionForumPostingSchema,
+  EmployerAggregateRatingSchema,
+  EmploymentType,
+  EventAttendanceMode,
+  EventSchema,
+  EventStatusType,
+  FAQPageSchema,
+  GeoCoordinatesSchema,
+  HowToSectionSchema,
+  HowToStepSchema,
+  ImageObjectSchema,
+  ImageOrUrl,
+  ItemAvailability,
+  ItemListSchema,
+  JobPostingSchema,
+  LanguageSchema,
+  ListItemSchema,
+  LocalBusinessSchema,
+  MathSolverSchema,
+  MerchantReturnPolicySchema,
+  MonetaryAmountSchema,
+  MovieSchema,
+  NewsArticleSchema,
+  NutritionInformationSchema,
+  OfferSchema,
+  OfferShippingDetailsSchema,
+  OpeningHoursSpecificationSchema,
+  OrganizationSchema,
+  PersonOrOrgRef,
+  PersonSchema,
+  PlaceSchema,
+  PostalAddressSchema,
+  PriceSpecificationSchema,
+  ProductGroupSchema,
+  ProductSchema,
+  ProfilePageSchema,
+  PronounceableTextSchema,
+  PropertyValueSchema,
+  QAPageSchema,
+  QuestionSchema,
+  QuizSchema,
+  RatingSchema,
+  ReadActionSchema,
+  RecipeSchema,
+  ReviewSchema,
+  SchemaGraph,
+  SchemaNode,
+  ShippingDeliveryTimeSchema,
+  SoftwareApplicationSchema,
+  SolveMathActionSchema,
+  ThingSchema,
+  ThreeDModelSchema,
+  VacationRentalSchema,
+  VideoObjectSchema,
+  WebPageSchema,
+  WebSiteSchema,
+  createArticle,
+  createBlogPosting,
+  createBook,
+  createBreadcrumbList,
+  createCarousel,
+  createCorporation,
+  createCourse,
+  createDataset,
+  createDiscussionForumPosting,
+  createEvent,
+  createFAQPage2 as createFAQPage,
+  createGraph,
+  createHotel,
+  createImageObject,
+  createItemList,
+  createJobPosting,
+  createLanguage,
+  createLocalBusiness,
+  createMathSolver,
+  createMobileApplication,
+  createMovie,
+  createNGO,
+  createNewsArticle,
+  createOffer,
+  createOnlineBusiness,
+  createOnlineStore,
+  createOrganization,
+  createPaywalledArticle,
+  createPaywalledWebPage,
+  createPerson,
+  createPlace,
+  createProduct,
+  createProductGroup,
+  createProfilePage,
+  createPronounceableText,
+  createQAPage,
+  createQuestion,
+  createQuiz,
+  createRecipe,
+  createRestaurant,
+  createSoftwareApplication,
+  createVacationRental,
+  createVideoObject,
+  createWebApplication,
+  createWebPage,
+  createWebSite,
+  extendThing,
+  makeFactory,
+  schema
+};