Aller au contenu
unschema-graph
ENFR

JSON‑LD typé pour Astro, Svelte et TypeScript

Publiez un JSON‑LD valide sans maintenir vos schémas à la main.

Composez vos entités Schema.org en TypeScript, validez-les avec Zod, résolvez chaque référence et sérialisez-les sans risque pour le HTML.

Construire mon premier grapheVoir la différence
51
builders Schema.org
Zod
validation à l’exécution
Sûr
sérialisation HTML
CLI
audit du HTML compilé

JSON‑LD manuel ou builders typés

Validez la structure de vos entités avec Zod, reliez-les dans un @graph et sérialisez sans risque de rupture HTML.

manual-schema.tsSans unschema-graph
const article = {
  "@type": "Article",
  "headline": "Données structurées",
  "publisher": { "@id": "#publsher" }
};

const jsonLd = JSON.stringify(article);
Objet écrit à la main, exposé aux fautes de frappe et aux ruptures de balise.
  • Absence de schéma : fautes de frappe et propriétés requises manquantes non détectées
  • Chaînes @id dupliquées risquant des références orphelines dans le graphe
  • Sérialisation brute risquant de clore la balise <script> si le texte contient </script>
schema.tsAvec unschema-graph
// Typé, validé et relié
const publisher = Organization({
  '@id': '#publisher',
  name: 'Acme Media'
});

const article = Article({
  headline: 'Données structurées',
  publisher: '#publisher'
});

const jsonLd = serializeJsonLd(buildJsonLdGraph([publisher, article]));

Graphe résolu · Données validées par Zod · Échappement anti-rupture <script>

  • 51 builders Zod avec autocomplétion TypeScript des propriétés Schema.org
  • buildJsonLdGraph unifie les entités et résout automatiquement les références locales #id
  • serializeJsonLd neutralise les séquences </script> et <!-- pour une inclusion HTML sûre

Choisissez votre environnement

Choisissez le paquet adapté à votre stack. Les mêmes builders et le même moteur fonctionnent partout.

Astro

@unschema-graph/astro
  • Composant <Schema /> natif et helpers Content Collections
  • Inspection du JSON‑LD dans l’Astro Dev Toolbar
pnpm add @unschema-graph/astroDémarrer avec Astro

Svelte

@unschema-graph/svelte
  • Runes Svelte 5 natives et sortie dans <svelte:head>
  • Les 51 builders sans JavaScript client superflu
pnpm add @unschema-graph/svelteDémarrer avec Svelte

TypeScript

@unschema-graph/core
  • Builders universels pour Node.js, Vite, Next.js et SSR sur mesure
  • API pures pour le graphe, la sérialisation et l’audit
pnpm add @unschema-graph/coreDémarrer avec TypeScript

Des entités typées au HTML audité

La chaîne concrète de vos données structurées, conforme à l’implémentation.

  1. 01

    Construire

    Article({ headline, ... })

    Builders TypeScript validés par Zod avec autocomplétion des propriétés Schema.org.

  2. 02

    Relier

    publisher: '#publisher'

    Liaison automatique des entités dans un @graph unifié à partir des références locales #id.

  3. 03

    Valider

    Article.safeParse(data)

    Vérification stricte à l’exécution renvoyant { success, data } ou des erreurs Zod précises.

  4. 04

    Auditer

    unschema-graph audit dist

    Scan statique des balises JSON‑LD et de la structure du graphe dans vos fichiers HTML compilés.

Partez du résultat recherché

Des recettes ciblées pour les cas d’usage courants du web.

/blog-mediaBlog & MédiasArticles, auteurs, dates de publication et fil d’Ariane./company-siteEntreprise & MarqueIdentité d’organisation, logo, points de contact et réseaux./ecommerceE-CommerceProduits, offres commerciales, devises et avis agrégés./local-businessCommerce localÉtablissements, coordonnées géographiques et horaires d’ouverture./eventsÉvénements & BilletterieÉvénements, lieux physiques, diffusions vidéo et billets.
Consulter toutes les recettes
unschema-graph

Construisez votre premier graphe typé

Choisissez votre environnement, composez une entité et publiez un JSON‑LD validé sans maintenir d’objets bruts.

Ouvrir le guide de démarrageVoir sur GitHub