@krantho/seo 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Descoped
+
+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/dist/archetypes/define-archetype.d.ts

@@ -0,0 +1,23 @@
+import type { Archetype, ArchetypeConfig } from './types.js';
+/**
+ * Define a Schema.org archetype for a page type.
+ *
+ * An archetype declares which Schema.org types a page includes. The graph
+ * composition engine builds each with its registered definition, or as a
+ * node of the values resolved for it, and links them with `@id` references.
+ *
+ * Schema types are validated against the pinned Schema.org vocabulary at
+ * definition time: an unknown type (almost always a typo) or one Schema.org
+ * has superseded or retired throws. Archetype presets are module-level
+ * constants, so this runs at import time — by design, to surface the
+ * breakage immediately rather than producing non-conformant JSON-LD.
+ *
+ * @example
+ * ```ts
+ * const servicePage = defineArchetype({
+ *   schemas: ['LocalBusiness', 'BreadcrumbList', 'FAQPage', 'Service'],
+ * })
+ * ```
+ */
+export declare function defineArchetype(config: ArchetypeConfig): Archetype;
+//# sourceMappingURL=define-archetype.d.ts.map

package/dist/archetypes/define-archetype.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-archetype.d.ts","sourceRoot":"","sources":["../../src/archetypes/define-archetype.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAY5D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAuBlE"}

package/dist/archetypes/define-archetype.js

@@ -0,0 +1,51 @@
+import { getVocabularyType, lifecycleOf } from '../vocabulary/index.js';
+/** Default frontmatter key → Schema.org property mappings */
+const DEFAULT_MAPPINGS = {
+    title: 'name',
+    description: 'description',
+    author: 'author',
+    date: 'datePublished',
+    image: 'image',
+    excerpt: 'description',
+};
+/**
+ * Define a Schema.org archetype for a page type.
+ *
+ * An archetype declares which Schema.org types a page includes. The graph
+ * composition engine builds each with its registered definition, or as a
+ * node of the values resolved for it, and links them with `@id` references.
+ *
+ * Schema types are validated against the pinned Schema.org vocabulary at
+ * definition time: an unknown type (almost always a typo) or one Schema.org
+ * has superseded or retired throws. Archetype presets are module-level
+ * constants, so this runs at import time — by design, to surface the
+ * breakage immediately rather than producing non-conformant JSON-LD.
+ *
+ * @example
+ * ```ts
+ * const servicePage = defineArchetype({
+ *   schemas: ['LocalBusiness', 'BreadcrumbList', 'FAQPage', 'Service'],
+ * })
+ * ```
+ */
+export function defineArchetype(config) {
+    if (config.schemas.length === 0) {
+        throw new Error('Archetype must include at least one schema type');
+    }
+    const unknown = config.schemas.filter((s) => getVocabularyType(s) === undefined);
+    if (unknown.length > 0) {
+        throw new Error(`defineArchetype: unknown Schema.org type(s) [${unknown.join(', ')}].`);
+    }
+    const outdated = config.schemas.filter((s) => {
+        const status = lifecycleOf(s)?.status;
+        return status === 'superseded' || status === 'retired';
+    });
+    if (outdated.length > 0) {
+        throw new Error(`defineArchetype: superseded or retired Schema.org type(s) [${outdated.join(', ')}].`);
+    }
+    return {
+        schemas: config.schemas,
+        mappings: { ...DEFAULT_MAPPINGS, ...config.mappings },
+    };
+}
+//# sourceMappingURL=define-archetype.js.map

package/dist/archetypes/define-archetype.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-archetype.js","sourceRoot":"","sources":["../../src/archetypes/define-archetype.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAGvE,6DAA6D;AAC7D,MAAM,gBAAgB,GAA2B;IAC/C,KAAK,EAAE,MAAM;IACb,WAAW,EAAE,aAAa;IAC1B,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,eAAe;IACrB,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,aAAa;CACvB,CAAA;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,eAAe,CAAC,MAAuB;IACrD,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAA;IACpE,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAA;IAChF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,gDAAgD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzF,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QAC3C,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,CAAA;QACrC,OAAO,MAAM,KAAK,YAAY,IAAI,MAAM,KAAK,SAAS,CAAA;IACxD,CAAC,CAAC,CAAA;IACF,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,8DAA8D,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CACtF,CAAA;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,EAAE,GAAG,gBAAgB,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE;KACtD,CAAA;AACH,CAAC"}

package/dist/archetypes/index.d.ts

@@ -0,0 +1,4 @@
+export { defineArchetype } from './define-archetype.js';
+export { aboutPageArchetype, blogPostArchetype, coursePageArchetype, eventPageArchetype, homePageArchetype, howToPageArchetype, jobPostingPageArchetype, recipePageArchetype, servicePageArchetype, videoPageArchetype, } from './presets.js';
+export type { Archetype, ArchetypeConfig, SchemaType } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/archetypes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA"}

package/dist/archetypes/index.js

@@ -0,0 +1,3 @@
+export { defineArchetype } from './define-archetype.js';
+export { aboutPageArchetype, blogPostArchetype, coursePageArchetype, eventPageArchetype, homePageArchetype, howToPageArchetype, jobPostingPageArchetype, recipePageArchetype, servicePageArchetype, videoPageArchetype, } from './presets.js';
+//# sourceMappingURL=index.js.map

package/dist/archetypes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/archetypes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,cAAc,CAAA"}

package/dist/archetypes/presets.d.ts

@@ -0,0 +1,21 @@
+/** Home page: business identity + website + person */
+export declare const homePageArchetype: import("./types.js").Archetype;
+/** About page: organization + person + breadcrumbs */
+export declare const aboutPageArchetype: import("./types.js").Archetype;
+/** Service page: business + breadcrumbs + FAQ + service */
+export declare const servicePageArchetype: import("./types.js").Archetype;
+/** Blog post: article + breadcrumbs + person (author) */
+export declare const blogPostArchetype: import("./types.js").Archetype;
+/** Event page: event + breadcrumbs + organization (organizer) */
+export declare const eventPageArchetype: import("./types.js").Archetype;
+/** Recipe page: recipe + breadcrumbs + person (author) */
+export declare const recipePageArchetype: import("./types.js").Archetype;
+/** Course page: course + breadcrumbs + organization (provider) */
+export declare const coursePageArchetype: import("./types.js").Archetype;
+/** Job posting page: job posting + breadcrumbs + organization (hiring company) */
+export declare const jobPostingPageArchetype: import("./types.js").Archetype;
+/** How-to guide: how-to + breadcrumbs + person (author) */
+export declare const howToPageArchetype: import("./types.js").Archetype;
+/** Video page: video object + breadcrumbs + organization (publisher) */
+export declare const videoPageArchetype: import("./types.js").Archetype;
+//# sourceMappingURL=presets.d.ts.map

package/dist/archetypes/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/archetypes/presets.ts"],"names":[],"mappings":"AAEA,sDAAsD;AACtD,eAAO,MAAM,iBAAiB,gCAE5B,CAAA;AAEF,sDAAsD;AACtD,eAAO,MAAM,kBAAkB,gCAE7B,CAAA;AAEF,2DAA2D;AAC3D,eAAO,MAAM,oBAAoB,gCAE/B,CAAA;AAEF,yDAAyD;AACzD,eAAO,MAAM,iBAAiB,gCAE5B,CAAA;AAEF,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,gCAE7B,CAAA;AAEF,0DAA0D;AAC1D,eAAO,MAAM,mBAAmB,gCAE9B,CAAA;AAEF,kEAAkE;AAClE,eAAO,MAAM,mBAAmB,gCAE9B,CAAA;AAEF,kFAAkF;AAClF,eAAO,MAAM,uBAAuB,gCAElC,CAAA;AAEF,2DAA2D;AAC3D,eAAO,MAAM,kBAAkB,gCAE7B,CAAA;AAEF,wEAAwE;AACxE,eAAO,MAAM,kBAAkB,gCAE7B,CAAA"}

package/dist/archetypes/presets.js

@@ -0,0 +1,42 @@
+import { defineArchetype } from './define-archetype.js';
+/** Home page: business identity + website + person */
+export const homePageArchetype = defineArchetype({
+    schemas: ['LocalBusiness', 'Person', 'WebSite'],
+});
+/** About page: organization + person + breadcrumbs */
+export const aboutPageArchetype = defineArchetype({
+    schemas: ['Organization', 'Person', 'BreadcrumbList'],
+});
+/** Service page: business + breadcrumbs + FAQ + service */
+export const servicePageArchetype = defineArchetype({
+    schemas: ['LocalBusiness', 'BreadcrumbList', 'FAQPage', 'Service'],
+});
+/** Blog post: article + breadcrumbs + person (author) */
+export const blogPostArchetype = defineArchetype({
+    schemas: ['Article', 'BreadcrumbList', 'Person'],
+});
+/** Event page: event + breadcrumbs + organization (organizer) */
+export const eventPageArchetype = defineArchetype({
+    schemas: ['Event', 'BreadcrumbList', 'Organization'],
+});
+/** Recipe page: recipe + breadcrumbs + person (author) */
+export const recipePageArchetype = defineArchetype({
+    schemas: ['Recipe', 'BreadcrumbList', 'Person'],
+});
+/** Course page: course + breadcrumbs + organization (provider) */
+export const coursePageArchetype = defineArchetype({
+    schemas: ['Course', 'BreadcrumbList', 'Organization'],
+});
+/** Job posting page: job posting + breadcrumbs + organization (hiring company) */
+export const jobPostingPageArchetype = defineArchetype({
+    schemas: ['JobPosting', 'BreadcrumbList', 'Organization'],
+});
+/** How-to guide: how-to + breadcrumbs + person (author) */
+export const howToPageArchetype = defineArchetype({
+    schemas: ['HowTo', 'BreadcrumbList', 'Person'],
+});
+/** Video page: video object + breadcrumbs + organization (publisher) */
+export const videoPageArchetype = defineArchetype({
+    schemas: ['VideoObject', 'BreadcrumbList', 'Organization'],
+});
+//# sourceMappingURL=presets.js.map

package/dist/archetypes/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../src/archetypes/presets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD,sDAAsD;AACtD,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC;IAC/C,OAAO,EAAE,CAAC,eAAe,EAAE,QAAQ,EAAE,SAAS,CAAC;CAChD,CAAC,CAAA;AAEF,sDAAsD;AACtD,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC;IAChD,OAAO,EAAE,CAAC,cAAc,EAAE,QAAQ,EAAE,gBAAgB,CAAC;CACtD,CAAC,CAAA;AAEF,2DAA2D;AAC3D,MAAM,CAAC,MAAM,oBAAoB,GAAG,eAAe,CAAC;IAClD,OAAO,EAAE,CAAC,eAAe,EAAE,gBAAgB,EAAE,SAAS,EAAE,SAAS,CAAC;CACnE,CAAC,CAAA;AAEF,yDAAyD;AACzD,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC;IAC/C,OAAO,EAAE,CAAC,SAAS,EAAE,gBAAgB,EAAE,QAAQ,CAAC;CACjD,CAAC,CAAA;AAEF,iEAAiE;AACjE,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC;IAChD,OAAO,EAAE,CAAC,OAAO,EAAE,gBAAgB,EAAE,cAAc,CAAC;CACrD,CAAC,CAAA;AAEF,0DAA0D;AAC1D,MAAM,CAAC,MAAM,mBAAmB,GAAG,eAAe,CAAC;IACjD,OAAO,EAAE,CAAC,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,CAAC;CAChD,CAAC,CAAA;AAEF,kEAAkE;AAClE,MAAM,CAAC,MAAM,mBAAmB,GAAG,eAAe,CAAC;IACjD,OAAO,EAAE,CAAC,QAAQ,EAAE,gBAAgB,EAAE,cAAc,CAAC;CACtD,CAAC,CAAA;AAEF,kFAAkF;AAClF,MAAM,CAAC,MAAM,uBAAuB,GAAG,eAAe,CAAC;IACrD,OAAO,EAAE,CAAC,YAAY,EAAE,gBAAgB,EAAE,cAAc,CAAC;CAC1D,CAAC,CAAA;AAEF,2DAA2D;AAC3D,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC;IAChD,OAAO,EAAE,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,CAAC;CAC/C,CAAC,CAAA;AAEF,wEAAwE;AACxE,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC;IAChD,OAAO,EAAE,CAAC,aAAa,EAAE,gBAAgB,EAAE,cAAc,CAAC;CAC3D,CAAC,CAAA"}

package/dist/archetypes/types.d.ts

@@ -0,0 +1,20 @@
+/**
+ * A Schema.org type accepted by archetypes and config-driven composition: any
+ * current type of the pinned vocabulary. Types with a registered definition
+ * (`registerType`) are built by it; any other type is a node of the values
+ * resolved for it.
+ */
+export type SchemaType = string;
+/** Configuration for defining an archetype */
+export interface ArchetypeConfig {
+    /** Schema.org types this page type includes */
+    schemas: readonly SchemaType[];
+    /** Optional frontmatter key → schema property mappings */
+    mappings?: Readonly<Record<string, string>> | undefined;
+}
+/** A defined archetype — immutable after creation */
+export interface Archetype {
+    readonly schemas: readonly SchemaType[];
+    readonly mappings: Readonly<Record<string, string>>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/archetypes/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAA;AAE/B,8CAA8C;AAC9C,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,OAAO,EAAE,SAAS,UAAU,EAAE,CAAA;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAA;CACxD;AAED,qDAAqD;AACrD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAA;IACvC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CACpD"}

package/dist/archetypes/types.js

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

package/dist/archetypes/types.js.map

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

package/dist/catalog/auto-mappings.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Default auto-mappings from CMS field names to Schema.org properties.
+ *
+ * When a CMS field name matches a known pattern, the system automatically
+ * maps it to the corresponding Schema.org property without manual configuration.
+ *
+ * These are applied at the collection level and can be overridden per document.
+ *
+ * SEO field discovery (SeoFieldMap, buildSeoFieldMap, resolveSeoField) is now
+ * canonical in @krantho/seo-shared. We re-export those here for backwards
+ * compatibility with existing @krantho/seo consumers.
+ */
+export { buildSeoFieldMap, resolveSeoField, SEO_FIELD_CANDIDATES, type SeoFieldConcept, type SeoFieldMap, } from '@krantho/seo-shared';
+/** A mapping from CMS field name to Schema.org property */
+export interface AutoMapping {
+    /** CMS field name (exact match) */
+    cmsField: string;
+    /** Schema.org property name */
+    schemaProperty: string;
+    /** Priority — higher wins when multiple fields map to the same property */
+    priority: number;
+}
+/**
+ * Default auto-mappings sorted by priority (highest first).
+ *
+ * When multiple CMS fields could map to the same Schema.org property,
+ * the highest priority mapping wins. For example, `meta-description`
+ * (priority 10) overrides `description` (priority 5) for the Schema.org
+ * `description` property.
+ */
+export declare const DEFAULT_AUTO_MAPPINGS: readonly AutoMapping[];
+/**
+ * Resolve auto-mappings for a set of CMS fields against a Schema.org type's properties.
+ *
+ * Returns a map of Schema.org property → CMS field name for all properties
+ * that can be auto-filled from the given CMS fields.
+ */
+export declare function resolveAutoMappings(cmsFields: readonly string[], schemaProperties: readonly string[]): Map<string, string>;
+//# sourceMappingURL=auto-mappings.d.ts.map

package/dist/catalog/auto-mappings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-mappings.d.ts","sourceRoot":"","sources":["../../src/catalog/auto-mappings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,WAAW,GACjB,MAAM,qBAAqB,CAAA;AAE5B,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IAC1B,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAA;IAChB,+BAA+B;IAC/B,cAAc,EAAE,MAAM,CAAA;IACtB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,WAAW,EAuBvD,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,gBAAgB,EAAE,SAAS,MAAM,EAAE,GAClC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAerB"}

package/dist/catalog/auto-mappings.js

@@ -0,0 +1,64 @@
+/**
+ * Default auto-mappings from CMS field names to Schema.org properties.
+ *
+ * When a CMS field name matches a known pattern, the system automatically
+ * maps it to the corresponding Schema.org property without manual configuration.
+ *
+ * These are applied at the collection level and can be overridden per document.
+ *
+ * SEO field discovery (SeoFieldMap, buildSeoFieldMap, resolveSeoField) is now
+ * canonical in @krantho/seo-shared. We re-export those here for backwards
+ * compatibility with existing @krantho/seo consumers.
+ */
+export { buildSeoFieldMap, resolveSeoField, SEO_FIELD_CANDIDATES, } from '@krantho/seo-shared';
+/**
+ * Default auto-mappings sorted by priority (highest first).
+ *
+ * When multiple CMS fields could map to the same Schema.org property,
+ * the highest priority mapping wins. For example, `meta-description`
+ * (priority 10) overrides `description` (priority 5) for the Schema.org
+ * `description` property.
+ */
+export const DEFAULT_AUTO_MAPPINGS = [
+    // Title / Name / Headline
+    { cmsField: 'title', schemaProperty: 'name', priority: 5 },
+    { cmsField: 'title', schemaProperty: 'headline', priority: 5 },
+    // Description
+    { cmsField: 'meta-description', schemaProperty: 'description', priority: 10 },
+    { cmsField: 'description', schemaProperty: 'description', priority: 5 },
+    { cmsField: 'ingress', schemaProperty: 'description', priority: 3 },
+    { cmsField: 'excerpt', schemaProperty: 'description', priority: 2 },
+    // Dates
+    { cmsField: 'date', schemaProperty: 'datePublished', priority: 5 },
+    { cmsField: 'published-date', schemaProperty: 'datePublished', priority: 8 },
+    { cmsField: 'modified-date', schemaProperty: 'dateModified', priority: 5 },
+    // People
+    { cmsField: 'author', schemaProperty: 'author', priority: 5 },
+    // Media
+    { cmsField: 'image', schemaProperty: 'image', priority: 5 },
+    { cmsField: 'og-image', schemaProperty: 'image', priority: 8 },
+    { cmsField: 'hero-image', schemaProperty: 'image', priority: 3 },
+];
+/**
+ * Resolve auto-mappings for a set of CMS fields against a Schema.org type's properties.
+ *
+ * Returns a map of Schema.org property → CMS field name for all properties
+ * that can be auto-filled from the given CMS fields.
+ */
+export function resolveAutoMappings(cmsFields, schemaProperties) {
+    const result = new Map();
+    const cmsFieldSet = new Set(cmsFields);
+    // Sort by priority descending — highest priority wins
+    const sorted = [...DEFAULT_AUTO_MAPPINGS].sort((a, b) => b.priority - a.priority);
+    for (const mapping of sorted) {
+        if (!cmsFieldSet.has(mapping.cmsField))
+            continue;
+        if (!schemaProperties.includes(mapping.schemaProperty))
+            continue;
+        if (result.has(mapping.schemaProperty))
+            continue; // higher priority already set
+        result.set(mapping.schemaProperty, mapping.cmsField);
+    }
+    return result;
+}
+//# sourceMappingURL=auto-mappings.js.map

package/dist/catalog/auto-mappings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-mappings.js","sourceRoot":"","sources":["../../src/catalog/auto-mappings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,oBAAoB,GAGrB,MAAM,qBAAqB,CAAA;AAY5B;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA2B;IAC3D,0BAA0B;IAC1B,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC1D,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,EAAE;IAE9D,cAAc;IACd,EAAE,QAAQ,EAAE,kBAAkB,EAAE,cAAc,EAAE,aAAa,EAAE,QAAQ,EAAE,EAAE,EAAE;IAC7E,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC,EAAE;IACvE,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC,EAAE;IACnE,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC,EAAE;IAEnE,QAAQ;IACR,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC,EAAE;IAClE,EAAE,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC5E,EAAE,QAAQ,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC,EAAE;IAE1E,SAAS;IACT,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE;IAE7D,QAAQ;IACR,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC3D,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC9D,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE;CACjE,CAAA;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,SAA4B,EAC5B,gBAAmC;IAEnC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAA;IACxC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAA;IAEtC,sDAAsD;IACtD,MAAM,MAAM,GAAG,CAAC,GAAG,qBAAqB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAA;IAEjF,KAAK,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;QAC7B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC;YAAE,SAAQ;QAChD,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC;YAAE,SAAQ;QAChE,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC;YAAE,SAAQ,CAAC,8BAA8B;QAC/E,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;IACtD,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/catalog/index.d.ts

@@ -0,0 +1,7 @@
+export type { AutoMapping, SeoFieldMap } from './auto-mappings.js';
+export { buildSeoFieldMap, DEFAULT_AUTO_MAPPINGS, resolveAutoMappings, resolveSeoField, } from './auto-mappings.js';
+export type { PropertyDef, PropertyImportance, PropertySource } from './properties.js';
+export { getAutoMappableProperties, getRequiredProperties, getTypeProperties, } from './properties.js';
+export type { CatalogCategory, CatalogType } from './types.js';
+export { CATEGORY_LABELS, getCatalogByCategory, getCatalogType, getDocumentLevelTypes, getSiteLevelTypes, SCHEMA_CATALOG, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/catalog/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAClE,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,GAChB,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACtF,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,iBAAiB,CAAA;AACxB,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC9D,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,GACf,MAAM,YAAY,CAAA"}

package/dist/catalog/index.js

@@ -0,0 +1,4 @@
+export { buildSeoFieldMap, DEFAULT_AUTO_MAPPINGS, resolveAutoMappings, resolveSeoField, } from './auto-mappings.js';
+export { getAutoMappableProperties, getRequiredProperties, getTypeProperties, } from './properties.js';
+export { CATEGORY_LABELS, getCatalogByCategory, getCatalogType, getDocumentLevelTypes, getSiteLevelTypes, SCHEMA_CATALOG, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/catalog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/catalog/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,GAChB,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,GACf,MAAM,YAAY,CAAA"}

package/dist/catalog/properties.d.ts

@@ -0,0 +1,9 @@
+export type { PropertyDef, PropertyImportance, PropertySource } from './property-atoms.js';
+import type { PropertyDef } from './property-atoms.js';
+/** Get properties for a Schema.org type, with the importance Google's rule gives each */
+export declare function getTypeProperties(type: string): readonly PropertyDef[];
+/** Get required properties for a type */
+export declare function getRequiredProperties(type: string): readonly PropertyDef[];
+/** Get auto-mappable properties for a type */
+export declare function getAutoMappableProperties(type: string): readonly PropertyDef[];
+//# sourceMappingURL=properties.d.ts.map

package/dist/catalog/properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"properties.d.ts","sourceRoot":"","sources":["../../src/catalog/properties.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAI1F,OAAO,KAAK,EAAE,WAAW,EAAoC,MAAM,qBAAqB,CAAA;AA+pBxF,yFAAyF;AACzF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,WAAW,EAAE,CAKtE;AAED,yCAAyC;AACzC,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,WAAW,EAAE,CAE1E;AAED,8CAA8C;AAC9C,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,WAAW,EAAE,CAE9E"}