schemaorg-kit 1.2.0 → 1.3.0

package/dist/index.js

@@ -294,8 +294,9 @@ var ThingSchema = import_zod4.z.object({
   sameAs: import_zod4.z.union([import_zod4.z.url(), import_zod4.z.array(import_zod4.z.url())]).optional(),
   alternateName: import_zod4.z.string().optional(),
   // Relationships (loose refs to avoid circular type inference)
-  subjectOf: AnyThingRef.optional(),
-  mainEntityOfPage: import_zod4.z.union([import_zod4.z.url(), AnyThingRef]).optional()
+  // All accept { "@id": "..." } for @graph cross-referencing
+  subjectOf: import_zod4.z.union([import_zod4.z.object({ "@id": import_zod4.z.string() }), AnyThingRef]).optional(),
+  mainEntityOfPage: import_zod4.z.union([import_zod4.z.url(), import_zod4.z.object({ "@id": import_zod4.z.string() }), AnyThingRef]).optional()
 });
 function extendThing(type, shape) {
   return ThingSchema.extend({
@@ -555,7 +556,10 @@ var OfferSchema = import_zod12.z.object({
   validThrough: import_zod12.z.string().optional(),
   // ISO 8601
   url: import_zod12.z.url().optional(),
-  seller: import_zod12.z.object({ "@type": import_zod12.z.string(), name: import_zod12.z.string() }).optional(),
+  seller: import_zod12.z.union([
+    import_zod12.z.object({ "@id": import_zod12.z.string() }),
+    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({
     "@type": import_zod12.z.literal("QuantitativeValue").default("QuantitativeValue"),
@@ -568,7 +572,10 @@ var OfferSchema = import_zod12.z.object({
     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()
+  hasMerchantReturnPolicy: import_zod12.z.union([
+    import_zod12.z.object({ "@id": import_zod12.z.string() }),
+    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"),
@@ -747,8 +754,9 @@ var OrganizationSchema = extendThing("Organization", {
   interactionStatistic: import_zod15.z.union([InteractionCounterSchema, import_zod15.z.array(InteractionCounterSchema)]).optional(),
   agentInteractionStatistic: import_zod15.z.union([InteractionCounterSchema, import_zod15.z.array(InteractionCounterSchema)]).optional(),
   // Hierarchical organization (loose refs to avoid circular type inference):
-  subOrganization: NestedOrgRef.optional(),
-  parentOrganization: NestedOrgRef.optional(),
+  // Accept { "@id": "..." } for @graph cross-referencing
+  subOrganization: import_zod15.z.union([import_zod15.z.object({ "@id": import_zod15.z.string() }), NestedOrgRef]).optional(),
+  parentOrganization: import_zod15.z.union([import_zod15.z.object({ "@id": import_zod15.z.string() }), NestedOrgRef]).optional(),
   sameAs: import_zod15.z.union([import_zod15.z.url(), import_zod15.z.array(import_zod15.z.url())]).optional()
 });
 var createOrganization = makeFactory(OrganizationSchema);
@@ -801,7 +809,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.union([
+    import_zod16.z.object({ "@id": import_zod16.z.string() }),
+    import_zod16.z.lazy(() => import_zod16.z.object({ "@type": import_zod16.z.string() }).catchall(import_zod16.z.unknown()))
+  ]).optional(),
   name: import_zod16.z.string().optional(),
   // Review headline
   url: import_zod16.z.url().optional(),
@@ -810,9 +821,12 @@ var ReviewSchema = import_zod16.z.object({
 });
 var EmployerAggregateRatingSchema = AggregateRatingSchema.extend({
   "@type": import_zod16.z.literal("EmployerAggregateRating").default("EmployerAggregateRating"),
-  itemReviewed: import_zod16.z.lazy(
-    () => import_zod16.z.object({ "@type": import_zod16.z.string(), name: import_zod16.z.string() }).passthrough()
-  ).optional()
+  itemReviewed: import_zod16.z.union([
+    import_zod16.z.object({ "@id": import_zod16.z.string() }),
+    import_zod16.z.lazy(
+      () => import_zod16.z.object({ "@type": import_zod16.z.string(), name: import_zod16.z.string() }).catchall(import_zod16.z.unknown())
+    )
+  ]).optional()
 });
 
 // src/types/things/Product.ts
@@ -1026,6 +1040,7 @@ var EventAttendanceMode = import_zod19.z.enum([
 ]).transform((v) => `https://schema.org/${v}`);
 var PlaceRef = import_zod19.z.union([
   import_zod19.z.string(),
+  import_zod19.z.object({ "@id": import_zod19.z.string() }),
   import_zod19.z.object({
     "@type": import_zod19.z.literal("Place").default("Place"),
     name: import_zod19.z.string().optional(),
@@ -1058,11 +1073,17 @@ var EventSchema = extendThing("Event", {
   previousStartDate: import_zod19.z.string().optional(),
   // ISO 8601 — for rescheduled events
   aggregateRating: AggregateRatingSchema.optional(),
-  // Sub-events:
+  // Sub-events (accept @id refs for @graph cross-referencing):
   subEvent: import_zod19.z.lazy(
-    () => import_zod19.z.array(import_zod19.z.object({ "@type": import_zod19.z.string() }).catchall(import_zod19.z.unknown()))
+    () => import_zod19.z.array(import_zod19.z.union([
+      import_zod19.z.object({ "@id": import_zod19.z.string() }),
+      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.union([
+    import_zod19.z.object({ "@id": import_zod19.z.string() }),
+    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(),
@@ -1117,9 +1138,12 @@ var PlaceSchema = extendThing("Place", {
       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()
+  containedInPlace: import_zod21.z.union([
+    import_zod21.z.object({ "@id": import_zod21.z.string() }),
+    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()
 });
 var createPlace = makeFactory(PlaceSchema);
 
@@ -1170,11 +1194,15 @@ var LocalBusinessSchema = PlaceSchema.extend({
   iso6523Code: import_zod22.z.string().optional(),
   hasMerchantReturnPolicy: MerchantReturnPolicySchema.optional(),
   sameAs: import_zod22.z.union([import_zod22.z.url(), import_zod22.z.array(import_zod22.z.url())]).optional(),
-  // Departments (nested LocalBusiness):
+  // Departments (nested LocalBusiness — accept @id refs for @graph cross-referencing):
   department: import_zod22.z.lazy(
     () => import_zod22.z.union([
+      import_zod22.z.object({ "@id": import_zod22.z.string() }),
       import_zod22.z.object({ "@type": import_zod22.z.string() }).catchall(import_zod22.z.unknown()),
-      import_zod22.z.array(import_zod22.z.object({ "@type": import_zod22.z.string() }).catchall(import_zod22.z.unknown()))
+      import_zod22.z.array(import_zod22.z.union([
+        import_zod22.z.object({ "@id": import_zod22.z.string() }),
+        import_zod22.z.object({ "@type": import_zod22.z.string() }).catchall(import_zod22.z.unknown())
+      ]))
     ])
   ).optional(),
   // Opening hours in string format (alternative to openingHoursSpecification):
@@ -1314,12 +1342,15 @@ var BookSchema = import_zod24.z.object({
   sameAs: import_zod24.z.union([import_zod24.z.string(), import_zod24.z.array(import_zod24.z.string())]).optional(),
   /** Specific editions — each may have ReadAction / BorrowAction */
   workExample: import_zod24.z.union([BookEditionSchema, import_zod24.z.array(BookEditionSchema)]).optional(),
-  /** Publisher of the primary edition */
-  publisher: import_zod24.z.object({
-    "@type": import_zod24.z.union([import_zod24.z.literal("Organization"), import_zod24.z.literal("Person")]),
-    name: import_zod24.z.string(),
-    url: import_zod24.z.url().optional()
-  }).optional(),
+  /** Publisher of the primary edition (accept @id refs for @graph cross-referencing) */
+  publisher: import_zod24.z.union([
+    import_zod24.z.object({ "@id": import_zod24.z.string() }),
+    import_zod24.z.object({
+      "@type": import_zod24.z.union([import_zod24.z.literal("Organization"), import_zod24.z.literal("Person")]),
+      name: import_zod24.z.string(),
+      url: import_zod24.z.url().optional()
+    })
+  ]).optional(),
   /** Number of pages */
   numberOfPages: import_zod24.z.number().int().positive().optional(),
   /** Original publication year */
@@ -1329,7 +1360,10 @@ 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.union([
+    import_zod24.z.object({ "@id": import_zod24.z.string() }),
+    import_zod24.z.lazy(() => import_zod24.z.object({ "@type": import_zod24.z.string() }).catchall(import_zod24.z.unknown()))
+  ]).optional()
 });
 var createBook = makeFactory(BookSchema);
 
@@ -1368,11 +1402,14 @@ var CreativeWorkSchema = extendThing("CreativeWork", {
       cssSelector: import_zod25.z.string().optional()
     })
   ).optional(),
-  // For subscription / paywalled content
-  isPartOf: import_zod25.z.object({
-    "@type": import_zod25.z.string(),
-    name: import_zod25.z.string().optional()
-  }).optional(),
+  // For subscription / paywalled content (accept @id refs for @graph cross-referencing)
+  isPartOf: import_zod25.z.union([
+    import_zod25.z.object({ "@id": import_zod25.z.string() }),
+    import_zod25.z.object({
+      "@type": import_zod25.z.string(),
+      name: import_zod25.z.string().optional()
+    })
+  ]).optional(),
   text: import_zod25.z.string().optional(),
   abstract: import_zod25.z.string().optional(),
   encodingFormat: import_zod25.z.string().optional(),
@@ -1408,9 +1445,10 @@ var NewsArticleSchema = ArticleSchema.extend({
 });
 var BlogPostingSchema = ArticleSchema.extend({
   "@type": import_zod26.z.literal("BlogPosting").default("BlogPosting"),
-  sharedContent: import_zod26.z.lazy(
-    () => import_zod26.z.object({ "@type": import_zod26.z.string() }).passthrough()
-  ).optional()
+  sharedContent: import_zod26.z.union([
+    import_zod26.z.object({ "@id": import_zod26.z.string() }),
+    import_zod26.z.lazy(() => import_zod26.z.object({ "@type": import_zod26.z.string() }).catchall(import_zod26.z.unknown()))
+  ]).optional()
 });
 var createArticle = makeFactory(ArticleSchema);
 var createNewsArticle = makeFactory(NewsArticleSchema);
@@ -1420,9 +1458,12 @@ var createBlogPosting = makeFactory(BlogPostingSchema);
 var import_zod27 = require("zod");
 var WebPageSchema = CreativeWorkSchema.extend({
   "@type": import_zod27.z.literal("WebPage").default("WebPage"),
-  breadcrumb: import_zod27.z.lazy(
-    () => import_zod27.z.object({ "@type": import_zod27.z.literal("BreadcrumbList") }).catchall(import_zod27.z.unknown())
-  ).optional(),
+  breadcrumb: import_zod27.z.union([
+    import_zod27.z.object({ "@id": import_zod27.z.string() }),
+    import_zod27.z.lazy(
+      () => import_zod27.z.object({ "@type": import_zod27.z.literal("BreadcrumbList") }).catchall(import_zod27.z.unknown())
+    )
+  ]).optional(),
   lastReviewed: import_zod27.z.string().optional(),
   reviewedBy: PersonOrOrgRef.optional(),
   speakable: import_zod27.z.object({
@@ -1431,8 +1472,14 @@ var WebPageSchema = CreativeWorkSchema.extend({
     xpath: import_zod27.z.union([import_zod27.z.string(), import_zod27.z.array(import_zod27.z.string())]).optional()
   }).optional(),
   significantLink: import_zod27.z.union([import_zod27.z.url(), import_zod27.z.array(import_zod27.z.url())]).optional(),
-  mainContentOfPage: import_zod27.z.object({ "@type": import_zod27.z.string() }).catchall(import_zod27.z.unknown()).optional(),
-  primaryImageOfPage: import_zod27.z.object({ "@type": import_zod27.z.string() }).catchall(import_zod27.z.unknown()).optional(),
+  mainContentOfPage: import_zod27.z.union([
+    import_zod27.z.object({ "@id": import_zod27.z.string() }),
+    import_zod27.z.object({ "@type": import_zod27.z.string() }).catchall(import_zod27.z.unknown())
+  ]).optional(),
+  primaryImageOfPage: import_zod27.z.union([
+    import_zod27.z.object({ "@id": import_zod27.z.string() }),
+    import_zod27.z.object({ "@type": import_zod27.z.string() }).catchall(import_zod27.z.unknown())
+  ]).optional(),
   relatedLink: import_zod27.z.union([import_zod27.z.url(), import_zod27.z.array(import_zod27.z.url())]).optional()
 });
 var createWebPage = makeFactory(WebPageSchema);
@@ -1467,8 +1514,11 @@ var WebSiteSchema = CreativeWorkSchema.extend({
   publisher: PersonOrOrgRef.optional(),
   // 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 — rarely used for WebSite itself but allowed (accept @id refs for @graph)
+  isPartOf: import_zod28.z.union([
+    import_zod28.z.object({ "@id": import_zod28.z.string() }),
+    import_zod28.z.lazy(() => import_zod28.z.object({ "@type": import_zod28.z.string() }).catchall(import_zod28.z.unknown()))
+  ]).optional()
 });
 var createWebSite = makeFactory(WebSiteSchema);
 
@@ -1876,7 +1926,7 @@ var JobPostingSchema = import_zod37.z.object({
   // Required by Google:
   title: import_zod37.z.string(),
   description: import_zod37.z.string(),
-  hiringOrganization: HiringOrgRef,
+  hiringOrganization: import_zod37.z.union([import_zod37.z.object({ "@id": import_zod37.z.string() }), HiringOrgRef]),
   jobLocation: import_zod37.z.union([JobLocationRef, import_zod37.z.array(JobLocationRef)]).optional(),
   datePosted: import_zod37.z.string(),
   // ISO 8601 date
@@ -1990,7 +2040,10 @@ 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.union([
+    import_zod38.z.object({ "@id": import_zod38.z.string() }),
+    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()
 });
@@ -2030,9 +2083,12 @@ var DiscussionForumPostingSchema = CreativeWorkSchema.extend({
   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.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(),
+  mainEntityOfPage: import_zod39.z.union([import_zod39.z.url(), import_zod39.z.object({ "@id": import_zod39.z.string() }), import_zod39.z.object({}).catchall(import_zod39.z.unknown())]).optional(),
+  // For reposts (accept @id refs for @graph cross-referencing):
+  sharedContent: import_zod39.z.union([
+    import_zod39.z.object({ "@id": import_zod39.z.string() }),
+    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(
@@ -2069,13 +2125,17 @@ var createItemList = makeFactory(ItemListSchema);
 var import_zod41 = require("zod");
 var ProfilePageSchema = WebPageSchema.extend({
   "@type": import_zod41.z.literal("ProfilePage").default("ProfilePage"),
-  // mainEntity: the person or org this profile is about (loose ref to avoid circular imports)
-  mainEntity: import_zod41.z.lazy(
-    () => import_zod41.z.object({ "@type": import_zod41.z.string() }).catchall(import_zod41.z.unknown())
-  ).optional(),
+  // mainEntity: the person or org this profile is about (accept @id refs for @graph)
+  mainEntity: import_zod41.z.union([
+    import_zod41.z.object({ "@id": import_zod41.z.string() }),
+    import_zod41.z.lazy(() => import_zod41.z.object({ "@type": import_zod41.z.string() }).catchall(import_zod41.z.unknown()))
+  ]).optional(),
   // hasPart: content published by/about this profile subject
   hasPart: import_zod41.z.array(
-    import_zod41.z.lazy(() => import_zod41.z.object({ "@type": import_zod41.z.string() }).catchall(import_zod41.z.unknown()))
+    import_zod41.z.union([
+      import_zod41.z.object({ "@id": import_zod41.z.string() }),
+      import_zod41.z.lazy(() => import_zod41.z.object({ "@type": import_zod41.z.string() }).catchall(import_zod41.z.unknown()))
+    ])
   ).optional(),
   dateCreated: import_zod41.z.string().optional(),
   dateModified: import_zod41.z.string().optional()

package/dist/index.mjs

@@ -124,8 +124,9 @@ var ThingSchema = z4.object({
   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()
+  // All accept { "@id": "..." } for @graph cross-referencing
+  subjectOf: z4.union([z4.object({ "@id": z4.string() }), AnyThingRef]).optional(),
+  mainEntityOfPage: z4.union([z4.url(), z4.object({ "@id": z4.string() }), AnyThingRef]).optional()
 });
 function extendThing(type, shape) {
   return ThingSchema.extend({
@@ -385,7 +386,10 @@ var OfferSchema = z12.object({
   validThrough: z12.string().optional(),
   // ISO 8601
   url: z12.url().optional(),
-  seller: z12.object({ "@type": z12.string(), name: z12.string() }).optional(),
+  seller: z12.union([
+    z12.object({ "@id": z12.string() }),
+    z12.object({ "@type": z12.string(), name: z12.string() })
+  ]).optional(),
   category: z12.string().optional(),
   inventoryLevel: z12.object({
     "@type": z12.literal("QuantitativeValue").default("QuantitativeValue"),
@@ -398,7 +402,10 @@ var OfferSchema = z12.object({
     z12.array(UnitPriceSpecificationSchema)
   ]).optional(),
   shippingDetails: z12.union([OfferShippingDetailsSchema, z12.array(OfferShippingDetailsSchema)]).optional(),
-  hasMerchantReturnPolicy: z12.lazy(() => z12.object({ "@type": z12.string() }).catchall(z12.unknown())).optional()
+  hasMerchantReturnPolicy: z12.union([
+    z12.object({ "@id": z12.string() }),
+    z12.lazy(() => z12.object({ "@type": z12.string() }).catchall(z12.unknown()))
+  ]).optional()
 });
 var MerchantReturnPolicySchema = z12.object({
   "@type": z12.literal("MerchantReturnPolicy").default("MerchantReturnPolicy"),
@@ -577,8 +584,9 @@ var OrganizationSchema = extendThing("Organization", {
   interactionStatistic: z15.union([InteractionCounterSchema, z15.array(InteractionCounterSchema)]).optional(),
   agentInteractionStatistic: z15.union([InteractionCounterSchema, z15.array(InteractionCounterSchema)]).optional(),
   // Hierarchical organization (loose refs to avoid circular type inference):
-  subOrganization: NestedOrgRef.optional(),
-  parentOrganization: NestedOrgRef.optional(),
+  // Accept { "@id": "..." } for @graph cross-referencing
+  subOrganization: z15.union([z15.object({ "@id": z15.string() }), NestedOrgRef]).optional(),
+  parentOrganization: z15.union([z15.object({ "@id": z15.string() }), NestedOrgRef]).optional(),
   sameAs: z15.union([z15.url(), z15.array(z15.url())]).optional()
 });
 var createOrganization = makeFactory(OrganizationSchema);
@@ -631,7 +639,10 @@ var ReviewSchema = z16.object({
   // ISO 8601 date
   publisher: PersonOrOrgRef.optional(),
   // itemReviewed: any Thing — kept loose to avoid circular imports
-  itemReviewed: z16.lazy(() => z16.object({ "@type": z16.string() }).passthrough()).optional(),
+  itemReviewed: z16.union([
+    z16.object({ "@id": z16.string() }),
+    z16.lazy(() => z16.object({ "@type": z16.string() }).catchall(z16.unknown()))
+  ]).optional(),
   name: z16.string().optional(),
   // Review headline
   url: z16.url().optional(),
@@ -640,9 +651,12 @@ var ReviewSchema = z16.object({
 });
 var EmployerAggregateRatingSchema = AggregateRatingSchema.extend({
   "@type": z16.literal("EmployerAggregateRating").default("EmployerAggregateRating"),
-  itemReviewed: z16.lazy(
-    () => z16.object({ "@type": z16.string(), name: z16.string() }).passthrough()
-  ).optional()
+  itemReviewed: z16.union([
+    z16.object({ "@id": z16.string() }),
+    z16.lazy(
+      () => z16.object({ "@type": z16.string(), name: z16.string() }).catchall(z16.unknown())
+    )
+  ]).optional()
 });
 
 // src/types/things/Product.ts
@@ -856,6 +870,7 @@ var EventAttendanceMode = z19.enum([
 ]).transform((v) => `https://schema.org/${v}`);
 var PlaceRef = z19.union([
   z19.string(),
+  z19.object({ "@id": z19.string() }),
   z19.object({
     "@type": z19.literal("Place").default("Place"),
     name: z19.string().optional(),
@@ -888,11 +903,17 @@ var EventSchema = extendThing("Event", {
   previousStartDate: z19.string().optional(),
   // ISO 8601 — for rescheduled events
   aggregateRating: AggregateRatingSchema.optional(),
-  // Sub-events:
+  // Sub-events (accept @id refs for @graph cross-referencing):
   subEvent: z19.lazy(
-    () => z19.array(z19.object({ "@type": z19.string() }).catchall(z19.unknown()))
+    () => z19.array(z19.union([
+      z19.object({ "@id": z19.string() }),
+      z19.object({ "@type": z19.string() }).catchall(z19.unknown())
+    ]))
   ).optional(),
-  superEvent: z19.lazy(() => z19.object({ "@type": z19.string() }).catchall(z19.unknown())).optional(),
+  superEvent: z19.union([
+    z19.object({ "@id": z19.string() }),
+    z19.lazy(() => z19.object({ "@type": z19.string() }).catchall(z19.unknown()))
+  ]).optional(),
   // Additional:
   inLanguage: z19.union([
     z19.string(),
@@ -947,9 +968,12 @@ var PlaceSchema = extendThing("Place", {
       value: z21.union([z21.boolean(), z21.string(), z21.number()])
     })
   ).optional(),
-  containedInPlace: z21.lazy(
-    () => z21.object({ "@type": z21.string(), name: z21.string().optional() }).catchall(z21.unknown())
-  ).optional()
+  containedInPlace: z21.union([
+    z21.object({ "@id": z21.string() }),
+    z21.lazy(
+      () => z21.object({ "@type": z21.string(), name: z21.string().optional() }).catchall(z21.unknown())
+    )
+  ]).optional()
 });
 var createPlace = makeFactory(PlaceSchema);
 
@@ -1000,11 +1024,15 @@ var LocalBusinessSchema = PlaceSchema.extend({
   iso6523Code: z22.string().optional(),
   hasMerchantReturnPolicy: MerchantReturnPolicySchema.optional(),
   sameAs: z22.union([z22.url(), z22.array(z22.url())]).optional(),
-  // Departments (nested LocalBusiness):
+  // Departments (nested LocalBusiness — accept @id refs for @graph cross-referencing):
   department: z22.lazy(
     () => z22.union([
+      z22.object({ "@id": z22.string() }),
       z22.object({ "@type": z22.string() }).catchall(z22.unknown()),
-      z22.array(z22.object({ "@type": z22.string() }).catchall(z22.unknown()))
+      z22.array(z22.union([
+        z22.object({ "@id": z22.string() }),
+        z22.object({ "@type": z22.string() }).catchall(z22.unknown())
+      ]))
     ])
   ).optional(),
   // Opening hours in string format (alternative to openingHoursSpecification):
@@ -1144,12 +1172,15 @@ var BookSchema = z24.object({
   sameAs: z24.union([z24.string(), z24.array(z24.string())]).optional(),
   /** Specific editions — each may have ReadAction / BorrowAction */
   workExample: z24.union([BookEditionSchema, z24.array(BookEditionSchema)]).optional(),
-  /** Publisher of the primary edition */
-  publisher: z24.object({
-    "@type": z24.union([z24.literal("Organization"), z24.literal("Person")]),
-    name: z24.string(),
-    url: z24.url().optional()
-  }).optional(),
+  /** Publisher of the primary edition (accept @id refs for @graph cross-referencing) */
+  publisher: z24.union([
+    z24.object({ "@id": z24.string() }),
+    z24.object({
+      "@type": z24.union([z24.literal("Organization"), z24.literal("Person")]),
+      name: z24.string(),
+      url: z24.url().optional()
+    })
+  ]).optional(),
   /** Number of pages */
   numberOfPages: z24.number().int().positive().optional(),
   /** Original publication year */
@@ -1159,7 +1190,10 @@ var BookSchema = z24.object({
   /** BCP 47 language tag */
   inLanguage: z24.string().optional(),
   /** Aggregate rating across editions */
-  aggregateRating: z24.lazy(() => z24.object({ "@type": z24.string() }).catchall(z24.unknown())).optional()
+  aggregateRating: z24.union([
+    z24.object({ "@id": z24.string() }),
+    z24.lazy(() => z24.object({ "@type": z24.string() }).catchall(z24.unknown()))
+  ]).optional()
 });
 var createBook = makeFactory(BookSchema);
 
@@ -1198,11 +1232,14 @@ var CreativeWorkSchema = extendThing("CreativeWork", {
       cssSelector: z25.string().optional()
     })
   ).optional(),
-  // For subscription / paywalled content
-  isPartOf: z25.object({
-    "@type": z25.string(),
-    name: z25.string().optional()
-  }).optional(),
+  // For subscription / paywalled content (accept @id refs for @graph cross-referencing)
+  isPartOf: z25.union([
+    z25.object({ "@id": z25.string() }),
+    z25.object({
+      "@type": z25.string(),
+      name: z25.string().optional()
+    })
+  ]).optional(),
   text: z25.string().optional(),
   abstract: z25.string().optional(),
   encodingFormat: z25.string().optional(),
@@ -1238,9 +1275,10 @@ var NewsArticleSchema = ArticleSchema.extend({
 });
 var BlogPostingSchema = ArticleSchema.extend({
   "@type": z26.literal("BlogPosting").default("BlogPosting"),
-  sharedContent: z26.lazy(
-    () => z26.object({ "@type": z26.string() }).passthrough()
-  ).optional()
+  sharedContent: z26.union([
+    z26.object({ "@id": z26.string() }),
+    z26.lazy(() => z26.object({ "@type": z26.string() }).catchall(z26.unknown()))
+  ]).optional()
 });
 var createArticle = makeFactory(ArticleSchema);
 var createNewsArticle = makeFactory(NewsArticleSchema);
@@ -1250,9 +1288,12 @@ var createBlogPosting = makeFactory(BlogPostingSchema);
 import { z as z27 } from "zod";
 var WebPageSchema = CreativeWorkSchema.extend({
   "@type": z27.literal("WebPage").default("WebPage"),
-  breadcrumb: z27.lazy(
-    () => z27.object({ "@type": z27.literal("BreadcrumbList") }).catchall(z27.unknown())
-  ).optional(),
+  breadcrumb: z27.union([
+    z27.object({ "@id": z27.string() }),
+    z27.lazy(
+      () => z27.object({ "@type": z27.literal("BreadcrumbList") }).catchall(z27.unknown())
+    )
+  ]).optional(),
   lastReviewed: z27.string().optional(),
   reviewedBy: PersonOrOrgRef.optional(),
   speakable: z27.object({
@@ -1261,8 +1302,14 @@ var WebPageSchema = CreativeWorkSchema.extend({
     xpath: z27.union([z27.string(), z27.array(z27.string())]).optional()
   }).optional(),
   significantLink: z27.union([z27.url(), z27.array(z27.url())]).optional(),
-  mainContentOfPage: z27.object({ "@type": z27.string() }).catchall(z27.unknown()).optional(),
-  primaryImageOfPage: z27.object({ "@type": z27.string() }).catchall(z27.unknown()).optional(),
+  mainContentOfPage: z27.union([
+    z27.object({ "@id": z27.string() }),
+    z27.object({ "@type": z27.string() }).catchall(z27.unknown())
+  ]).optional(),
+  primaryImageOfPage: z27.union([
+    z27.object({ "@id": z27.string() }),
+    z27.object({ "@type": z27.string() }).catchall(z27.unknown())
+  ]).optional(),
   relatedLink: z27.union([z27.url(), z27.array(z27.url())]).optional()
 });
 var createWebPage = makeFactory(WebPageSchema);
@@ -1297,8 +1344,11 @@ var WebSiteSchema = CreativeWorkSchema.extend({
   publisher: PersonOrOrgRef.optional(),
   // Site-level metadata
   copyrightYear: z28.number().int().optional(),
-  // isPartOf — rarely used for WebSite itself but allowed
-  isPartOf: z28.lazy(() => z28.object({ "@type": z28.string() }).catchall(z28.unknown())).optional()
+  // isPartOf — rarely used for WebSite itself but allowed (accept @id refs for @graph)
+  isPartOf: z28.union([
+    z28.object({ "@id": z28.string() }),
+    z28.lazy(() => z28.object({ "@type": z28.string() }).catchall(z28.unknown()))
+  ]).optional()
 });
 var createWebSite = makeFactory(WebSiteSchema);
 
@@ -1706,7 +1756,7 @@ var JobPostingSchema = z37.object({
   // Required by Google:
   title: z37.string(),
   description: z37.string(),
-  hiringOrganization: HiringOrgRef,
+  hiringOrganization: z37.union([z37.object({ "@id": z37.string() }), HiringOrgRef]),
   jobLocation: z37.union([JobLocationRef, z37.array(JobLocationRef)]).optional(),
   datePosted: z37.string(),
   // ISO 8601 date
@@ -1820,7 +1870,10 @@ var QuizSchema = CreativeWorkSchema.extend({
   "@type": z38.literal("Quiz").default("Quiz"),
   name: z38.string().optional(),
   educationalLevel: z38.string().optional(),
-  about: z38.lazy(() => z38.object({ "@type": z38.string() }).catchall(z38.unknown())).optional(),
+  about: z38.union([
+    z38.object({ "@id": z38.string() }),
+    z38.lazy(() => z38.object({ "@type": z38.string() }).catchall(z38.unknown()))
+  ]).optional(),
   hasPart: z38.array(QuestionSchema).optional(),
   educationalAlignment: z38.union([AlignmentObjectSchema, z38.array(AlignmentObjectSchema)]).optional()
 });
@@ -1860,9 +1913,12 @@ var DiscussionForumPostingSchema = CreativeWorkSchema.extend({
   image: ImageOrUrl.optional(),
   /** "published", "draft", "deleted" — or a schema.org enum URL */
   creativeWorkStatus: z39.string().optional(),
-  mainEntityOfPage: z39.union([z39.url(), z39.object({}).catchall(z39.unknown())]).optional(),
-  // For reposts:
-  sharedContent: z39.lazy(() => z39.object({ "@type": z39.string() }).catchall(z39.unknown())).optional(),
+  mainEntityOfPage: z39.union([z39.url(), z39.object({ "@id": z39.string() }), z39.object({}).catchall(z39.unknown())]).optional(),
+  // For reposts (accept @id refs for @graph cross-referencing):
+  sharedContent: z39.union([
+    z39.object({ "@id": z39.string() }),
+    z39.lazy(() => z39.object({ "@type": z39.string() }).catchall(z39.unknown()))
+  ]).optional(),
   interactionStatistic: z39.union([InteractionCounterSchema, z39.array(InteractionCounterSchema)]).optional()
 });
 var createDiscussionForumPosting = makeFactory(
@@ -1899,13 +1955,17 @@ var createItemList = makeFactory(ItemListSchema);
 import { z as z41 } from "zod";
 var ProfilePageSchema = WebPageSchema.extend({
   "@type": z41.literal("ProfilePage").default("ProfilePage"),
-  // mainEntity: the person or org this profile is about (loose ref to avoid circular imports)
-  mainEntity: z41.lazy(
-    () => z41.object({ "@type": z41.string() }).catchall(z41.unknown())
-  ).optional(),
+  // mainEntity: the person or org this profile is about (accept @id refs for @graph)
+  mainEntity: z41.union([
+    z41.object({ "@id": z41.string() }),
+    z41.lazy(() => z41.object({ "@type": z41.string() }).catchall(z41.unknown()))
+  ]).optional(),
   // hasPart: content published by/about this profile subject
   hasPart: z41.array(
-    z41.lazy(() => z41.object({ "@type": z41.string() }).catchall(z41.unknown()))
+    z41.union([
+      z41.object({ "@id": z41.string() }),
+      z41.lazy(() => z41.object({ "@type": z41.string() }).catchall(z41.unknown()))
+    ])
   ).optional(),
   dateCreated: z41.string().optional(),
   dateModified: z41.string().optional()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "schemaorg-kit",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Type-safe schema.org structured data builder — all Google rich result types, Zod validation, JSON-LD @graph",
   "keywords": [
     "schema.org",