schemaorg-kit 1.1.0 → 1.2.0

package/dist/index.js

@@ -98,6 +98,7 @@ __export(index_exports, {
   RecipeSchema: () => RecipeSchema,
   ReviewSchema: () => ReviewSchema,
   SchemaGraph: () => SchemaGraph,
+  SchemaIds: () => SchemaIds,
   SchemaNode: () => SchemaNode,
   SeekToActionSchema: () => SeekToActionSchema,
   ServicePeriodSchema: () => ServicePeriodSchema,
@@ -213,7 +214,7 @@ function makeFactory(schema2) {
 }
 
 // src/types/things/Person.ts
-var import_zod6 = require("zod");
+var import_zod7 = require("zod");
 
 // src/types/things/Thing.ts
 var import_zod4 = require("zod");
@@ -225,6 +226,8 @@ var import_zod3 = require("zod");
 var import_zod2 = require("zod");
 var PersonOrOrgRef = import_zod2.z.union([
   import_zod2.z.string(),
+  // @id-only reference for @graph cross-referencing (e.g. { "@id": "https://example.com/#organization" })
+  import_zod2.z.object({ "@id": import_zod2.z.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.
   import_zod2.z.object({ "@type": import_zod2.z.literal("Person") }).catchall(import_zod2.z.unknown()),
@@ -234,15 +237,24 @@ var PersonOrOrgRef = import_zod2.z.union([
 // src/types/shared/ImageObject.ts
 var ImageObjectSchema = import_zod3.z.object({
   "@type": import_zod3.z.literal("ImageObject").default("ImageObject"),
+  "@id": import_zod3.z.string().optional(),
   url: import_zod3.z.url(),
   contentUrl: import_zod3.z.url().optional(),
   width: import_zod3.z.union([
     import_zod3.z.number(),
-    import_zod3.z.object({ "@type": import_zod3.z.literal("QuantitativeValue"), value: import_zod3.z.number(), unitCode: import_zod3.z.string().optional() })
+    import_zod3.z.object({
+      "@type": import_zod3.z.literal("QuantitativeValue").default("QuantitativeValue"),
+      value: import_zod3.z.number(),
+      unitCode: import_zod3.z.string().optional()
+    })
   ]).optional(),
   height: import_zod3.z.union([
     import_zod3.z.number(),
-    import_zod3.z.object({ "@type": import_zod3.z.literal("QuantitativeValue"), value: import_zod3.z.number(), unitCode: import_zod3.z.string().optional() })
+    import_zod3.z.object({
+      "@type": import_zod3.z.literal("QuantitativeValue").default("QuantitativeValue"),
+      value: import_zod3.z.number(),
+      unitCode: import_zod3.z.string().optional()
+    })
   ]).optional(),
   caption: import_zod3.z.string().optional(),
   description: import_zod3.z.string().optional(),
@@ -292,62 +304,56 @@ function extendThing(type, shape) {
   });
 }
 
-// src/types/shared/InteractionCounter.ts
+// src/types/shared/PostalAddress.ts
 var import_zod5 = require("zod");
-var InteractionCounterSchema = import_zod5.z.object({
-  "@type": import_zod5.z.literal("InteractionCounter").default("InteractionCounter"),
-  interactionType: import_zod5.z.string(),
+var PostalAddressSchema = import_zod5.z.object({
+  "@type": import_zod5.z.literal("PostalAddress").default("PostalAddress"),
+  streetAddress: import_zod5.z.string().optional(),
+  addressLocality: import_zod5.z.string().optional(),
+  // city
+  addressRegion: import_zod5.z.string().optional(),
+  // state/province
+  postalCode: import_zod5.z.string().optional(),
+  addressCountry: import_zod5.z.string().optional(),
+  // ISO 3166-1 alpha-2, e.g. "US"
+  postOfficeBoxNumber: import_zod5.z.string().optional()
+});
+
+// src/types/shared/InteractionCounter.ts
+var import_zod6 = require("zod");
+var InteractionCounterSchema = import_zod6.z.object({
+  "@type": import_zod6.z.literal("InteractionCounter").default("InteractionCounter"),
+  interactionType: import_zod6.z.string(),
   // full URL, e.g. "https://schema.org/LikeAction"
-  userInteractionCount: import_zod5.z.number().int().nonnegative()
+  userInteractionCount: import_zod6.z.number().int().nonnegative()
 });
 
 // src/types/things/Person.ts
 var PersonSchema = extendThing("Person", {
-  givenName: import_zod6.z.string().optional(),
-  familyName: import_zod6.z.string().optional(),
-  email: import_zod6.z.string().email().optional(),
-  telephone: import_zod6.z.string().optional(),
-  jobTitle: import_zod6.z.string().optional(),
-  worksFor: import_zod6.z.lazy(() => import_zod6.z.object({ "@type": import_zod6.z.string(), name: import_zod6.z.string() })).optional(),
-  birthDate: import_zod6.z.string().optional(),
+  givenName: import_zod7.z.string().optional(),
+  familyName: import_zod7.z.string().optional(),
+  email: import_zod7.z.string().email().optional(),
+  telephone: import_zod7.z.string().optional(),
+  jobTitle: import_zod7.z.string().optional(),
+  worksFor: import_zod7.z.lazy(() => import_zod7.z.object({ "@type": import_zod7.z.string(), name: import_zod7.z.string() })).optional(),
+  birthDate: import_zod7.z.string().optional(),
   // ISO 8601
-  gender: import_zod6.z.enum(["Male", "Female", "Unknown"]).optional(),
-  nationality: import_zod6.z.string().optional(),
-  interactionStatistic: import_zod6.z.union([InteractionCounterSchema, import_zod6.z.array(InteractionCounterSchema)]).optional(),
-  agentInteractionStatistic: import_zod6.z.union([InteractionCounterSchema, import_zod6.z.array(InteractionCounterSchema)]).optional(),
-  address: import_zod6.z.object({
-    "@type": import_zod6.z.literal("PostalAddress"),
-    streetAddress: import_zod6.z.string().optional(),
-    addressLocality: import_zod6.z.string().optional(),
-    addressRegion: import_zod6.z.string().optional(),
-    postalCode: import_zod6.z.string().optional(),
-    addressCountry: import_zod6.z.string().optional()
-  }).optional()
+  gender: import_zod7.z.enum(["Male", "Female", "Unknown"]).optional(),
+  nationality: import_zod7.z.string().optional(),
+  interactionStatistic: import_zod7.z.union([InteractionCounterSchema, import_zod7.z.array(InteractionCounterSchema)]).optional(),
+  agentInteractionStatistic: import_zod7.z.union([InteractionCounterSchema, import_zod7.z.array(InteractionCounterSchema)]).optional(),
+  address: import_zod7.z.union([import_zod7.z.string(), PostalAddressSchema]).optional()
 });
 var createPerson = makeFactory(PersonSchema);
 
 // src/types/things/Organization.ts
 var import_zod15 = require("zod");
 
-// src/types/shared/PostalAddress.ts
-var import_zod7 = require("zod");
-var PostalAddressSchema = import_zod7.z.object({
-  "@type": import_zod7.z.literal("PostalAddress").default("PostalAddress"),
-  streetAddress: import_zod7.z.string().optional(),
-  addressLocality: import_zod7.z.string().optional(),
-  // city
-  addressRegion: import_zod7.z.string().optional(),
-  // state/province
-  postalCode: import_zod7.z.string().optional(),
-  addressCountry: import_zod7.z.string().optional(),
-  // ISO 3166-1 alpha-2, e.g. "US"
-  postOfficeBoxNumber: import_zod7.z.string().optional()
-});
-
 // src/types/shared/ContactPoint.ts
 var import_zod8 = require("zod");
 var ContactPointSchema = import_zod8.z.object({
   "@type": import_zod8.z.literal("ContactPoint").default("ContactPoint"),
+  "@id": import_zod8.z.string().optional(),
   telephone: import_zod8.z.string().optional(),
   contactType: import_zod8.z.string().optional(),
   // e.g. "customer support", "sales"
@@ -548,7 +554,7 @@ var OfferSchema = import_zod12.z.object({
   // ISO 8601
   validThrough: import_zod12.z.string().optional(),
   // ISO 8601
-  url: import_zod12.z.string().url().optional(),
+  url: import_zod12.z.url().optional(),
   seller: import_zod12.z.object({ "@type": import_zod12.z.string(), name: import_zod12.z.string() }).optional(),
   category: import_zod12.z.string().optional(),
   inventoryLevel: import_zod12.z.object({
@@ -561,13 +567,8 @@ var OfferSchema = import_zod12.z.object({
     UnitPriceSpecificationSchema,
     import_zod12.z.array(UnitPriceSpecificationSchema)
   ]).optional(),
-  shippingDetails: import_zod12.z.union([
-    OfferShippingDetailsSchema,
-    import_zod12.z.array(OfferShippingDetailsSchema)
-  ]).optional(),
-  hasMerchantReturnPolicy: import_zod12.z.lazy(
-    () => import_zod12.z.object({ "@type": import_zod12.z.string() }).catchall(import_zod12.z.unknown())
-  ).optional()
+  shippingDetails: import_zod12.z.union([OfferShippingDetailsSchema, import_zod12.z.array(OfferShippingDetailsSchema)]).optional(),
+  hasMerchantReturnPolicy: import_zod12.z.lazy(() => import_zod12.z.object({ "@type": import_zod12.z.string() }).catchall(import_zod12.z.unknown())).optional()
 });
 var MerchantReturnPolicySchema = import_zod12.z.object({
   "@type": import_zod12.z.literal("MerchantReturnPolicy").default("MerchantReturnPolicy"),
@@ -582,7 +583,7 @@ var MerchantReturnPolicySchema = import_zod12.z.object({
   refundType: import_zod12.z.string().optional(),
   // schema.org enum URL
   // Additional Google Merchant Listing fields
-  merchantReturnLink: import_zod12.z.string().url().optional(),
+  merchantReturnLink: import_zod12.z.url().optional(),
   returnShippingFeesAmount: MonetaryAmountSchema.optional(),
   itemCondition: import_zod12.z.union([ItemCondition, import_zod12.z.array(ItemCondition)]).optional(),
   returnLabelSource: import_zod12.z.string().optional(),
@@ -617,7 +618,7 @@ var AggregateOfferSchema = import_zod12.z.object({
   offerCount: import_zod12.z.number().int().nonnegative().optional(),
   offers: import_zod12.z.union([OfferSchema, import_zod12.z.array(OfferSchema)]).optional(),
   availability: ItemAvailability.optional(),
-  url: import_zod12.z.string().url().optional()
+  url: import_zod12.z.url().optional()
 });
 
 // src/types/shared/MemberProgram.ts
@@ -632,14 +633,14 @@ var MemberProgramTierSchema = import_zod13.z.object({
     value: import_zod13.z.number().optional(),
     unitText: import_zod13.z.string().optional()
   }).optional(),
-  url: import_zod13.z.string().url().optional()
+  url: import_zod13.z.url().optional()
 });
 var MemberProgramSchema = import_zod13.z.object({
   "@type": import_zod13.z.literal("MemberProgram").default("MemberProgram"),
   name: import_zod13.z.string(),
   description: import_zod13.z.string().optional(),
   hasTiers: import_zod13.z.union([MemberProgramTierSchema, import_zod13.z.array(MemberProgramTierSchema)]).optional(),
-  url: import_zod13.z.string().url().optional()
+  url: import_zod13.z.url().optional()
 });
 
 // src/types/shared/ShippingService.ts
@@ -715,7 +716,7 @@ var NestedOrgRef = import_zod15.z.lazy(
 );
 var OrganizationSchema = extendThing("Organization", {
   legalName: import_zod15.z.string().optional(),
-  email: import_zod15.z.email().optional(),
+  email: import_zod15.z.string().email().optional(),
   telephone: import_zod15.z.string().optional(),
   logo: ImageOrUrl.optional(),
   foundingDate: import_zod15.z.string().optional(),
@@ -748,20 +749,26 @@ var OrganizationSchema = extendThing("Organization", {
   // Hierarchical organization (loose refs to avoid circular type inference):
   subOrganization: NestedOrgRef.optional(),
   parentOrganization: NestedOrgRef.optional(),
-  sameAs: import_zod15.z.union([import_zod15.z.string().url(), import_zod15.z.array(import_zod15.z.string().url())]).optional()
+  sameAs: import_zod15.z.union([import_zod15.z.url(), import_zod15.z.array(import_zod15.z.url())]).optional()
 });
 var createOrganization = makeFactory(OrganizationSchema);
 var createNGO = makeFactory(
   OrganizationSchema.extend({ "@type": import_zod15.z.literal("NGO").default("NGO") })
 );
 var createCorporation = makeFactory(
-  OrganizationSchema.extend({ "@type": import_zod15.z.literal("Corporation").default("Corporation") })
+  OrganizationSchema.extend({
+    "@type": import_zod15.z.literal("Corporation").default("Corporation")
+  })
 );
 var createOnlineStore = makeFactory(
-  OrganizationSchema.extend({ "@type": import_zod15.z.literal("OnlineStore").default("OnlineStore") })
+  OrganizationSchema.extend({
+    "@type": import_zod15.z.literal("OnlineStore").default("OnlineStore")
+  })
 );
 var createOnlineBusiness = makeFactory(
-  OrganizationSchema.extend({ "@type": import_zod15.z.literal("OnlineBusiness").default("OnlineBusiness") })
+  OrganizationSchema.extend({
+    "@type": import_zod15.z.literal("OnlineBusiness").default("OnlineBusiness")
+  })
 );
 
 // src/types/things/Product.ts
@@ -794,12 +801,10 @@ var ReviewSchema = import_zod16.z.object({
   // ISO 8601 date
   publisher: PersonOrOrgRef.optional(),
   // itemReviewed: any Thing — kept loose to avoid circular imports
-  itemReviewed: import_zod16.z.lazy(
-    () => import_zod16.z.object({ "@type": import_zod16.z.string() }).passthrough()
-  ).optional(),
+  itemReviewed: import_zod16.z.lazy(() => import_zod16.z.object({ "@type": import_zod16.z.string() }).passthrough()).optional(),
   name: import_zod16.z.string().optional(),
   // Review headline
-  url: import_zod16.z.string().url().optional(),
+  url: import_zod16.z.url().optional(),
   /** ISO 8601 DateTime — required for French vacation rental reviews */
   contentReferenceTime: import_zod16.z.string().optional()
 });
@@ -957,7 +962,7 @@ var ClipSchema = import_zod18.z.object({
   // seconds from start
   endOffset: import_zod18.z.number().optional(),
   // seconds from start
-  url: import_zod18.z.string().url().optional()
+  url: import_zod18.z.url().optional()
   // URL pointing to this clip
 });
 var BroadcastEventSchema = import_zod18.z.object({
@@ -977,15 +982,15 @@ var VideoObjectSchema = import_zod18.z.object({
   "@type": import_zod18.z.literal("VideoObject").default("VideoObject"),
   // Required by Google:
   name: import_zod18.z.string(),
-  thumbnailUrl: import_zod18.z.union([import_zod18.z.string().url(), import_zod18.z.array(import_zod18.z.string().url())]),
+  thumbnailUrl: import_zod18.z.union([import_zod18.z.url(), import_zod18.z.array(import_zod18.z.url())]),
   uploadDate: import_zod18.z.string(),
   // ISO 8601 date
   // Recommended by Google:
   description: import_zod18.z.string().optional(),
   duration: import_zod18.z.string().optional(),
   // ISO 8601 duration, e.g. "PT1M54S"
-  contentUrl: import_zod18.z.string().url().optional(),
-  embedUrl: import_zod18.z.string().url().optional(),
+  contentUrl: import_zod18.z.url().optional(),
+  embedUrl: import_zod18.z.url().optional(),
   // Optional:
   expires: import_zod18.z.string().optional(),
   // ISO 8601 — when video is no longer available
@@ -1022,13 +1027,13 @@ var EventAttendanceMode = import_zod19.z.enum([
 var PlaceRef = import_zod19.z.union([
   import_zod19.z.string(),
   import_zod19.z.object({
-    "@type": import_zod19.z.literal("Place"),
+    "@type": import_zod19.z.literal("Place").default("Place"),
     name: import_zod19.z.string().optional(),
     address: import_zod19.z.union([import_zod19.z.string(), PostalAddressSchema]).optional(),
     url: import_zod19.z.url().optional()
   }),
   import_zod19.z.object({
-    "@type": import_zod19.z.literal("VirtualLocation"),
+    "@type": import_zod19.z.literal("VirtualLocation").default("VirtualLocation"),
     url: import_zod19.z.url(),
     name: import_zod19.z.string().optional()
   }),
@@ -1057,11 +1062,15 @@ var EventSchema = extendThing("Event", {
   subEvent: import_zod19.z.lazy(
     () => import_zod19.z.array(import_zod19.z.object({ "@type": import_zod19.z.string() }).catchall(import_zod19.z.unknown()))
   ).optional(),
-  superEvent: import_zod19.z.lazy(
-    () => import_zod19.z.object({ "@type": import_zod19.z.string() }).catchall(import_zod19.z.unknown())
-  ).optional(),
+  superEvent: import_zod19.z.lazy(() => import_zod19.z.object({ "@type": import_zod19.z.string() }).catchall(import_zod19.z.unknown())).optional(),
   // Additional:
-  inLanguage: import_zod19.z.union([import_zod19.z.string(), import_zod19.z.object({ "@type": import_zod19.z.literal("Language"), name: import_zod19.z.string() })]).optional(),
+  inLanguage: import_zod19.z.union([
+    import_zod19.z.string(),
+    import_zod19.z.object({
+      "@type": import_zod19.z.literal("Language").default("Language"),
+      name: import_zod19.z.string()
+    })
+  ]).optional(),
   isAccessibleForFree: import_zod19.z.boolean().optional(),
   maximumAttendeeCapacity: import_zod19.z.number().int().nonnegative().optional(),
   remainingAttendeeCapacity: import_zod19.z.number().int().nonnegative().optional(),
@@ -1101,11 +1110,13 @@ var PlaceSchema = extendThing("Place", {
   maximumAttendeeCapacity: import_zod21.z.number().int().nonnegative().optional(),
   isAccessibleForFree: import_zod21.z.boolean().optional(),
   publicAccess: import_zod21.z.boolean().optional(),
-  amenityFeature: import_zod21.z.array(import_zod21.z.object({
-    "@type": import_zod21.z.literal("LocationFeatureSpecification").default("LocationFeatureSpecification"),
-    name: import_zod21.z.string(),
-    value: import_zod21.z.union([import_zod21.z.boolean(), import_zod21.z.string(), import_zod21.z.number()])
-  })).optional(),
+  amenityFeature: import_zod21.z.array(
+    import_zod21.z.object({
+      "@type": import_zod21.z.literal("LocationFeatureSpecification").default("LocationFeatureSpecification"),
+      name: import_zod21.z.string(),
+      value: import_zod21.z.union([import_zod21.z.boolean(), import_zod21.z.string(), import_zod21.z.number()])
+    })
+  ).optional(),
   containedInPlace: import_zod21.z.lazy(
     () => import_zod21.z.object({ "@type": import_zod21.z.string(), name: import_zod21.z.string().optional() }).catchall(import_zod21.z.unknown())
   ).optional()
@@ -1132,11 +1143,14 @@ var LocalBusinessSchema = PlaceSchema.extend({
     import_zod22.z.literal("LodgingBusiness"),
     import_zod22.z.literal("GroceryStore"),
     import_zod22.z.literal("ShoppingCenter"),
-    import_zod22.z.literal("TravelAgency")
+    import_zod22.z.literal("TravelAgency"),
+    // Google allows @type to be a string or array for multi-typed entities
+    import_zod22.z.string(),
+    import_zod22.z.array(import_zod22.z.string())
   ]).default("LocalBusiness"),
   // Business identity:
   legalName: import_zod22.z.string().optional(),
-  email: import_zod22.z.email().optional(),
+  email: import_zod22.z.string().email().optional(),
   logo: ImageOrUrl.optional(),
   contactPoint: import_zod22.z.union([ContactPointSchema, import_zod22.z.array(ContactPointSchema)]).optional(),
   // Ratings & reviews:
@@ -1168,7 +1182,9 @@ var LocalBusinessSchema = PlaceSchema.extend({
 });
 var createLocalBusiness = makeFactory(LocalBusinessSchema);
 var createRestaurant = makeFactory(
-  LocalBusinessSchema.extend({ "@type": import_zod22.z.literal("Restaurant").default("Restaurant") })
+  LocalBusinessSchema.extend({
+    "@type": import_zod22.z.literal("Restaurant").default("Restaurant")
+  })
 );
 var createHotel = makeFactory(
   LocalBusinessSchema.extend({ "@type": import_zod22.z.literal("Hotel").default("Hotel") })
@@ -1193,7 +1209,10 @@ var MovieSchema = extendThing("Movie", {
   // ISO 3166
   inLanguage: import_zod23.z.union([
     import_zod23.z.string(),
-    import_zod23.z.object({ "@type": import_zod23.z.literal("Language"), name: import_zod23.z.string() })
+    import_zod23.z.object({
+      "@type": import_zod23.z.literal("Language").default("Language"),
+      name: import_zod23.z.string()
+    })
   ]).optional(),
   aggregateRating: AggregateRatingSchema.optional(),
   review: import_zod23.z.union([ReviewSchema, import_zod23.z.array(ReviewSchema)]).optional(),
@@ -1237,10 +1256,7 @@ var BorrowActionSchema = import_zod24.z.object({
   "@type": import_zod24.z.literal("BorrowAction").default("BorrowAction"),
   /** Library system or library lending this book */
   lender: import_zod24.z.object({
-    "@type": import_zod24.z.union([
-      import_zod24.z.literal("LibrarySystem"),
-      import_zod24.z.literal("Library")
-    ]),
+    "@type": import_zod24.z.union([import_zod24.z.literal("LibrarySystem"), import_zod24.z.literal("Library")]),
     name: import_zod24.z.string(),
     url: import_zod24.z.url().optional(),
     /** Unique identifier for the library system */
@@ -1313,9 +1329,7 @@ var BookSchema = import_zod24.z.object({
   /** BCP 47 language tag */
   inLanguage: import_zod24.z.string().optional(),
   /** Aggregate rating across editions */
-  aggregateRating: import_zod24.z.lazy(
-    () => import_zod24.z.object({ "@type": import_zod24.z.string() }).catchall(import_zod24.z.unknown())
-  ).optional()
+  aggregateRating: import_zod24.z.lazy(() => import_zod24.z.object({ "@type": import_zod24.z.string() }).catchall(import_zod24.z.unknown())).optional()
 });
 var createBook = makeFactory(BookSchema);
 
@@ -1337,18 +1351,23 @@ var CreativeWorkSchema = extendThing("CreativeWork", {
   inLanguage: import_zod25.z.union([
     import_zod25.z.string(),
     // BCP 47, e.g. "en-US"
-    import_zod25.z.object({ "@type": import_zod25.z.literal("Language"), name: import_zod25.z.string() })
+    import_zod25.z.object({
+      "@type": import_zod25.z.literal("Language").default("Language"),
+      name: import_zod25.z.string()
+    })
   ]).optional(),
   license: import_zod25.z.url().optional(),
   thumbnailUrl: import_zod25.z.url().optional(),
   isAccessibleForFree: import_zod25.z.boolean().optional(),
   image: import_zod25.z.union([ImageOrUrl, import_zod25.z.array(ImageOrUrl)]).optional(),
   // Paywalled content support:
-  hasPart: import_zod25.z.array(import_zod25.z.object({
-    "@type": import_zod25.z.string(),
-    isAccessibleForFree: import_zod25.z.boolean().optional(),
-    cssSelector: import_zod25.z.string().optional()
-  })).optional(),
+  hasPart: import_zod25.z.array(
+    import_zod25.z.object({
+      "@type": import_zod25.z.string(),
+      isAccessibleForFree: import_zod25.z.boolean().optional(),
+      cssSelector: import_zod25.z.string().optional()
+    })
+  ).optional(),
   // For subscription / paywalled content
   isPartOf: import_zod25.z.object({
     "@type": import_zod25.z.string(),
@@ -1449,9 +1468,7 @@ var WebSiteSchema = CreativeWorkSchema.extend({
   // Site-level metadata
   copyrightYear: import_zod28.z.number().int().optional(),
   // isPartOf — rarely used for WebSite itself but allowed
-  isPartOf: import_zod28.z.lazy(
-    () => import_zod28.z.object({ "@type": import_zod28.z.string() }).catchall(import_zod28.z.unknown())
-  ).optional()
+  isPartOf: import_zod28.z.lazy(() => import_zod28.z.object({ "@type": import_zod28.z.string() }).catchall(import_zod28.z.unknown())).optional()
 });
 var createWebSite = makeFactory(WebSiteSchema);
 
@@ -1490,16 +1507,21 @@ var DatasetSchema = CreativeWorkSchema.extend({
   // ISO 8601 or date range string
   spatialCoverage: import_zod29.z.union([
     import_zod29.z.string(),
-    import_zod29.z.object({ "@type": import_zod29.z.literal("Place"), name: import_zod29.z.string() })
+    import_zod29.z.object({
+      "@type": import_zod29.z.literal("Place").default("Place"),
+      name: import_zod29.z.string()
+    })
   ]).optional(),
-  distribution: import_zod29.z.array(import_zod29.z.object({
-    "@type": import_zod29.z.literal("DataDownload").default("DataDownload"),
-    encodingFormat: import_zod29.z.string(),
-    // MIME type or format name
-    contentUrl: import_zod29.z.url(),
-    name: import_zod29.z.string().optional(),
-    description: import_zod29.z.string().optional()
-  })).optional(),
+  distribution: import_zod29.z.array(
+    import_zod29.z.object({
+      "@type": import_zod29.z.literal("DataDownload").default("DataDownload"),
+      encodingFormat: import_zod29.z.string(),
+      // MIME type or format name
+      contentUrl: import_zod29.z.url(),
+      name: import_zod29.z.string().optional(),
+      description: import_zod29.z.string().optional()
+    })
+  ).optional(),
   includedInDataCatalog: import_zod29.z.object({
     "@type": import_zod29.z.literal("DataCatalog").default("DataCatalog"),
     name: import_zod29.z.string(),
@@ -1524,7 +1546,7 @@ var HowToStepSchema = import_zod30.z.object({
   // Step title (avoid "Step 1" format per Google)
   text: import_zod30.z.string(),
   // Step description
-  url: import_zod30.z.string().url().optional(),
+  url: import_zod30.z.url().optional(),
   // Anchor link to step
   image: ImageOrUrl.optional()
 });
@@ -1645,11 +1667,13 @@ var CourseSchema = CreativeWorkSchema.extend({
   image: import_zod32.z.union([ImageOrUrl, import_zod32.z.array(ImageOrUrl)]).optional(),
   offers: import_zod32.z.union([OfferSchema, import_zod32.z.array(OfferSchema)]).optional(),
   inLanguage: import_zod32.z.union([import_zod32.z.string(), import_zod32.z.array(import_zod32.z.string())]).optional(),
-  syllabusSections: import_zod32.z.array(import_zod32.z.object({
-    "@type": import_zod32.z.literal("Syllabus").default("Syllabus"),
-    name: import_zod32.z.string(),
-    description: import_zod32.z.string().optional()
-  })).optional()
+  syllabusSections: import_zod32.z.array(
+    import_zod32.z.object({
+      "@type": import_zod32.z.literal("Syllabus").default("Syllabus"),
+      name: import_zod32.z.string(),
+      description: import_zod32.z.string().optional()
+    })
+  ).optional()
 });
 var createCourse = makeFactory(CourseSchema);
 
@@ -1751,7 +1775,7 @@ var MathSolverSchema = CreativeWorkSchema.extend({
   educationalLevel: import_zod34.z.string().optional(),
   teaches: import_zod34.z.union([import_zod34.z.string(), import_zod34.z.array(import_zod34.z.string())]).optional(),
   /** URL of a page describing usage/terms for the solver — Google required field */
-  usageInfo: import_zod34.z.string().url().optional(),
+  usageInfo: import_zod34.z.url().optional(),
   /** Learning resource type — defaults to "Math Solver" per Google spec */
   learningResourceType: import_zod34.z.string().default("Math Solver"),
   /** Topics the solver assesses */
@@ -1768,14 +1792,14 @@ var ClaimSchema = import_zod35.z.object({
   /** ISO 8601 date the claim was made */
   datePublished: import_zod35.z.string().optional(),
   /** URL of the first appearance of the claim */
-  firstAppearance: import_zod35.z.string().url().optional(),
+  firstAppearance: import_zod35.z.url().optional(),
   /** URL(s) of other appearances of the claim */
-  appearance: import_zod35.z.union([import_zod35.z.string().url(), import_zod35.z.array(import_zod35.z.string().url())]).optional()
+  appearance: import_zod35.z.union([import_zod35.z.url(), import_zod35.z.array(import_zod35.z.url())]).optional()
 });
 var ClaimReviewSchema = import_zod35.z.object({
   "@type": import_zod35.z.literal("ClaimReview").default("ClaimReview"),
   /** Canonical URL of the fact-check article */
-  url: import_zod35.z.string().url(),
+  url: import_zod35.z.url(),
   /** The text of the claim being evaluated */
   claimReviewed: import_zod35.z.string(),
   /** The rating given by the fact-checker */
@@ -1792,7 +1816,7 @@ var ClaimReviewSchema = import_zod35.z.object({
     /** Name of the rating scale */
     name: import_zod35.z.string().optional(),
     /** URL of the rating explanation page */
-    image: import_zod35.z.string().url().optional()
+    image: import_zod35.z.url().optional()
   }),
   /** The fact-checking author / organization */
   author: import_zod35.z.union([PersonOrOrgRef, import_zod35.z.array(PersonOrOrgRef)]).optional(),
@@ -1909,7 +1933,7 @@ var AlignmentObjectSchema = import_zod38.z.object({
   alignmentType: import_zod38.z.string(),
   targetName: import_zod38.z.string(),
   educationalFramework: import_zod38.z.string().optional(),
-  targetUrl: import_zod38.z.string().url().optional(),
+  targetUrl: import_zod38.z.url().optional(),
   targetDescription: import_zod38.z.string().optional()
 });
 var AnswerSchema = import_zod38.z.object({
@@ -1920,16 +1944,18 @@ var AnswerSchema = import_zod38.z.object({
   dateModified: import_zod38.z.string().optional(),
   // ISO 8601
   upvoteCount: import_zod38.z.number().int().nonnegative().optional(),
-  url: import_zod38.z.string().url().optional(),
+  url: import_zod38.z.url().optional(),
   author: PersonOrOrgRef.optional(),
   image: import_zod38.z.union([ImageOrUrl, import_zod38.z.array(ImageOrUrl)]).optional(),
   video: import_zod38.z.union([VideoObjectSchema, import_zod38.z.array(VideoObjectSchema)]).optional(),
-  comment: import_zod38.z.array(import_zod38.z.object({
-    "@type": import_zod38.z.literal("Comment").default("Comment"),
-    text: import_zod38.z.string(),
-    author: PersonOrOrgRef.optional(),
-    datePublished: import_zod38.z.string().optional()
-  })).optional()
+  comment: import_zod38.z.array(
+    import_zod38.z.object({
+      "@type": import_zod38.z.literal("Comment").default("Comment"),
+      text: import_zod38.z.string(),
+      author: PersonOrOrgRef.optional(),
+      datePublished: import_zod38.z.string().optional()
+    })
+  ).optional()
 });
 var QuestionSchema = import_zod38.z.object({
   "@type": import_zod38.z.literal("Question").default("Question"),
@@ -1946,7 +1972,7 @@ var QuestionSchema = import_zod38.z.object({
   datePublished: import_zod38.z.string().optional(),
   dateModified: import_zod38.z.string().optional(),
   // ISO 8601
-  url: import_zod38.z.string().url().optional(),
+  url: import_zod38.z.url().optional(),
   image: import_zod38.z.union([ImageOrUrl, import_zod38.z.array(ImageOrUrl)]).optional(),
   video: import_zod38.z.union([VideoObjectSchema, import_zod38.z.array(VideoObjectSchema)]).optional(),
   /** Education Q&A question type, e.g. "Flashcard", "Problem Set" */
@@ -1964,9 +1990,7 @@ var QuizSchema = CreativeWorkSchema.extend({
   "@type": import_zod38.z.literal("Quiz").default("Quiz"),
   name: import_zod38.z.string().optional(),
   educationalLevel: import_zod38.z.string().optional(),
-  about: import_zod38.z.lazy(
-    () => import_zod38.z.object({ "@type": import_zod38.z.string() }).catchall(import_zod38.z.unknown())
-  ).optional(),
+  about: import_zod38.z.lazy(() => import_zod38.z.object({ "@type": import_zod38.z.string() }).catchall(import_zod38.z.unknown())).optional(),
   hasPart: import_zod38.z.array(QuestionSchema).optional(),
   educationalAlignment: import_zod38.z.union([AlignmentObjectSchema, import_zod38.z.array(AlignmentObjectSchema)]).optional()
 });
@@ -1988,30 +2012,32 @@ var DiscussionForumPostingSchema = CreativeWorkSchema.extend({
   // ISO 8601
   dateModified: import_zod39.z.string().optional(),
   // ISO 8601
-  url: import_zod39.z.string().url().optional(),
-  comment: import_zod39.z.array(import_zod39.z.object({
-    "@type": import_zod39.z.literal("Comment").default("Comment"),
-    text: import_zod39.z.string(),
-    author: PersonOrOrgRef.optional(),
-    datePublished: import_zod39.z.string().optional(),
-    upvoteCount: import_zod39.z.number().int().nonnegative().optional(),
-    downvoteCount: import_zod39.z.number().int().nonnegative().optional(),
-    url: import_zod39.z.string().url().optional()
-  })).optional(),
+  url: import_zod39.z.url().optional(),
+  comment: import_zod39.z.array(
+    import_zod39.z.object({
+      "@type": import_zod39.z.literal("Comment").default("Comment"),
+      text: import_zod39.z.string(),
+      author: PersonOrOrgRef.optional(),
+      datePublished: import_zod39.z.string().optional(),
+      upvoteCount: import_zod39.z.number().int().nonnegative().optional(),
+      downvoteCount: import_zod39.z.number().int().nonnegative().optional(),
+      url: import_zod39.z.url().optional()
+    })
+  ).optional(),
   commentCount: import_zod39.z.number().int().nonnegative().optional(),
   upvoteCount: import_zod39.z.number().int().nonnegative().optional(),
   downvoteCount: import_zod39.z.number().int().nonnegative().optional(),
   image: ImageOrUrl.optional(),
   /** "published", "draft", "deleted" — or a schema.org enum URL */
   creativeWorkStatus: import_zod39.z.string().optional(),
-  mainEntityOfPage: import_zod39.z.union([import_zod39.z.string().url(), import_zod39.z.object({}).catchall(import_zod39.z.unknown())]).optional(),
+  mainEntityOfPage: import_zod39.z.union([import_zod39.z.url(), import_zod39.z.object({}).catchall(import_zod39.z.unknown())]).optional(),
   // For reposts:
-  sharedContent: import_zod39.z.lazy(
-    () => import_zod39.z.object({ "@type": import_zod39.z.string() }).catchall(import_zod39.z.unknown())
-  ).optional(),
+  sharedContent: import_zod39.z.lazy(() => import_zod39.z.object({ "@type": import_zod39.z.string() }).catchall(import_zod39.z.unknown())).optional(),
   interactionStatistic: import_zod39.z.union([InteractionCounterSchema, import_zod39.z.array(InteractionCounterSchema)]).optional()
 });
-var createDiscussionForumPosting = makeFactory(DiscussionForumPostingSchema);
+var createDiscussionForumPosting = makeFactory(
+  DiscussionForumPostingSchema
+);
 
 // src/types/intangibles/ItemList.ts
 var import_zod40 = require("zod");
@@ -2021,9 +2047,7 @@ var ListItemSchema = import_zod40.z.object({
   url: import_zod40.z.url().optional(),
   name: import_zod40.z.string().optional(),
   // item: the actual entity being listed (loose ref to any schema node)
-  item: import_zod40.z.lazy(
-    () => import_zod40.z.object({ "@type": import_zod40.z.string() }).catchall(import_zod40.z.unknown())
-  ).optional()
+  item: import_zod40.z.lazy(() => import_zod40.z.object({ "@type": import_zod40.z.string() }).catchall(import_zod40.z.unknown())).optional()
 });
 var ItemListSchema = import_zod40.z.object({
   "@type": import_zod40.z.literal("ItemList").default("ItemList"),
@@ -2103,7 +2127,7 @@ var AccommodationSchema = import_zod42.z.object({
     import_zod42.z.array(LocationFeatureSpecificationSchema)
   ]).optional(),
   petsAllowed: import_zod42.z.union([import_zod42.z.boolean(), import_zod42.z.string()]).optional(),
-  url: import_zod42.z.string().url().optional(),
+  url: import_zod42.z.url().optional(),
   /** "EntirePlace", "PrivateRoom", or "SharedRoom" */
   additionalType: import_zod42.z.string().optional()
 });
@@ -2137,11 +2161,14 @@ var VacationRentalSchema = LocalBusinessSchema.extend({
     ratingValue: import_zod42.z.number().min(0).max(5)
   }).optional(),
   offers: import_zod42.z.union([OfferSchema, import_zod42.z.array(OfferSchema)]).optional(),
-  leaseLength: import_zod42.z.union([import_zod42.z.string(), import_zod42.z.object({
-    "@type": import_zod42.z.literal("QuantitativeValue").default("QuantitativeValue"),
-    value: import_zod42.z.number(),
-    unitCode: import_zod42.z.string().optional()
-  })]).optional(),
+  leaseLength: import_zod42.z.union([
+    import_zod42.z.string(),
+    import_zod42.z.object({
+      "@type": import_zod42.z.literal("QuantitativeValue").default("QuantitativeValue"),
+      value: import_zod42.z.number(),
+      unitCode: import_zod42.z.string().optional()
+    })
+  ]).optional(),
   floorSize: import_zod42.z.object({
     "@type": import_zod42.z.literal("QuantitativeValue").default("QuantitativeValue"),
     value: import_zod42.z.number(),
@@ -2263,6 +2290,104 @@ function createGraph(nodes) {
   return graph;
 }
 
+// src/core/ids.ts
+var SchemaIds = class {
+  constructor(origin) {
+    this.origin = origin;
+  }
+  /** @internal Build an ID from origin + fragment */
+  id(fragment) {
+    return `${this.origin}/#${fragment}`;
+  }
+  // ── Well-known entity IDs ───────────────────────────────────────────────
+  // Things
+  organization() {
+    return this.id("organization");
+  }
+  localBusiness() {
+    return this.id("localbusiness");
+  }
+  person() {
+    return this.id("person");
+  }
+  product() {
+    return this.id("product");
+  }
+  event() {
+    return this.id("event");
+  }
+  place() {
+    return this.id("place");
+  }
+  movie() {
+    return this.id("movie");
+  }
+  // Creative works
+  website() {
+    return this.id("website");
+  }
+  webpage() {
+    return this.id("webpage");
+  }
+  article() {
+    return this.id("article");
+  }
+  breadcrumb() {
+    return this.id("breadcrumb");
+  }
+  dataset() {
+    return this.id("dataset");
+  }
+  recipe() {
+    return this.id("recipe");
+  }
+  course() {
+    return this.id("course");
+  }
+  softwareApplication() {
+    return this.id("softwareapplication");
+  }
+  // Intangibles & other
+  faqPage() {
+    return this.id("faqpage");
+  }
+  jobPosting() {
+    return this.id("jobposting");
+  }
+  vacationRental() {
+    return this.id("vacationrental");
+  }
+  profilePage() {
+    return this.id("profilepage");
+  }
+  // ── Custom IDs ──────────────────────────────────────────────────────────
+  /**
+   * Generate an ID with any custom fragment.
+   * @example ids.custom("hero-banner") // "https://example.com/#hero-banner"
+   */
+  custom(fragment) {
+    return this.id(fragment);
+  }
+  /**
+   * Generate an ID scoped to a specific page path.
+   * @example ids.forPath("/about", "webpage") // "https://example.com/about#webpage"
+   */
+  forPath(path, fragment) {
+    return `${this.origin}${path}#${fragment}`;
+  }
+  // ── Reference helper ────────────────────────────────────────────────────
+  /**
+   * Returns a `{ "@id": "..." }` reference object for cross-referencing
+   * entities within a @graph. Pass to fields like publisher, organizer, etc.
+   *
+   * @example
+   * createWebSite({ publisher: ids.ref("organization"), ... })
+   */
+  ref(fragment) {
+    return { "@id": this.id(fragment) };
+  }
+};
+
 // src/helpers/breadcrumb.ts
 var import_zod43 = require("zod");
 var BreadcrumbListSchema = import_zod43.z.object({
@@ -2427,6 +2552,7 @@ function createPaywalledWebPage(data, options) {
   RecipeSchema,
   ReviewSchema,
   SchemaGraph,
+  SchemaIds,
   SchemaNode,
   SeekToActionSchema,
   ServicePeriodSchema,