refactor: use JSON-LD schema types from the `schema-dts` package (#751)

Co-authored-by: Daniel Roe <[e-mail]>

app/composables/useJsonLd.ts

···
-// JSON-LD Schema Types
-interface JsonLdBase {
-  '@context': 'https://schema.org'
-  '@type': string
-}
-
-interface WebSiteSchema extends JsonLdBase {
-  '@type': 'WebSite'
-  'name': string
-  'url': string
-  'description'?: string
-  'potentialAction'?: SearchActionSchema
-}
-
-interface SearchActionSchema {
-  '@type': 'SearchAction'
-  'target': {
-    '@type': 'EntryPoint'
-    'urlTemplate': string
-  }
-  'query-input': string
-}
-
-interface SoftwareApplicationSchema extends JsonLdBase {
-  '@type': 'SoftwareApplication'
-  'name': string
-  'description'?: string
-  'applicationCategory': 'DeveloperApplication'
-  'operatingSystem': 'Cross-platform'
-  'url': string
-  'softwareVersion'?: string
-  'dateModified'?: string
-  'datePublished'?: string
-  'license'?: string
-  'author'?: PersonSchema | OrganizationSchema | (PersonSchema | OrganizationSchema)[]
-  'maintainer'?: PersonSchema | OrganizationSchema | (PersonSchema | OrganizationSchema)[]
-  'offers'?: OfferSchema
-  'downloadUrl'?: string
-  'codeRepository'?: string
-  'keywords'?: string[]
-}
-
-interface PersonSchema extends JsonLdBase {
-  '@type': 'Person'
-  'name': string
-  'url'?: string
-}
-
-interface OrganizationSchema extends JsonLdBase {
-  '@type': 'Organization'
-  'name': string
-  'url'?: string
-  'logo'?: string
-  'description'?: string
-  'sameAs'?: string[]
-}
-
-interface OfferSchema {
-  '@type': 'Offer'
-  'price': string
-  'priceCurrency': string
-}
-
-interface BreadcrumbListSchema extends JsonLdBase {
-  '@type': 'BreadcrumbList'
-  'itemListElement': BreadcrumbItemSchema[]
-}
-
-interface BreadcrumbItemSchema {
-  '@type': 'ListItem'
-  'position': number
-  'name': string
-  'item'?: string
-}
-
-interface ProfilePageSchema extends JsonLdBase {
-  '@type': 'ProfilePage'
-  'name': string
-  'url': string
-  'mainEntity': PersonSchema | OrganizationSchema
-}
-
-type JsonLdSchema =
-  | WebSiteSchema
-  | SoftwareApplicationSchema
-  | PersonSchema
-  | OrganizationSchema
-  | BreadcrumbListSchema
-  | ProfilePageSchema
+import type { Thing, WebSite, WithContext } from 'schema-dts'
 
 /**
  * Inject JSON-LD script into head
  */
-export function setJsonLd(schema: JsonLdSchema | JsonLdSchema[]) {
+export function setJsonLd(schema: WithContext<Thing> | WithContext<Thing>[]): void {
   const schemas = Array.isArray(schema) ? schema : [schema]
 
   useHead({
···
 export function createWebSiteSchema(options?: {
   name?: string
   description?: string
-}): WebSiteSchema {
+}): WithContext<WebSite> {
   const siteUrl = 'https://npmx.dev'
   return {
     '@context': 'https://schema.org',
···
         '@type': 'EntryPoint',
         'urlTemplate': `${siteUrl}/search?q={search_term_string}`,
       },
-      'query-input': 'required name=search_term_string',
+      'query': 'required name=search_term_string',
     },
   }
 }

package.json

···
     "knip": "5.82.1",
     "lint-staged": "16.2.7",
     "playwright-core": "1.58.0",
+    "schema-dts": "1.1.5",
     "simple-git-hooks": "2.13.1",
     "typescript": "5.9.3",
     "vitest": "npm:@voidzero-dev/vite-plus-test@0.0.0-833c515fa25cef20905a7f9affb156dfa6f151ab",

pnpm-lock.yaml

···
       playwright-core:
         specifier: 1.58.0
         version: 1.58.0
+      schema-dts:
+        specifier: 1.1.5
+        version: 1.1.5
       simple-git-hooks:
         specifier: 2.13.1
         version: 2.13.1
···
   sax@1.4.4:
     resolution: {integrity: sha512-1n3r/tGXO6b6VXMdFT54SHzT9ytu9yr7TaELowdYpMqY/Ao7EnlQGmAQ1+RatX7Tkkdm6hONI2owqNx2aZj5Sw==}
     engines: {node: '>=11.0.0'}
+
+  schema-dts@1.1.5:
+    resolution: {integrity: sha512-RJr9EaCmsLzBX2NDiO5Z3ux2BVosNZN5jo0gWgsyKvxKIUL5R3swNvoorulAeL9kLB0iTSX7V6aokhla2m7xbg==}
 
   schema-utils@4.3.3:
     resolution: {integrity: sha512-eflK8wEtyOE6+hsaRVPxvUKYCpRgzLqDTb8krvAsRIwOGlHoSgYLgBXoubGgLd2fT41/OUYdb48v4k4WWHQurA==}
···
       yoga-layout: 3.2.1
 
   sax@1.4.4: {}
+
+  schema-dts@1.1.5: {}
 
   schema-utils@4.3.3:
     dependencies: