@jdevalk/seo-graph-core 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Joost de Valk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,29 @@
+# @jdevalk/seo-graph-core
+
+Pure schema.org JSON-LD graph builders. Runtime-agnostic core for agent-ready SEO.
+
+> **Status:** pre-v1, scaffolding phase. No stable API yet. See the
+> [roadmap](https://github.com/jdevalk/seo-graph#roadmap) in the monorepo root.
+
+## What this is
+
+A small, dependency-light library that builds a valid schema.org `@graph` from
+a set of typed inputs. It does one thing: turn structured page data into
+byte-correct JSON-LD that search engines and agents can consume.
+
+It does **not** know anything about Astro, Next.js, EmDash, WordPress, or any
+other runtime. Use `@jdevalk/astro-seo-graph` for the Astro integration, or
+consume this directly from your own CMS/framework.
+
+## Why
+
+The [agent-ready web](https://joost.blog/tag/agent-ready/) needs every
+publisher to expose a rich, linked knowledge graph for their content. Hand-
+writing JSON-LD is error-prone; writing it once per framework is worse.
+`@jdevalk/seo-graph-core` is the shared core that two real consumers — this
+blog (Astro) and [`@jdevalk/emdash-plugin-seo`](https://www.npmjs.com/package/@jdevalk/emdash-plugin-seo)
+(EmDash CMS) — will both depend on, so the graph they emit stays consistent.
+
+## License
+
+MIT © Joost de Valk

package/dist/assemble.d.ts

@@ -0,0 +1,10 @@
+import type { GraphEntity } from './types.js';
+/**
+ * Wrap a list of pieces in a `@context + @graph` envelope. Pieces are
+ * deduplicated by `@id` before assembly; first occurrence wins.
+ */
+export declare function assembleGraph<T extends GraphEntity>(pieces: readonly T[]): {
+    '@context': 'https://schema.org';
+    '@graph': T[];
+};
+//# sourceMappingURL=assemble.d.ts.map

package/dist/assemble.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assemble.d.ts","sourceRoot":"","sources":["../src/assemble.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,WAAW,EAC/C,MAAM,EAAE,SAAS,CAAC,EAAE,GACrB;IAAE,UAAU,EAAE,oBAAoB,CAAC;IAAC,QAAQ,EAAE,CAAC,EAAE,CAAA;CAAE,CAKrD"}

package/dist/assemble.js

@@ -0,0 +1,12 @@
+import { deduplicateByGraphId } from './dedupe.js';
+/**
+ * Wrap a list of pieces in a `@context + @graph` envelope. Pieces are
+ * deduplicated by `@id` before assembly; first occurrence wins.
+ */
+export function assembleGraph(pieces) {
+    return {
+        '@context': 'https://schema.org',
+        '@graph': deduplicateByGraphId(pieces),
+    };
+}
+//# sourceMappingURL=assemble.js.map

package/dist/assemble.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assemble.js","sourceRoot":"","sources":["../src/assemble.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD;;;GAGG;AACH,MAAM,UAAU,aAAa,CACzB,MAAoB;IAEpB,OAAO;QACH,UAAU,EAAE,oBAAoB;QAChC,QAAQ,EAAE,oBAAoB,CAAC,MAAM,CAAC;KACzC,CAAC;AACN,CAAC"}

package/dist/dedupe.d.ts

@@ -0,0 +1,7 @@
+import type { GraphEntity } from './types.js';
+/**
+ * Deduplicate entities by their `@id`. First occurrence wins. Entities
+ * without an `@id` are always kept.
+ */
+export declare function deduplicateByGraphId<T extends GraphEntity>(entities: readonly T[]): T[];
+//# sourceMappingURL=dedupe.d.ts.map

package/dist/dedupe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedupe.d.ts","sourceRoot":"","sources":["../src/dedupe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,WAAW,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE,CAYvF"}

package/dist/dedupe.js

@@ -0,0 +1,19 @@
+/**
+ * Deduplicate entities by their `@id`. First occurrence wins. Entities
+ * without an `@id` are always kept.
+ */
+export function deduplicateByGraphId(entities) {
+    const seen = new Set();
+    const result = [];
+    for (const entity of entities) {
+        const id = entity['@id'];
+        if (id !== undefined) {
+            if (seen.has(id))
+                continue;
+            seen.add(id);
+        }
+        result.push(entity);
+    }
+    return result;
+}
+//# sourceMappingURL=dedupe.js.map

package/dist/dedupe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedupe.js","sourceRoot":"","sources":["../src/dedupe.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAwB,QAAsB;IAC9E,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,MAAM,GAAQ,EAAE,CAAC;IACvB,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC5B,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YACnB,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,SAAS;YAC3B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/ids.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Factory for stable @id URIs used to cross-reference entities in the graph.
+ *
+ * Site-wide singletons live at `${siteUrl}/#/schema.org/<Type>` (WebSite,
+ * Person, etc). Per-page entities live at `${pageUrl}#<suffix>` (Article,
+ * Breadcrumb, PrimaryImage). The `person` id defaults to the site root but
+ * can be relocated to e.g. `/about-me/` via `personUrl`.
+ */
+export interface IdFactory {
+    /** Site-wide Person id. Defaults to `${siteUrl}/#/schema.org/Person`. */
+    readonly person: string;
+    /** Site-wide Person image id (friendly-named fragment). */
+    readonly personImage: string;
+    /** Site-wide WebSite id. */
+    readonly website: string;
+    /** Site-wide SiteNavigationElement id. */
+    readonly navigation: string;
+    /** Per-org id factory — pass a stable slug. */
+    organization(slug: string): string;
+    /** Per-country id factory — pass an ISO 3166 alpha-2 code. */
+    country(code: string): string;
+    /** WebPage id equals the canonical URL itself. */
+    webPage(url: string): string;
+    /** Breadcrumb id for a given page URL. */
+    breadcrumb(url: string): string;
+    /** Article id for a given page URL. */
+    article(url: string): string;
+    /** VideoObject id for a given page URL. */
+    videoObject(url: string): string;
+    /** Primary ImageObject id for a given page URL. */
+    primaryImage(url: string): string;
+}
+export interface MakeIdsOptions {
+    /** Canonical site URL, with or without trailing slash. E.g. `https://joost.blog`. */
+    siteUrl: string;
+    /**
+     * URL where the site-wide Person entity lives, with trailing slash.
+     * Defaults to `${siteUrl}/`. joost.blog uses `${siteUrl}/about-me/`.
+     */
+    personUrl?: string;
+}
+/**
+ * Build an IdFactory for a given site. The returned factory is stateless —
+ * call it as many times as you like, on any piece builder.
+ */
+export declare function makeIds(options: MakeIdsOptions): IdFactory;
+//# sourceMappingURL=ids.d.ts.map

package/dist/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACtB,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,4BAA4B;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,0CAA0C;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,+CAA+C;IAC/C,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,8DAA8D;IAC9D,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,kDAAkD;IAClD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,0CAA0C;IAC1C,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,uCAAuC;IACvC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,2CAA2C;IAC3C,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,mDAAmD;IACnD,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,cAAc;IAC3B,qFAAqF;IACrF,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAkBD;;;GAGG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,CAiB1D"}

package/dist/ids.js

@@ -0,0 +1,36 @@
+/**
+ * Normalize a base URL: strip any trailing slash so we can append `/#...`
+ * consistently.
+ */
+function stripTrailingSlash(url) {
+    return url.replace(/\/+$/, '');
+}
+/**
+ * Normalize a person URL: ensure a single trailing slash so the resulting
+ * id reads `${personUrl}#/schema.org/Person` with the `/` already present.
+ */
+function ensureTrailingSlash(url) {
+    return url.endsWith('/') ? url : `${url}/`;
+}
+/**
+ * Build an IdFactory for a given site. The returned factory is stateless —
+ * call it as many times as you like, on any piece builder.
+ */
+export function makeIds(options) {
+    const site = stripTrailingSlash(options.siteUrl);
+    const person = ensureTrailingSlash(options.personUrl ?? `${site}/`);
+    return {
+        person: `${person}#/schema.org/Person`,
+        personImage: `${site}/#personlogo`,
+        website: `${site}/#/schema.org/WebSite`,
+        navigation: `${site}/#site-navigation`,
+        organization: (slug) => `${site}/#/schema.org/Organization/${slug}`,
+        country: (code) => `${site}/#/schema.org/Country/${code.toLowerCase()}`,
+        webPage: (url) => url,
+        breadcrumb: (url) => `${url}#breadcrumb`,
+        article: (url) => `${url}#article`,
+        videoObject: (url) => `${url}#video`,
+        primaryImage: (url) => `${url}#primaryimage`,
+    };
+}
+//# sourceMappingURL=ids.js.map

package/dist/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AA2CA;;;GAGG;AACH,SAAS,kBAAkB,CAAC,GAAW;IACnC,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,SAAS,mBAAmB,CAAC,GAAW;IACpC,OAAO,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,OAAuB;IAC3C,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,SAAS,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC;IAEpE,OAAO;QACH,MAAM,EAAE,GAAG,MAAM,qBAAqB;QACtC,WAAW,EAAE,GAAG,IAAI,cAAc;QAClC,OAAO,EAAE,GAAG,IAAI,uBAAuB;QACvC,UAAU,EAAE,GAAG,IAAI,mBAAmB;QACtC,YAAY,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,GAAG,IAAI,8BAA8B,IAAI,EAAE;QAC3E,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,GAAG,IAAI,yBAAyB,IAAI,CAAC,WAAW,EAAE,EAAE;QAC/E,OAAO,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG;QAC7B,UAAU,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,GAAG,aAAa;QAChD,OAAO,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,GAAG,UAAU;QAC1C,WAAW,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,GAAG,QAAQ;QAC5C,YAAY,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,GAAG,eAAe;KACvD,CAAC;AACN,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+export type { GraphEntity, Reference, SchemaGraph } from './types.js';
+export type { IdFactory, MakeIdsOptions } from './ids.js';
+export { makeIds } from './ids.js';
+export { deduplicateByGraphId } from './dedupe.js';
+export { assembleGraph } from './assemble.js';
+export { buildWebSite } from './pieces/website.js';
+export type { WebSiteInput } from './pieces/website.js';
+export { buildPerson } from './pieces/person.js';
+export type { PersonInput } from './pieces/person.js';
+export { buildOrganization } from './pieces/organization.js';
+export type { OrganizationInput } from './pieces/organization.js';
+export { buildSiteNavigationElement } from './pieces/navigation.js';
+export type { NavigationItem, SiteNavigationInput } from './pieces/navigation.js';
+export { buildWebPage } from './pieces/webpage.js';
+export type { WebPageInput, WebPageType } from './pieces/webpage.js';
+export { buildArticle } from './pieces/article.js';
+export type { ArticleInput } from './pieces/article.js';
+export { buildBreadcrumbList } from './pieces/breadcrumb.js';
+export type { BreadcrumbItem, BreadcrumbListInput } from './pieces/breadcrumb.js';
+export { buildImageObject } from './pieces/image.js';
+export type { ImageObjectInput } from './pieces/image.js';
+export { buildVideoObject } from './pieces/video.js';
+export type { VideoObjectInput } from './pieces/video.js';
+export { buildCustomPiece } from './pieces/custom.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACtE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG9C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElF,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAErE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElF,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+// @jdevalk/seo-graph-core — agent-ready schema.org JSON-LD graph builders.
+export { makeIds } from './ids.js';
+export { deduplicateByGraphId } from './dedupe.js';
+export { assembleGraph } from './assemble.js';
+// Piece builders
+export { buildWebSite } from './pieces/website.js';
+export { buildPerson } from './pieces/person.js';
+export { buildOrganization } from './pieces/organization.js';
+export { buildSiteNavigationElement } from './pieces/navigation.js';
+export { buildWebPage } from './pieces/webpage.js';
+export { buildArticle } from './pieces/article.js';
+export { buildBreadcrumbList } from './pieces/breadcrumb.js';
+export { buildImageObject } from './pieces/image.js';
+export { buildVideoObject } from './pieces/video.js';
+export { buildCustomPiece } from './pieces/custom.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAI3E,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,iBAAiB;AACjB,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAGpE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAG7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/pieces/article.d.ts

@@ -0,0 +1,36 @@
+import type { IdFactory } from '../ids.js';
+import type { Reference } from '../types.js';
+export interface ArticleInput {
+    /** Canonical URL of the article's page. The @id is `${url}#article`. */
+    url: string;
+    /** Reference to the enclosing WebPage (usually ids.webPage(url)). */
+    isPartOf: Reference;
+    /** Author reference. May include a `name` alongside the `@id`. */
+    author: Reference;
+    /** Publisher reference. Usually the same as the author for personal blogs. */
+    publisher: Reference;
+    headline: string;
+    description: string;
+    inLanguage?: string;
+    datePublished: Date;
+    dateModified?: Date;
+    /** Reference to the primary ImageObject, if any. */
+    image?: Reference;
+    /** Top-level category, emitted as `articleSection`. */
+    articleSection?: string;
+    wordCount?: number;
+    /**
+     * Full or truncated article body, emitted as `articleBody`. Pass from
+     * the aggregator / build step; core doesn't derive it from anything.
+     */
+    articleBody?: string;
+    extra?: Record<string, unknown>;
+}
+/**
+ * Build a schema.org Article piece. The caller is responsible for pre-
+ * computing the references (author, publisher, isPartOf, image) using the
+ * IdFactory, so core doesn't have to know anything about how the site
+ * models its Person/Organization/WebPage entities.
+ */
+export declare function buildArticle(input: ArticleInput, ids: IdFactory): Record<string, unknown>;
+//# sourceMappingURL=article.d.ts.map

package/dist/pieces/article.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"article.d.ts","sourceRoot":"","sources":["../../src/pieces/article.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,YAAY;IACzB,wEAAwE;IACxE,GAAG,EAAE,MAAM,CAAC;IACZ,qEAAqE;IACrE,QAAQ,EAAE,SAAS,CAAC;IACpB,kEAAkE;IAClE,MAAM,EAAE,SAAS,CAAC;IAClB,8EAA8E;IAC9E,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,IAAI,CAAC;IACpB,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,oDAAoD;IACpD,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuBzF"}

package/dist/pieces/article.js

@@ -0,0 +1,33 @@
+/**
+ * Build a schema.org Article piece. The caller is responsible for pre-
+ * computing the references (author, publisher, isPartOf, image) using the
+ * IdFactory, so core doesn't have to know anything about how the site
+ * models its Person/Organization/WebPage entities.
+ */
+export function buildArticle(input, ids) {
+    const piece = {
+        '@type': 'Article',
+        '@id': ids.article(input.url),
+        isPartOf: input.isPartOf,
+        author: input.author,
+        headline: input.headline,
+        mainEntityOfPage: { '@id': ids.webPage(input.url) },
+        publisher: input.publisher,
+        inLanguage: input.inLanguage ?? 'en-US',
+        description: input.description,
+        datePublished: input.datePublished.toISOString(),
+    };
+    if (input.dateModified !== undefined) {
+        piece.dateModified = input.dateModified.toISOString();
+    }
+    if (input.image !== undefined)
+        piece.image = input.image;
+    if (input.articleSection !== undefined)
+        piece.articleSection = input.articleSection;
+    if (input.wordCount !== undefined)
+        piece.wordCount = input.wordCount;
+    if (input.articleBody !== undefined)
+        piece.articleBody = input.articleBody;
+    return { ...piece, ...input.extra };
+}
+//# sourceMappingURL=article.js.map

package/dist/pieces/article.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"article.js","sourceRoot":"","sources":["../../src/pieces/article.ts"],"names":[],"mappings":"AA8BA;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,KAAmB,EAAE,GAAc;IAC5D,MAAM,KAAK,GAA4B;QACnC,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC;QAC7B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,gBAAgB,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;QACnD,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,OAAO;QACvC,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,aAAa,EAAE,KAAK,CAAC,aAAa,CAAC,WAAW,EAAE;KACnD,CAAC;IAEF,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACnC,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;IAC1D,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IACzD,IAAI,KAAK,CAAC,cAAc,KAAK,SAAS;QAAE,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC;IACpF,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;QAAE,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IACrE,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;QAAE,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IAE3E,OAAO,EAAE,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;AACxC,CAAC"}

package/dist/pieces/breadcrumb.d.ts

@@ -0,0 +1,27 @@
+import type { IdFactory } from '../ids.js';
+export interface BreadcrumbItem {
+    /** Display name for this crumb, e.g. 'Home', 'Blog', 'Open Source'. */
+    name: string;
+    /** URL for this crumb. */
+    url: string;
+}
+export interface BreadcrumbListInput {
+    /**
+     * The URL of the page this breadcrumb belongs to. The @id is
+     * `${url}#breadcrumb`.
+     */
+    url: string;
+    /** Pre-computed ordered list of crumbs, root first. */
+    items: readonly BreadcrumbItem[];
+    extra?: Record<string, unknown>;
+}
+/**
+ * Build a schema.org BreadcrumbList piece.
+ *
+ * Breadcrumbs are an input to core, not a derivation. The caller knows
+ * its routing conventions; core just wraps the pre-computed items in the
+ * right schema.org shape. If you need to derive breadcrumbs from an
+ * Astro URL, use `@jdevalk/astro-seo-graph`'s breadcrumb helper instead.
+ */
+export declare function buildBreadcrumbList(input: BreadcrumbListInput, ids: IdFactory): Record<string, unknown>;
+//# sourceMappingURL=breadcrumb.d.ts.map

package/dist/pieces/breadcrumb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumb.d.ts","sourceRoot":"","sources":["../../src/pieces/breadcrumb.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC3B,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,GAAG,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAChC;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,uDAAuD;IACvD,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAC/B,KAAK,EAAE,mBAAmB,EAC1B,GAAG,EAAE,SAAS,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAazB"}

package/dist/pieces/breadcrumb.js

@@ -0,0 +1,23 @@
+/**
+ * Build a schema.org BreadcrumbList piece.
+ *
+ * Breadcrumbs are an input to core, not a derivation. The caller knows
+ * its routing conventions; core just wraps the pre-computed items in the
+ * right schema.org shape. If you need to derive breadcrumbs from an
+ * Astro URL, use `@jdevalk/astro-seo-graph`'s breadcrumb helper instead.
+ */
+export function buildBreadcrumbList(input, ids) {
+    const itemListElement = input.items.map((item, index) => ({
+        '@type': 'ListItem',
+        position: index + 1,
+        name: item.name,
+        item: item.url,
+    }));
+    return {
+        '@type': 'BreadcrumbList',
+        '@id': ids.breadcrumb(input.url),
+        itemListElement,
+        ...input.extra,
+    };
+}
+//# sourceMappingURL=breadcrumb.js.map

package/dist/pieces/breadcrumb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumb.js","sourceRoot":"","sources":["../../src/pieces/breadcrumb.ts"],"names":[],"mappings":"AAoBA;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAC/B,KAA0B,EAC1B,GAAc;IAEd,MAAM,eAAe,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACtD,OAAO,EAAE,UAAU;QACnB,QAAQ,EAAE,KAAK,GAAG,CAAC;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,GAAG;KACjB,CAAC,CAAC,CAAC;IACJ,OAAO;QACH,OAAO,EAAE,gBAAgB;QACzB,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC;QAChC,eAAe;QACf,GAAG,KAAK,CAAC,KAAK;KACjB,CAAC;AACN,CAAC"}

package/dist/pieces/custom.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Escape hatch: build an arbitrary schema.org piece from a raw object.
+ *
+ * Use this when the built-in piece builders don't cover what you need —
+ * e.g. a Recipe, Event, Product, or a LocalBusiness subtype that needs
+ * a specific shape not captured by `buildOrganization`.
+ *
+ * Note: the built piece is returned as-is. It's the caller's responsibility
+ * to supply a valid `@type` and (if cross-referenced) a stable `@id`.
+ */
+export declare function buildCustomPiece<T extends Record<string, unknown>>(raw: T): T;
+//# sourceMappingURL=custom.d.ts.map

package/dist/pieces/custom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom.d.ts","sourceRoot":"","sources":["../../src/pieces/custom.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAE7E"}

package/dist/pieces/custom.js

@@ -0,0 +1,14 @@
+/**
+ * Escape hatch: build an arbitrary schema.org piece from a raw object.
+ *
+ * Use this when the built-in piece builders don't cover what you need —
+ * e.g. a Recipe, Event, Product, or a LocalBusiness subtype that needs
+ * a specific shape not captured by `buildOrganization`.
+ *
+ * Note: the built piece is returned as-is. It's the caller's responsibility
+ * to supply a valid `@type` and (if cross-referenced) a stable `@id`.
+ */
+export function buildCustomPiece(raw) {
+    return raw;
+}
+//# sourceMappingURL=custom.js.map

package/dist/pieces/custom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom.js","sourceRoot":"","sources":["../../src/pieces/custom.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAoC,GAAM;IACtE,OAAO,GAAG,CAAC;AACf,CAAC"}

package/dist/pieces/image.d.ts

@@ -0,0 +1,25 @@
+import type { IdFactory } from '../ids.js';
+export interface ImageObjectInput {
+    /**
+     * Canonical URL of the page this image belongs to. The @id is
+     * `${pageUrl}#primaryimage` — to build a site-wide image with a
+     * friendly fragment (e.g. the Person logo), use the `id` override.
+     */
+    pageUrl?: string;
+    /** Explicit @id override; takes precedence over `pageUrl`. */
+    id?: string;
+    /** Public URL of the image file. Used for both `url` and `contentUrl`. */
+    url: string;
+    width: number;
+    height: number;
+    inLanguage?: string;
+    caption?: string;
+    extra?: Record<string, unknown>;
+}
+/**
+ * Build a schema.org ImageObject piece. Pass `pageUrl` for a page's
+ * primary image (id = `${pageUrl}#primaryimage`), or `id` for a site-
+ * wide image like a personal logo.
+ */
+export declare function buildImageObject(input: ImageObjectInput, ids: IdFactory): Record<string, unknown>;
+//# sourceMappingURL=image.d.ts.map

package/dist/pieces/image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../src/pieces/image.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,MAAM,WAAW,gBAAgB;IAC7B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC5B,KAAK,EAAE,gBAAgB,EACvB,GAAG,EAAE,SAAS,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkBzB"}

package/dist/pieces/image.js

@@ -0,0 +1,24 @@
+/**
+ * Build a schema.org ImageObject piece. Pass `pageUrl` for a page's
+ * primary image (id = `${pageUrl}#primaryimage`), or `id` for a site-
+ * wide image like a personal logo.
+ */
+export function buildImageObject(input, ids) {
+    const id = input.id ?? (input.pageUrl !== undefined ? ids.primaryImage(input.pageUrl) : undefined);
+    if (id === undefined) {
+        throw new Error('buildImageObject: either `id` or `pageUrl` is required');
+    }
+    const piece = {
+        '@type': 'ImageObject',
+        '@id': id,
+        url: input.url,
+        contentUrl: input.url,
+        width: input.width,
+        height: input.height,
+    };
+    if (input.caption !== undefined)
+        piece.caption = input.caption;
+    piece.inLanguage = input.inLanguage ?? 'en-US';
+    return { ...piece, ...input.extra };
+}
+//# sourceMappingURL=image.js.map

package/dist/pieces/image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.js","sourceRoot":"","sources":["../../src/pieces/image.ts"],"names":[],"mappings":"AAoBA;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC5B,KAAuB,EACvB,GAAc;IAEd,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACnG,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,KAAK,GAA4B;QACnC,OAAO,EAAE,aAAa;QACtB,KAAK,EAAE,EAAE;QACT,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,UAAU,EAAE,KAAK,CAAC,GAAG;QACrB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,KAAK,CAAC,MAAM;KACvB,CAAC;IACF,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;QAAE,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC/D,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,OAAO,CAAC;IAE/C,OAAO,EAAE,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;AACxC,CAAC"}

package/dist/pieces/navigation.d.ts

@@ -0,0 +1,20 @@
+import type { IdFactory } from '../ids.js';
+import type { Reference } from '../types.js';
+export interface NavigationItem {
+    name: string;
+    url: string;
+}
+export interface SiteNavigationInput {
+    /** Human-readable nav name, e.g. 'Main navigation'. */
+    name: string;
+    /** Parent WebSite reference (usually ids.website). */
+    isPartOf: Reference;
+    items: readonly NavigationItem[];
+    extra?: Record<string, unknown>;
+}
+/**
+ * Build a schema.org SiteNavigationElement whose `hasPart` is a list of
+ * sub-SiteNavigationElement entries (one per nav link).
+ */
+export declare function buildSiteNavigationElement(input: SiteNavigationInput, ids: IdFactory): Record<string, unknown>;
+//# sourceMappingURL=navigation.d.ts.map

package/dist/pieces/navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/pieces/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAChC,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,QAAQ,EAAE,SAAS,CAAC;IACpB,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACtC,KAAK,EAAE,mBAAmB,EAC1B,GAAG,EAAE,SAAS,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAczB"}

package/dist/pieces/navigation.js

@@ -0,0 +1,20 @@
+/**
+ * Build a schema.org SiteNavigationElement whose `hasPart` is a list of
+ * sub-SiteNavigationElement entries (one per nav link).
+ */
+export function buildSiteNavigationElement(input, ids) {
+    const hasPart = input.items.map((item) => ({
+        '@type': 'SiteNavigationElement',
+        name: item.name,
+        url: item.url,
+    }));
+    return {
+        '@type': 'SiteNavigationElement',
+        '@id': ids.navigation,
+        name: input.name,
+        isPartOf: input.isPartOf,
+        hasPart,
+        ...input.extra,
+    };
+}
+//# sourceMappingURL=navigation.js.map

package/dist/pieces/navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.js","sourceRoot":"","sources":["../../src/pieces/navigation.ts"],"names":[],"mappings":"AAiBA;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACtC,KAA0B,EAC1B,GAAc;IAEd,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACvC,OAAO,EAAE,uBAAuB;QAChC,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,GAAG,EAAE,IAAI,CAAC,GAAG;KAChB,CAAC,CAAC,CAAC;IACJ,OAAO;QACH,OAAO,EAAE,uBAAuB;QAChC,KAAK,EAAE,GAAG,CAAC,UAAU;QACrB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO;QACP,GAAG,KAAK,CAAC,KAAK;KACjB,CAAC;AACN,CAAC"}

package/dist/pieces/organization.d.ts

@@ -0,0 +1,33 @@
+import type { IdFactory } from '../ids.js';
+export interface OrganizationInput {
+    /** Stable slug used for the @id. */
+    slug: string;
+    name: string;
+    url?: string;
+    description?: string;
+    /** Logo URL (raw string) or reference to an ImageObject. */
+    logo?: string | {
+        '@id': string;
+    };
+    sameAs?: readonly string[];
+    /** Escape hatch for schema.org properties specific to a subtype. */
+    extra?: Record<string, unknown>;
+}
+/**
+ * Build a schema.org Organization piece, or any of its subtypes. Pass the
+ * concrete @type as the third argument to set the subtype:
+ *
+ * ```ts
+ * import type { Hotel } from 'schema-dts';
+ * const hotel = buildOrganization<Hotel>(
+ *   { slug: 'la-limonaia', name: 'La Limonaia', extra: { checkinTime: '16:00' } },
+ *   ids,
+ *   'Hotel',
+ * );
+ * ```
+ *
+ * The generic type parameter is advisory — it flows schema-dts autocomplete
+ * into the `extra` field at call sites when you give it a concrete subtype.
+ */
+export declare function buildOrganization(input: OrganizationInput, ids: IdFactory, subtype?: string): Record<string, unknown>;
+//# sourceMappingURL=organization.d.ts.map

package/dist/pieces/organization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"organization.d.ts","sourceRoot":"","sources":["../../src/pieces/organization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,MAAM,WAAW,iBAAiB;IAC9B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAClC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAC7B,KAAK,EAAE,iBAAiB,EACxB,GAAG,EAAE,SAAS,EACd,OAAO,GAAE,MAAuB,GACjC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWzB"}

package/dist/pieces/organization.js

@@ -0,0 +1,33 @@
+/**
+ * Build a schema.org Organization piece, or any of its subtypes. Pass the
+ * concrete @type as the third argument to set the subtype:
+ *
+ * ```ts
+ * import type { Hotel } from 'schema-dts';
+ * const hotel = buildOrganization<Hotel>(
+ *   { slug: 'la-limonaia', name: 'La Limonaia', extra: { checkinTime: '16:00' } },
+ *   ids,
+ *   'Hotel',
+ * );
+ * ```
+ *
+ * The generic type parameter is advisory — it flows schema-dts autocomplete
+ * into the `extra` field at call sites when you give it a concrete subtype.
+ */
+export function buildOrganization(input, ids, subtype = 'Organization') {
+    const piece = {
+        '@type': subtype,
+        '@id': ids.organization(input.slug),
+        name: input.name,
+    };
+    if (input.url !== undefined)
+        piece.url = input.url;
+    if (input.description !== undefined)
+        piece.description = input.description;
+    if (input.logo !== undefined)
+        piece.logo = input.logo;
+    if (input.sameAs !== undefined)
+        piece.sameAs = input.sameAs;
+    return { ...piece, ...input.extra };
+}
+//# sourceMappingURL=organization.js.map

package/dist/pieces/organization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"organization.js","sourceRoot":"","sources":["../../src/pieces/organization.ts"],"names":[],"mappings":"AAeA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,iBAAiB,CAC7B,KAAwB,EACxB,GAAc,EACd,UAAkB,cAAc;IAEhC,MAAM,KAAK,GAA4B;QACnC,OAAO,EAAE,OAAO;QAChB,KAAK,EAAE,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC;QACnC,IAAI,EAAE,KAAK,CAAC,IAAI;KACnB,CAAC;IACF,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS;QAAE,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;IACnD,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;QAAE,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IAC3E,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACtD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;QAAE,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5D,OAAO,EAAE,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;AACxC,CAAC"}

package/dist/pieces/person.d.ts

@@ -0,0 +1,36 @@
+import type { IdFactory } from '../ids.js';
+/**
+ * Input for a Person piece. All fields except `name` are optional, and
+ * any field not explicitly supported here can be passed via `extra`.
+ *
+ * This intentionally mirrors schema.org's Person vocabulary. We don't
+ * re-type every field; the shape is a `Record<string, unknown>` so
+ * consumers can pass arbitrary schema.org properties without a version
+ * upgrade of this package.
+ */
+export interface PersonInput {
+    name: string;
+    familyName?: string;
+    birthDate?: string;
+    gender?: string;
+    nationality?: {
+        '@id': string;
+    };
+    description?: string;
+    jobTitle?: string;
+    knowsLanguage?: readonly string[];
+    url?: string;
+    image?: {
+        '@id': string;
+    };
+    sameAs?: readonly string[];
+    worksFor?: ReadonlyArray<Record<string, unknown>>;
+    spouse?: Record<string, unknown>;
+    children?: ReadonlyArray<Record<string, unknown>>;
+    extra?: Record<string, unknown>;
+}
+/**
+ * Build a schema.org Person piece using the site-wide Person @id.
+ */
+export declare function buildPerson(input: PersonInput, ids: IdFactory): Record<string, unknown>;
+//# sourceMappingURL=person.d.ts.map

package/dist/pieces/person.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"person.d.ts","sourceRoot":"","sources":["../../src/pieces/person.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQvF"}

package/dist/pieces/person.js

@@ -0,0 +1,13 @@
+/**
+ * Build a schema.org Person piece using the site-wide Person @id.
+ */
+export function buildPerson(input, ids) {
+    const { extra, ...rest } = input;
+    return {
+        '@type': 'Person',
+        '@id': ids.person,
+        ...rest,
+        ...extra,
+    };
+}
+//# sourceMappingURL=person.js.map

package/dist/pieces/person.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"person.js","sourceRoot":"","sources":["../../src/pieces/person.ts"],"names":[],"mappings":"AA6BA;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAkB,EAAE,GAAc;IAC1D,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IACjC,OAAO;QACH,OAAO,EAAE,QAAQ;QACjB,KAAK,EAAE,GAAG,CAAC,MAAM;QACjB,GAAG,IAAI;QACP,GAAG,KAAK;KACX,CAAC;AACN,CAAC"}

package/dist/pieces/video.d.ts

@@ -0,0 +1,35 @@
+import type { IdFactory } from '../ids.js';
+import type { Reference } from '../types.js';
+export interface VideoObjectInput {
+    /**
+     * Canonical URL of the page the video lives on. The @id is
+     * `${url}#video`.
+     */
+    url: string;
+    name: string;
+    description: string;
+    /** Reference to the enclosing WebPage (usually ids.webPage(url)). */
+    isPartOf: Reference;
+    /** YouTube video id — used to derive thumbnailUrl and embedUrl. */
+    youtubeId?: string;
+    /**
+     * Explicit thumbnail URL. If omitted and `youtubeId` is set, defaults
+     * to `https://img.youtube.com/vi/{id}/maxresdefault.jpg`.
+     */
+    thumbnailUrl?: string;
+    /**
+     * Explicit embed URL. If omitted and `youtubeId` is set, defaults to
+     * `https://www.youtube-nocookie.com/embed/{id}`.
+     */
+    embedUrl?: string;
+    uploadDate?: Date;
+    /** ISO 8601 duration, e.g. 'PT30M'. */
+    duration?: string;
+    transcript?: string;
+    extra?: Record<string, unknown>;
+}
+/**
+ * Build a schema.org VideoObject piece.
+ */
+export declare function buildVideoObject(input: VideoObjectInput, ids: IdFactory): Record<string, unknown>;
+//# sourceMappingURL=video.d.ts.map

package/dist/pieces/video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.d.ts","sourceRoot":"","sources":["../../src/pieces/video.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC7B;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,QAAQ,EAAE,SAAS,CAAC;IACpB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,IAAI,CAAC;IAClB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC5B,KAAK,EAAE,gBAAgB,EACvB,GAAG,EAAE,SAAS,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA4BzB"}

package/dist/pieces/video.js

@@ -0,0 +1,32 @@
+/**
+ * Build a schema.org VideoObject piece.
+ */
+export function buildVideoObject(input, ids) {
+    const piece = {
+        '@type': 'VideoObject',
+        '@id': ids.videoObject(input.url),
+        name: input.name,
+        description: input.description,
+        isPartOf: input.isPartOf,
+    };
+    const thumbnail = input.thumbnailUrl ??
+        (input.youtubeId !== undefined
+            ? `https://img.youtube.com/vi/${input.youtubeId}/maxresdefault.jpg`
+            : undefined);
+    if (thumbnail !== undefined)
+        piece.thumbnailUrl = thumbnail;
+    const embed = input.embedUrl ??
+        (input.youtubeId !== undefined
+            ? `https://www.youtube-nocookie.com/embed/${input.youtubeId}`
+            : undefined);
+    if (embed !== undefined)
+        piece.embedUrl = embed;
+    if (input.uploadDate !== undefined)
+        piece.uploadDate = input.uploadDate.toISOString();
+    if (input.duration !== undefined)
+        piece.duration = input.duration;
+    if (input.transcript !== undefined)
+        piece.transcript = input.transcript;
+    return { ...piece, ...input.extra };
+}
+//# sourceMappingURL=video.js.map

package/dist/pieces/video.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.js","sourceRoot":"","sources":["../../src/pieces/video.ts"],"names":[],"mappings":"AAgCA;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC5B,KAAuB,EACvB,GAAc;IAEd,MAAM,KAAK,GAA4B;QACnC,OAAO,EAAE,aAAa;QACtB,KAAK,EAAE,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC;QACjC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;KAC3B,CAAC;IAEF,MAAM,SAAS,GACX,KAAK,CAAC,YAAY;QAClB,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS;YAC1B,CAAC,CAAC,8BAA8B,KAAK,CAAC,SAAS,oBAAoB;YACnE,CAAC,CAAC,SAAS,CAAC,CAAC;IACrB,IAAI,SAAS,KAAK,SAAS;QAAE,KAAK,CAAC,YAAY,GAAG,SAAS,CAAC;IAE5D,MAAM,KAAK,GACP,KAAK,CAAC,QAAQ;QACd,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS;YAC1B,CAAC,CAAC,0CAA0C,KAAK,CAAC,SAAS,EAAE;YAC7D,CAAC,CAAC,SAAS,CAAC,CAAC;IACrB,IAAI,KAAK,KAAK,SAAS;QAAE,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC;IAEhD,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;QAAE,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;IACtF,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;QAAE,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IAClE,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;QAAE,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IAExE,OAAO,EAAE,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;AACxC,CAAC"}

package/dist/pieces/webpage.d.ts

@@ -0,0 +1,45 @@
+import type { IdFactory } from '../ids.js';
+import type { Reference } from '../types.js';
+/**
+ * Concrete WebPage subtype. `WebPage` is the default; use `ProfilePage`
+ * for /about-me style pages and `CollectionPage` for index/listing pages.
+ */
+export type WebPageType = 'WebPage' | 'ProfilePage' | 'CollectionPage';
+export interface WebPageInput {
+    /** Canonical URL of the page. The WebPage @id equals this URL. */
+    url: string;
+    /** Page title (becomes `name`). */
+    name: string;
+    /** Reference to the site-wide WebSite (usually ids.website). */
+    isPartOf: Reference;
+    /** Reference to the BreadcrumbList for this page (usually ids.breadcrumb(url)). */
+    breadcrumb: Reference;
+    inLanguage?: string;
+    /** Publish date — emitted as ISO string. */
+    datePublished?: Date;
+    /** Update date — emitted as ISO string. */
+    dateModified?: Date;
+    /** Reference to the primary ImageObject, if any. */
+    primaryImage?: Reference;
+    /**
+     * Reference to the entity this page is "about" — used for ProfilePage
+     * (the Person) and homepage variants.
+     */
+    about?: Reference;
+    /**
+     * Custom potentialAction. If omitted, defaults to a single ReadAction
+     * targeting the page URL.
+     */
+    potentialAction?: ReadonlyArray<Record<string, unknown>>;
+    extra?: Record<string, unknown>;
+}
+/**
+ * Build a schema.org WebPage (or ProfilePage / CollectionPage) piece.
+ *
+ * Choose the concrete subtype via the second argument; defaults to
+ * `WebPage`. Dispatch (e.g. "blog listing pages use CollectionPage")
+ * is a caller concern, not a core concern — core ships the primitives
+ * and lets the caller decide.
+ */
+export declare function buildWebPage(input: WebPageInput, ids: IdFactory, type?: WebPageType): Record<string, unknown>;
+//# sourceMappingURL=webpage.d.ts.map

package/dist/pieces/webpage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webpage.d.ts","sourceRoot":"","sources":["../../src/pieces/webpage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,aAAa,GAAG,gBAAgB,CAAC;AAEvE,MAAM,WAAW,YAAY;IACzB,kEAAkE;IAClE,GAAG,EAAE,MAAM,CAAC;IACZ,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,QAAQ,EAAE,SAAS,CAAC;IACpB,mFAAmF;IACnF,UAAU,EAAE,SAAS,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,IAAI,CAAC;IACrB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,oDAAoD;IACpD,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;OAGG;IACH,eAAe,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CACxB,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,SAAS,EACd,IAAI,GAAE,WAAuB,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8BzB"}

package/dist/pieces/webpage.js

@@ -0,0 +1,37 @@
+/**
+ * Build a schema.org WebPage (or ProfilePage / CollectionPage) piece.
+ *
+ * Choose the concrete subtype via the second argument; defaults to
+ * `WebPage`. Dispatch (e.g. "blog listing pages use CollectionPage")
+ * is a caller concern, not a core concern — core ships the primitives
+ * and lets the caller decide.
+ */
+export function buildWebPage(input, ids, type = 'WebPage') {
+    const potentialAction = input.potentialAction ?? [
+        { '@type': 'ReadAction', target: [input.url] },
+    ];
+    const piece = {
+        '@type': type,
+        '@id': ids.webPage(input.url),
+        url: input.url,
+        name: input.name,
+        isPartOf: input.isPartOf,
+        breadcrumb: input.breadcrumb,
+        inLanguage: input.inLanguage ?? 'en-US',
+        potentialAction,
+    };
+    if (input.datePublished !== undefined) {
+        piece.datePublished = input.datePublished.toISOString();
+    }
+    if (input.dateModified !== undefined) {
+        piece.dateModified = input.dateModified.toISOString();
+    }
+    if (input.primaryImage !== undefined) {
+        piece.primaryImageOfPage = input.primaryImage;
+    }
+    if (input.about !== undefined) {
+        piece.about = input.about;
+    }
+    return { ...piece, ...input.extra };
+}
+//# sourceMappingURL=webpage.js.map

package/dist/pieces/webpage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webpage.js","sourceRoot":"","sources":["../../src/pieces/webpage.ts"],"names":[],"mappings":"AAsCA;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CACxB,KAAmB,EACnB,GAAc,EACd,OAAoB,SAAS;IAE7B,MAAM,eAAe,GAA2C,KAAK,CAAC,eAAe,IAAI;QACrF,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;KACjD,CAAC;IAEF,MAAM,KAAK,GAA4B;QACnC,OAAO,EAAE,IAAI;QACb,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC;QAC7B,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,OAAO;QACvC,eAAe;KAClB,CAAC;IAEF,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACpC,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC;IAC5D,CAAC;IACD,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACnC,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;IAC1D,CAAC;IACD,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACnC,KAAK,CAAC,kBAAkB,GAAG,KAAK,CAAC,YAAY,CAAC;IAClD,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC5B,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC9B,CAAC;IAED,OAAO,EAAE,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;AACxC,CAAC"}

package/dist/pieces/website.d.ts

@@ -0,0 +1,22 @@
+import type { IdFactory } from '../ids.js';
+import type { Reference } from '../types.js';
+export interface WebSiteInput {
+    /** Site URL, typically with trailing slash. */
+    url: string;
+    name: string;
+    description?: string;
+    /** Publisher entity — usually the site-wide Person or Organization. */
+    publisher: Reference;
+    /** Default content language, e.g. 'en-US'. */
+    inLanguage?: string;
+    /** Optional navigation reference (e.g. ids.navigation). */
+    hasPart?: Reference;
+    /** Escape hatch for extra schema.org properties. */
+    extra?: Record<string, unknown>;
+}
+/**
+ * Build a schema.org WebSite piece. This is the site-wide singleton;
+ * every page's WebPage should reference it via `isPartOf`.
+ */
+export declare function buildWebSite(input: WebSiteInput, ids: IdFactory): Record<string, unknown>;
+//# sourceMappingURL=website.d.ts.map

package/dist/pieces/website.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"website.d.ts","sourceRoot":"","sources":["../../src/pieces/website.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,YAAY;IACzB,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,SAAS,EAAE,SAAS,CAAC;IACrB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzF"}

package/dist/pieces/website.js

@@ -0,0 +1,20 @@
+/**
+ * Build a schema.org WebSite piece. This is the site-wide singleton;
+ * every page's WebPage should reference it via `isPartOf`.
+ */
+export function buildWebSite(input, ids) {
+    const piece = {
+        '@type': 'WebSite',
+        '@id': ids.website,
+        url: input.url,
+        name: input.name,
+    };
+    if (input.description !== undefined)
+        piece.description = input.description;
+    piece.publisher = input.publisher;
+    piece.inLanguage = input.inLanguage ?? 'en-US';
+    if (input.hasPart !== undefined)
+        piece.hasPart = input.hasPart;
+    return { ...piece, ...input.extra };
+}
+//# sourceMappingURL=website.js.map

package/dist/pieces/website.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"website.js","sourceRoot":"","sources":["../../src/pieces/website.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAmB,EAAE,GAAc;IAC5D,MAAM,KAAK,GAA4B;QACnC,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,GAAG,CAAC,OAAO;QAClB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,IAAI,EAAE,KAAK,CAAC,IAAI;KACnB,CAAC;IACF,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;QAAE,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IAC3E,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IAClC,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,OAAO,CAAC;IAC/C,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;QAAE,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC/D,OAAO,EAAE,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;AACxC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,30 @@
+import type { Thing, WithContext } from 'schema-dts';
+/**
+ * A reference to another entity in the @graph, by its @id.
+ *
+ * Most schema.org entities link to each other via `{ '@id': string }`.
+ * Some consumers (notably joost.blog's Article.author) include the `name`
+ * alongside the id, which is redundant but valid schema.org. The optional
+ * `name` field lets callers opt into that pattern.
+ */
+export interface Reference {
+    '@id': string;
+    name?: string;
+}
+/**
+ * The assembled @graph produced by `assembleGraph`.
+ */
+export type SchemaGraph<T extends Thing = Thing> = WithContext<Thing> & {
+    '@context': 'https://schema.org';
+    '@graph': T[];
+};
+/**
+ * A single entity in the graph, as returned by a piece builder.
+ * All entities should carry an `@id` so they can be cross-referenced.
+ */
+export interface GraphEntity {
+    '@type': string | readonly string[];
+    '@id'?: string;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAErD;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,IAAI,WAAW,CAAC,KAAK,CAAC,GAAG;IACpE,UAAU,EAAE,oBAAoB,CAAC;IACjC,QAAQ,EAAE,CAAC,EAAE,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@jdevalk/seo-graph-core",
+  "version": "0.1.0-alpha.0",
+  "description": "Pure schema.org JSON-LD graph builders. Runtime-agnostic core for agent-ready SEO.",
+  "keywords": [
+    "schema.org",
+    "json-ld",
+    "seo",
+    "agent-ready",
+    "structured-data"
+  ],
+  "author": "Joost de Valk <joost@joost.blog>",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jdevalk/seo-graph.git",
+    "directory": "packages/seo-graph-core"
+  },
+  "bugs": "https://github.com/jdevalk/seo-graph/issues",
+  "homepage": "https://github.com/jdevalk/seo-graph/tree/main/packages/seo-graph-core#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "schema-dts": "^2.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json",
+    "test": "vitest run"
+  }
+}