@krantho/seo 0.0.0-stage → 1.0.0

package/dist/graph/index.d.ts

@@ -0,0 +1,9 @@
+export type { ComposeFromConfigOptions, DocumentMeta, ResolvedEntity, ResolvedPropertyView, } from './compose-from-config.js';
+export { composeFromConfig, resolvePageEntities } from './compose-from-config.js';
+export type { ComposeGraphOptions } from './compose-graph.js';
+export { composeGraph } from './compose-graph.js';
+export type { ConfigScope, EffectiveSeoConfig, EffectiveSeoEntity, SeoConfigChain, } from './effective-config.js';
+export { resolveEffectiveConfig } from './effective-config.js';
+export type { JsonLdGraph, SchemaEntity, SeoGraphConfig } from './types.js';
+export type { ValueScope } from './value-scope.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/graph/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/graph/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,wBAAwB,EACxB,YAAY,EACZ,cAAc,EACd,oBAAoB,GACrB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AACjF,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,GACf,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3E,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/graph/index.js

@@ -0,0 +1,4 @@
+export { composeFromConfig, resolvePageEntities } from './compose-from-config.js';
+export { composeGraph } from './compose-graph.js';
+export { resolveEffectiveConfig } from './effective-config.js';
+//# sourceMappingURL=index.js.map

package/dist/graph/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/graph/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAOjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/graph/resolve-properties.d.ts

@@ -0,0 +1,36 @@
+import type { EntityLevel, ResolvedProperty, TypeDefinition } from '../types/definition.js';
+import type { SeoGraphConfig } from './types.js';
+/** Values computed from the page and its version history, with how each is computed */
+export interface ComputedValues {
+    readonly url?: string | undefined;
+    readonly mainEntityOfPage?: string | undefined;
+    readonly datePublished?: string | undefined;
+    readonly dateModified?: string | undefined;
+    readonly inLanguage?: string | undefined;
+}
+/** What the properties of one entity are resolved from */
+export interface PropertyInputs {
+    readonly type: string;
+    readonly level: EntityLevel;
+    readonly definition?: TypeDefinition | undefined;
+    /** Values an editor or developer set on the entity in the SEO configuration */
+    readonly configured: Readonly<Record<string, unknown>>;
+    /** The document's content fields; empty for site entities */
+    readonly fields: Readonly<Record<string, unknown>>;
+    /** Schema.org property (or `Type.property`) → content field */
+    readonly fieldMappings?: Readonly<Record<string, string>> | undefined;
+    readonly computed: ComputedValues;
+    readonly site: SeoGraphConfig;
+}
+/** A site setting entities take values from */
+export type SiteKey = Exclude<keyof SeoGraphConfig, 'domain'>;
+/** The site setting a site entity of the type takes the property's value from, if any */
+export declare function siteSettingFor(type: string, property: string): SiteKey | undefined;
+/**
+ * Resolve the value of every property an entity may carry, each from one
+ * source in a fixed order: the SEO settings (an editor's or developer's
+ * entry) › a content field › a value computed from the page › the site
+ * configuration. Properties with no value anywhere are absent.
+ */
+export declare function resolveProperties(inputs: PropertyInputs): Map<string, ResolvedProperty>;
+//# sourceMappingURL=resolve-properties.d.ts.map

package/dist/graph/resolve-properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-properties.d.ts","sourceRoot":"","sources":["../../src/graph/resolve-properties.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAG3F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAiBhD,uFAAuF;AACvF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACzC;AAUD,0DAA0D;AAC1D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,cAAc,GAAG,SAAS,CAAA;IAChD,+EAA+E;IAC/E,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACtD,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAClD,+DAA+D;IAC/D,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAA;IACrE,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAA;IACjC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;CAC9B;AAED,+CAA+C;AAC/C,MAAM,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,cAAc,EAAE,QAAQ,CAAC,CAAA;AAgC7D,yFAAyF;AACzF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAElF;AAyED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CASvF"}

package/dist/graph/resolve-properties.js

@@ -0,0 +1,141 @@
+import { DEFAULT_AUTO_MAPPINGS } from '../catalog/auto-mappings.js';
+import { getTypeProperties } from '../catalog/properties.js';
+import { isEmpty } from '../types/values.js';
+import { isSubtypeOf } from '../vocabulary/index.js';
+/** Thing and CreativeWork properties — what a type the catalog does not list may carry */
+const CORE_PROPERTIES = [
+    'name',
+    'alternateName',
+    'description',
+    'image',
+    'sameAs',
+    'identifier',
+    'headline',
+    'author',
+    'publisher',
+    'keywords',
+    'about',
+];
+const COMPUTED_ORIGIN = {
+    url: "the page's path",
+    mainEntityOfPage: "the page's path",
+    datePublished: "the document's first version",
+    dateModified: "the document's latest version",
+    inLanguage: "the document's locale",
+};
+const ORGANIZATION_IDENTITY = {
+    name: 'name',
+    url: 'baseUrl',
+    logo: 'logo',
+    description: 'description',
+    alternateName: 'alternateName',
+    sameAs: 'sameAs',
+};
+const WEBSITE_IDENTITY = {
+    name: 'name',
+    url: 'baseUrl',
+    inLanguage: 'language',
+    alternateName: 'alternateName',
+};
+const PERSON_IDENTITY = { name: 'name', url: 'baseUrl' };
+const PAGE_IDENTITY = { inLanguage: 'language' };
+/**
+ * Which site settings an entity takes its values from: a site entity its
+ * identity; a document entity, which describes the page's subject, only the
+ * site's language.
+ */
+function siteIdentity(type, level) {
+    if (level === 'document')
+        return PAGE_IDENTITY;
+    if (isSubtypeOf(type, 'Organization'))
+        return ORGANIZATION_IDENTITY;
+    if (isSubtypeOf(type, 'WebSite'))
+        return WEBSITE_IDENTITY;
+    if (isSubtypeOf(type, 'Person'))
+        return PERSON_IDENTITY;
+    return PAGE_IDENTITY;
+}
+/** The site setting a site entity of the type takes the property's value from, if any */
+export function siteSettingFor(type, property) {
+    return siteIdentity(type, 'site')[property];
+}
+/** Every property a value is resolved for */
+function candidates(inputs, catalog) {
+    const { type, definition } = inputs;
+    const listed = catalog.map((def) => def.property);
+    const mapped = Object.keys(inputs.fieldMappings ?? {})
+        .filter((key) => !key.includes('.') || key.startsWith(`${type}.`))
+        .map((key) => key.slice(key.indexOf('.') + 1));
+    return new Set([
+        ...(listed.length > 0 || definition ? listed : CORE_PROPERTIES),
+        ...Object.keys(definition?.fields ?? {}),
+        ...Object.keys(inputs.configured).filter((key) => !key.startsWith('@')),
+        ...mapped,
+        ...Object.keys(siteIdentity(type, inputs.level)),
+        ...(inputs.level === 'document' ? Object.keys(COMPUTED_ORIGIN) : []),
+    ]);
+}
+/** Whether a field named after the property competes in the default auto-mappings */
+function competesByName(property) {
+    return DEFAULT_AUTO_MAPPINGS.some((m) => m.cmsField === property && m.schemaProperty === property);
+}
+/**
+ * Content fields that may hold the property's value, most specific first:
+ * explicit mappings, a field named after the property (unless it competes in
+ * the default mappings), the definition's alternate fields, then — for an
+ * entity describing the page — the default mappings by priority and the
+ * catalog's field. A site entity takes no default mapping: a page's title is
+ * not the organization's name.
+ */
+function contentFields(property, inputs, def) {
+    const mappings = inputs.fieldMappings ?? {};
+    const fields = [mappings[`${inputs.type}.${property}`], mappings[property]];
+    if (!competesByName(property))
+        fields.push(property);
+    fields.push(...(inputs.definition?.fields?.[property] ?? []));
+    if (inputs.level === 'document') {
+        const defaults = DEFAULT_AUTO_MAPPINGS.filter((m) => m.schemaProperty === property);
+        fields.push(...[...defaults].sort((a, b) => b.priority - a.priority).map((m) => m.cmsField));
+        fields.push(def?.autoMapField);
+    }
+    return fields.filter((field) => field !== undefined);
+}
+function resolveOne(property, inputs, def) {
+    const configured = inputs.configured[property];
+    if (!isEmpty(configured))
+        return { value: configured, source: 'manual', origin: 'the SEO settings' };
+    for (const field of contentFields(property, inputs, def)) {
+        const value = inputs.fields[field];
+        if (!isEmpty(value))
+            return { value, source: 'auto', origin: `the content field "${field}"` };
+    }
+    if (inputs.level === 'document' && property in COMPUTED_ORIGIN) {
+        const key = property;
+        const value = inputs.computed[key];
+        if (!isEmpty(value))
+            return { value, source: 'computed', origin: COMPUTED_ORIGIN[key] };
+    }
+    const setting = siteIdentity(inputs.type, inputs.level)[property];
+    if (setting && !isEmpty(inputs.site[setting])) {
+        return { value: inputs.site[setting], source: 'site', origin: `site.${setting}` };
+    }
+    return undefined;
+}
+/**
+ * Resolve the value of every property an entity may carry, each from one
+ * source in a fixed order: the SEO settings (an editor's or developer's
+ * entry) › a content field › a value computed from the page › the site
+ * configuration. Properties with no value anywhere are absent.
+ */
+export function resolveProperties(inputs) {
+    const catalog = getTypeProperties(inputs.type);
+    const resolved = new Map();
+    for (const property of candidates(inputs, catalog)) {
+        const def = catalog.find((d) => d.property === property);
+        const value = resolveOne(property, inputs, def);
+        if (value)
+            resolved.set(property, value);
+    }
+    return resolved;
+}
+//# sourceMappingURL=resolve-properties.js.map

package/dist/graph/resolve-properties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-properties.js","sourceRoot":"","sources":["../../src/graph/resolve-properties.ts"],"names":[],"mappings":"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"}

package/dist/graph/resolve-references.d.ts

@@ -0,0 +1,14 @@
+import type { Finding } from '../validate/types.js';
+import type { ComposedNode } from './build-entity.js';
+import type { SchemaEntity } from './types.js';
+/** Receives what composing a graph changed or could not do */
+export type FindingSink = (finding: Finding) => void;
+/**
+ * Make every reference a type definition emits resolve within the graph: a
+ * reference whose target is missing points at a site entity of an acceptable
+ * type (`site-entity`), or is removed with a finding when the rule says
+ * `omit` or nothing fits. References in configured values are left as they
+ * are — validation reports them.
+ */
+export declare function resolveReferences(nodes: readonly ComposedNode[], onFinding?: FindingSink | undefined): SchemaEntity[];
+//# sourceMappingURL=resolve-references.d.ts.map

package/dist/graph/resolve-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-references.d.ts","sourceRoot":"","sources":["../../src/graph/resolve-references.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAEnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,8DAA8D;AAC9D,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;AA2CpD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,SAAS,CAAC,EAAE,WAAW,GAAG,SAAS,GAClC,YAAY,EAAE,CAGhB"}

package/dist/graph/resolve-references.js

@@ -0,0 +1,49 @@
+import { ref } from '../types/values.js';
+import { idOf, isReference, typesOf } from '../validate/graph-nodes.js';
+import { isSubtypeOf } from '../vocabulary/index.js';
+/** The first site entity of an acceptable type, in the rule's order of preference */
+function siteEntityFor(rule, nodes) {
+    for (const type of rule.types) {
+        const match = nodes.find((node) => node.level === 'site' && typesOf(node.entity).some((t) => isSubtypeOf(t, type)));
+        const id = match ? idOf(match.entity) : undefined;
+        if (id)
+            return id;
+    }
+    return undefined;
+}
+function resolveNode(node, nodes, defined, onFinding) {
+    const entity = { ...node.entity };
+    for (const [property, rule] of Object.entries(node.references)) {
+        const value = entity[property];
+        if (!isReference(value) || defined.has(idOf(value) ?? ''))
+            continue;
+        const target = rule.resolve === 'site-entity' ? siteEntityFor(rule, nodes) : undefined;
+        if (target) {
+            entity[property] = ref(target);
+            continue;
+        }
+        delete entity[property];
+        onFinding?.({
+            severity: 'warning',
+            code: 'unresolved-reference',
+            profile: 'schema.org',
+            nodeId: entity['@id'],
+            type: entity['@type'],
+            property,
+            message: `"${property}" is left out: the site configures no ${rule.types.join(' or ')}.`,
+        });
+    }
+    return entity;
+}
+/**
+ * Make every reference a type definition emits resolve within the graph: a
+ * reference whose target is missing points at a site entity of an acceptable
+ * type (`site-entity`), or is removed with a finding when the rule says
+ * `omit` or nothing fits. References in configured values are left as they
+ * are — validation reports them.
+ */
+export function resolveReferences(nodes, onFinding) {
+    const defined = new Set(nodes.map((node) => idOf(node.entity)).filter((id) => id !== undefined));
+    return nodes.map((node) => resolveNode(node, nodes, defined, onFinding));
+}
+//# sourceMappingURL=resolve-references.js.map

package/dist/graph/resolve-references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-references.js","sourceRoot":"","sources":["../../src/graph/resolve-references.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AAEvE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAOpD,qFAAqF;AACrF,SAAS,aAAa,CAAC,IAAmB,EAAE,KAA8B;IACxE,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CACtB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAC1F,CAAA;QACD,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QACjD,IAAI,EAAE;YAAE,OAAO,EAAE,CAAA;IACnB,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,SAAS,WAAW,CAClB,IAAkB,EAClB,KAA8B,EAC9B,OAA4B,EAC5B,SAAkC;IAElC,MAAM,MAAM,GAAiB,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAA;IAC/C,KAAK,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/D,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;QAC9B,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAAE,SAAQ;QACnE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,KAAK,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QACtF,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAA;YAC9B,SAAQ;QACV,CAAC;QACD,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAA;QACvB,SAAS,EAAE,CAAC;YACV,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,sBAAsB;YAC5B,OAAO,EAAE,YAAY;YACrB,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC;YACrB,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC;YACrB,QAAQ;YACR,OAAO,EAAE,IAAI,QAAQ,yCAAyC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG;SACzF,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAA8B,EAC9B,SAAmC;IAEnC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAA;IAChG,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAA;AAC1E,CAAC"}

package/dist/graph/typed-value.d.ts

@@ -0,0 +1,7 @@
+/**
+ * A content or configuration value with a `@type` on every node given without
+ * one — `offers: { price: '10' }` becomes an Offer — so a nested node is never
+ * untyped when its property says what it is.
+ */
+export declare function typedValue(property: string, value: unknown): unknown;
+//# sourceMappingURL=typed-value.d.ts.map

package/dist/graph/typed-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-value.d.ts","sourceRoot":"","sources":["../../src/graph/typed-value.ts"],"names":[],"mappings":"AAmCA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAIpE"}

package/dist/graph/typed-value.js

@@ -0,0 +1,43 @@
+import { getVocabularyProperty, isDatatype, isEnumeration } from '../vocabulary/index.js';
+/**
+ * The type a node given without one takes, for properties whose range offers
+ * more than one class — the type search engines document for the property.
+ */
+const PREFERRED_VALUE_TYPES = {
+    offers: 'Offer',
+    author: 'Person',
+    creator: 'Person',
+    publisher: 'Organization',
+    provider: 'Organization',
+    organizer: 'Organization',
+    location: 'Place',
+    brand: 'Brand',
+    review: 'Review',
+};
+/** The single class the property's range admits, or its documented preference */
+function valueType(property) {
+    const preferred = PREFERRED_VALUE_TYPES[property];
+    if (preferred)
+        return preferred;
+    const classes = (getVocabularyProperty(property)?.range ?? []).filter((type) => !isDatatype(type) && !isEnumeration(type));
+    return classes.length === 1 ? classes[0] : undefined;
+}
+function typeNode(property, value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return value;
+    if ('@type' in value || '@id' in value || '@value' in value)
+        return value;
+    const type = valueType(property);
+    return type ? { '@type': type, ...value } : value;
+}
+/**
+ * A content or configuration value with a `@type` on every node given without
+ * one — `offers: { price: '10' }` becomes an Offer — so a nested node is never
+ * untyped when its property says what it is.
+ */
+export function typedValue(property, value) {
+    return Array.isArray(value)
+        ? value.map((item) => typeNode(property, item))
+        : typeNode(property, value);
+}
+//# sourceMappingURL=typed-value.js.map

package/dist/graph/typed-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-value.js","sourceRoot":"","sources":["../../src/graph/typed-value.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAEzF;;;GAGG;AACH,MAAM,qBAAqB,GAAqC;IAC9D,MAAM,EAAE,OAAO;IACf,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,QAAQ;IACjB,SAAS,EAAE,cAAc;IACzB,QAAQ,EAAE,cAAc;IACxB,SAAS,EAAE,cAAc;IACzB,QAAQ,EAAE,OAAO;IACjB,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;CACjB,CAAA;AAED,iFAAiF;AACjF,SAAS,SAAS,CAAC,QAAgB;IACjC,MAAM,SAAS,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAA;IACjD,IAAI,SAAS;QAAE,OAAO,SAAS,CAAA;IAC/B,MAAM,OAAO,GAAG,CAAC,qBAAqB,CAAC,QAAQ,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,CACnE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CACpD,CAAA;IACD,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AACtD,CAAC;AAED,SAAS,QAAQ,CAAC,QAAgB,EAAE,KAAc;IAChD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IACrF,IAAI,OAAO,IAAI,KAAK,IAAI,KAAK,IAAI,KAAK,IAAI,QAAQ,IAAI,KAAK;QAAE,OAAO,KAAK,CAAA;IACzE,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAA;IAChC,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAA;AACnD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,KAAc;IACzD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzB,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC/C,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;AAC/B,CAAC"}

package/dist/graph/types.d.ts

@@ -0,0 +1,34 @@
+/** A Schema.org entity with standard properties and an open index signature */
+export interface SchemaEntity {
+    '@type': string;
+    '@id'?: string | undefined;
+    name?: string | undefined;
+    description?: string | undefined;
+    url?: string | undefined;
+    [key: string]: unknown;
+}
+/** Site identity and address for SEO graph generation — the `site` section of the configuration */
+export interface SeoGraphConfig {
+    /** Domain name, e.g., 'acme-consulting.example.com' */
+    domain: string;
+    /** Site name, e.g., 'Acme Consulting' */
+    name: string;
+    /** Primary language, e.g., 'en' */
+    language: string;
+    /** Full base URL, e.g., 'https://acme-consulting.example.com' */
+    baseUrl: string;
+    /** The site's logo, an absolute URL */
+    logo?: string | undefined;
+    /** What the site or its organization is, in a sentence */
+    description?: string | undefined;
+    /** Another name the site or organization is known by */
+    alternateName?: string | undefined;
+    /** Profile pages that identify the organization (social, registry, code hosting) */
+    sameAs?: readonly string[] | undefined;
+}
+/** The composed JSON-LD graph output */
+export interface JsonLdGraph {
+    '@context': 'https://schema.org';
+    '@graph': SchemaEntity[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/graph/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/graph/types.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,mGAAmG;AACnG,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAA;IACd,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAA;IACZ,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAA;IAChB,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAA;IACf,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,oFAAoF;IACpF,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;CACvC;AAED,wCAAwC;AACxC,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,oBAAoB,CAAA;IAChC,QAAQ,EAAE,YAAY,EAAE,CAAA;CACzB"}

package/dist/graph/types.js

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

package/dist/graph/types.js.map

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

package/dist/graph/value-scope.d.ts

@@ -0,0 +1,19 @@
+import type { ResolvedProperty } from '../types/definition.js';
+import type { ConfigScope } from './effective-config.js';
+/**
+ * Where a value a page emits comes from, as an editor sees it: the site, the
+ * collection, a URL pattern or the document itself; computed by krantho from
+ * the page and its history; or linked — a reference to another entity
+ */
+export type ValueScope = 'site' | ConfigScope | 'computed' | 'linked';
+/**
+ * The scope of one resolved value. A value set in the SEO settings comes from
+ * the site settings on a site entity, and from the scope that set it on a
+ * document entity — the collection when the document has only its
+ * collection's (or the default) archetype.
+ */
+export declare function valueScope(resolved: ResolvedProperty, property: string, entity: {
+    fromSite: boolean;
+    scopes?: Readonly<Record<string, ConfigScope>> | undefined;
+}): ValueScope;
+//# sourceMappingURL=value-scope.d.ts.map

package/dist/graph/value-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-scope.d.ts","sourceRoot":"","sources":["../../src/graph/value-scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAA;AAarE;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,GAAG,SAAS,CAAA;CAAE,GACxF,UAAU,CAOZ"}

package/dist/graph/value-scope.js

@@ -0,0 +1,30 @@
+/** Whether a value is a reference (`{ "@id": … }`), or a list of them */
+function isReference(value) {
+    if (Array.isArray(value))
+        return value.length > 0 && value.every(isReference);
+    if (value === null || typeof value !== 'object')
+        return false;
+    const keys = Object.keys(value);
+    return (typeof value['@id'] === 'string' &&
+        keys.every((key) => key === '@id' || key === '@type'));
+}
+/**
+ * The scope of one resolved value. A value set in the SEO settings comes from
+ * the site settings on a site entity, and from the scope that set it on a
+ * document entity — the collection when the document has only its
+ * collection's (or the default) archetype.
+ */
+export function valueScope(resolved, property, entity) {
+    if (isReference(resolved.value))
+        return 'linked';
+    if (resolved.source === 'computed')
+        return 'computed';
+    if (resolved.source === 'site')
+        return 'site';
+    if (resolved.source === 'auto')
+        return 'document';
+    if (entity.fromSite)
+        return 'site';
+    return entity.scopes?.[property] ?? 'collection';
+}
+//# sourceMappingURL=value-scope.js.map

package/dist/graph/value-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-scope.js","sourceRoot":"","sources":["../../src/graph/value-scope.ts"],"names":[],"mappings":"AAUA,yEAAyE;AACzE,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;IAC7E,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAC7D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC/B,OAAO,CACL,OAAQ,KAAiC,CAAC,KAAK,CAAC,KAAK,QAAQ;QAC7D,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,OAAO,CAAC,CACtD,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CACxB,QAA0B,EAC1B,QAAgB,EAChB,MAAyF;IAEzF,IAAI,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAA;IAChD,IAAI,QAAQ,CAAC,MAAM,KAAK,UAAU;QAAE,OAAO,UAAU,CAAA;IACrD,IAAI,QAAQ,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,MAAM,CAAA;IAC7C,IAAI,QAAQ,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,UAAU,CAAA;IACjD,IAAI,MAAM,CAAC,QAAQ;QAAE,OAAO,MAAM,CAAA;IAClC,OAAO,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAA;AAClD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * CMS SEO module — structured data components and graph composition.
+ */
+export { DOCUMENT_SEO_METADATA_SCHEMA } from '@krantho/seo-shared';
+export type { Archetype, ArchetypeConfig, SchemaType } from './archetypes/index.js';
+export { aboutPageArchetype, blogPostArchetype, coursePageArchetype, defineArchetype, eventPageArchetype, homePageArchetype, howToPageArchetype, jobPostingPageArchetype, recipePageArchetype, servicePageArchetype, videoPageArchetype, } from './archetypes/index.js';
+export type { AutoMapping, CatalogCategory, CatalogType, PropertyDef, PropertyImportance, PropertySource, SeoFieldMap, } from './catalog/index.js';
+export { buildSeoFieldMap, CATEGORY_LABELS, DEFAULT_AUTO_MAPPINGS, getAutoMappableProperties, getCatalogByCategory, getCatalogType, getDocumentLevelTypes, getRequiredProperties, getSiteLevelTypes, getTypeProperties, resolveAutoMappings, resolveSeoField, SCHEMA_CATALOG, } from './catalog/index.js';
+export type { ConfigurationFinding, Seo, SeoSettings } from './create-seo.js';
+export { createSeo, SeoConfigurationError } from './create-seo.js';
+export type { Decorator, PageContext, ResolvedStructure } from './decorators/index.js';
+export { BUILT_IN_DECORATORS, breadcrumbDecorator, pageDecorator, pageTypeFor, registerDecorator, registeredDecorators, sequenceDecorator, } from './decorators/index.js';
+export type { SeoExtensions } from './define-seo.js';
+export { defineSeo } from './define-seo.js';
+export type { ComposeFromConfigOptions, ComposeGraphOptions, ConfigScope, DocumentMeta, EffectiveSeoConfig, EffectiveSeoEntity, JsonLdGraph, ResolvedEntity, ResolvedPropertyView, SeoConfigChain, SeoGraphConfig, ValueScope, } from './graph/index.js';
+export { composeFromConfig, composeGraph, resolveEffectiveConfig, resolvePageEntities, } from './graph/index.js';
+export { JsonLd } from './json-ld.js';
+export type { FeatureEligibility, FeatureStatus, ProfileRule, ReaderProfile, } from './profiles/index.js';
+export { BUILT_IN_PROFILES, bingProfile, featureEligibility, getProfile, googleProfile, registeredProfiles, registerProfile, ruleFor, } from './profiles/index.js';
+export type { SEOGraphProps } from './seo-graph.js';
+export { SEOGraph } from './seo-graph.js';
+export type { BuildContext, EntityLevel, ReferenceRule, ResolvedProperty, TypeDefinition, } from './types/index.js';
+export { BUILT_IN_TYPES, getTypeDefinition, registeredTypes, registerType } from './types/index.js';
+export type { Finding, FindingCode, FindingSeverity, ValidateGraphOptions, } from './validate/index.js';
+export { validateGraph } from './validate/index.js';
+export type { Lifecycle } from './vocabulary/index.js';
+export { getVocabularyProperty, getVocabularyType, isPropertyOfType, isSubtypeOf, lifecycleOf, propertiesOf, SCHEMAORG_RELEASE, } from './vocabulary/index.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":"AAAA;;GAEG;AAEH,OAAO,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAA;AAClE,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAEnF,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EACV,WAAW,EACX,eAAe,EACf,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,WAAW,GACZ,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACrB,yBAAyB,EACzB,oBAAoB,EACpB,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,cAAc,GACf,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EAAE,oBAAoB,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAE7E,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAClE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAEtF,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,YAAY,EACV,wBAAwB,EACxB,mBAAmB,EACnB,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,UAAU,GACX,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACrC,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,aAAa,GACd,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,OAAO,GACR,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,YAAY,EACV,YAAY,EACZ,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,cAAc,GACf,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACnG,YAAY,EACV,OAAO,EACP,WAAW,EACX,eAAe,EACf,oBAAoB,GACrB,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAEtD,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,YAAY,EACZ,iBAAiB,GAClB,MAAM,uBAAuB,CAAA"}

package/dist/index.js

@@ -0,0 +1,29 @@
+/**
+ * CMS SEO module — structured data components and graph composition.
+ */
+export { DOCUMENT_SEO_METADATA_SCHEMA } from '@krantho/seo-shared';
+// Archetypes
+export { aboutPageArchetype, blogPostArchetype, coursePageArchetype, defineArchetype, eventPageArchetype, homePageArchetype, howToPageArchetype, jobPostingPageArchetype, recipePageArchetype, servicePageArchetype, videoPageArchetype, } from './archetypes/index.js';
+// Schema.org type catalog
+export { buildSeoFieldMap, CATEGORY_LABELS, DEFAULT_AUTO_MAPPINGS, getAutoMappableProperties, getCatalogByCategory, getCatalogType, getDocumentLevelTypes, getRequiredProperties, getSiteLevelTypes, getTypeProperties, resolveAutoMappings, resolveSeoField, SCHEMA_CATALOG, } from './catalog/index.js';
+// The SEO subsystem of a site
+export { createSeo, SeoConfigurationError } from './create-seo.js';
+// Page-structure decorators
+export { BUILT_IN_DECORATORS, breadcrumbDecorator, pageDecorator, pageTypeFor, registerDecorator, registeredDecorators, sequenceDecorator, } from './decorators/index.js';
+// A site's own types, readers and decorators
+export { defineSeo } from './define-seo.js';
+// Graph composition
+export { composeFromConfig, composeGraph, resolveEffectiveConfig, resolvePageEntities, } from './graph/index.js';
+// Components
+export { JsonLd } from './json-ld.js';
+// Reader profiles
+export { BUILT_IN_PROFILES, bingProfile, featureEligibility, getProfile, googleProfile, registeredProfiles, registerProfile, ruleFor, } from './profiles/index.js';
+// SEOGraph component
+export { SEOGraph } from './seo-graph.js';
+// Type definitions
+export { BUILT_IN_TYPES, getTypeDefinition, registeredTypes, registerType } from './types/index.js';
+// Validation
+export { validateGraph } from './validate/index.js';
+// Schema.org vocabulary
+export { getVocabularyProperty, getVocabularyType, isPropertyOfType, isSubtypeOf, lifecycleOf, propertiesOf, SCHEMAORG_RELEASE, } from './vocabulary/index.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;;GAEG;AAEH,OAAO,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAA;AAElE,aAAa;AACb,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,uBAAuB,CAAA;AAU9B,0BAA0B;AAC1B,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACrB,yBAAyB,EACzB,oBAAoB,EACpB,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,cAAc,GACf,MAAM,oBAAoB,CAAA;AAE3B,8BAA8B;AAC9B,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AAElE,4BAA4B;AAC5B,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,uBAAuB,CAAA;AAE9B,6CAA6C;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAe3C,oBAAoB;AACpB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,kBAAkB,CAAA;AACzB,aAAa;AACb,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAOrC,kBAAkB;AAClB,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,OAAO,GACR,MAAM,qBAAqB,CAAA;AAE5B,qBAAqB;AACrB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAQzC,mBAAmB;AACnB,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAOnG,aAAa;AACb,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAEnD,wBAAwB;AACxB,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,YAAY,EACZ,iBAAiB,GAClB,MAAM,uBAAuB,CAAA"}

package/dist/json-ld.d.ts

@@ -0,0 +1,24 @@
+/**
+ * CMS JSON-LD component — renders Schema.org structured data as a script tag.
+ *
+ * Encapsulates the dangerouslySetInnerHTML pattern required by React for
+ * script tag content. Applies XSS sanitization automatically.
+ *
+ * Server component — renders in SSR HTML, no client JS.
+ */
+import type React from 'react';
+interface JsonLdProps {
+    /** Schema.org structured data object */
+    data: Record<string, unknown>;
+}
+/**
+ * Render a JSON-LD script tag with automatic XSS sanitization.
+ *
+ * @example
+ * ```tsx
+ * <JsonLd data={{ '@context': 'https://schema.org', '@type': 'LocalBusiness', name: '...' }} />
+ * ```
+ */
+export declare function JsonLd({ data }: JsonLdProps): React.ReactElement;
+export {};
+//# sourceMappingURL=json-ld.d.ts.map

package/dist/json-ld.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-ld.d.ts","sourceRoot":"","sources":["../src/json-ld.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,UAAU,WAAW;IACnB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC9B;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,WAAW,GAAG,KAAK,CAAC,YAAY,CAQhE"}

package/dist/json-ld.js

@@ -0,0 +1,24 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * CMS JSON-LD component — renders Schema.org structured data as a script tag.
+ *
+ * Encapsulates the dangerouslySetInnerHTML pattern required by React for
+ * script tag content. Applies XSS sanitization automatically.
+ *
+ * Server component — renders in SSR HTML, no client JS.
+ */
+import { serializeJsonLd } from '@krantho/seo-shared';
+/**
+ * Render a JSON-LD script tag with automatic XSS sanitization.
+ *
+ * @example
+ * ```tsx
+ * <JsonLd data={{ '@context': 'https://schema.org', '@type': 'LocalBusiness', name: '...' }} />
+ * ```
+ */
+export function JsonLd({ data }) {
+    return (_jsx("script", { type: "application/ld+json", 
+        // biome-ignore lint/security/noDangerouslySetInnerHtml: serializeJsonLd escapes `<`, so the JSON cannot end the script tag
+        dangerouslySetInnerHTML: { __html: serializeJsonLd(data) } }));
+}
+//# sourceMappingURL=json-ld.js.map

package/dist/json-ld.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-ld.js","sourceRoot":"","sources":["../src/json-ld.tsx"],"names":[],"mappings":";AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAQrD;;;;;;;GAOG;AACH,MAAM,UAAU,MAAM,CAAC,EAAE,IAAI,EAAe;IAC1C,OAAO,CACL,iBACE,IAAI,EAAC,qBAAqB;QAC1B,2HAA2H;QAC3H,uBAAuB,EAAE,EAAE,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,EAAE,GAC1D,CACH,CAAA;AACH,CAAC"}

package/dist/profiles/bing.d.ts

@@ -0,0 +1,10 @@
+import type { ReaderProfile } from './types.js';
+/**
+ * Bing. Its webmaster guidelines publish no structured-data rule set beyond
+ * Schema.org (its help pages render client-side and were not readable
+ * programmatically when checked, 2026-10-02), so the profile adds no rules:
+ * Bing reads the Schema.org baseline every graph meets. A rule is added only
+ * with a source it can cite.
+ */
+export declare const bingProfile: ReaderProfile;
+//# sourceMappingURL=bing.d.ts.map

package/dist/profiles/bing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bing.d.ts","sourceRoot":"","sources":["../../src/profiles/bing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,EAAE,aAIzB,CAAA"}