@krantho/seo 0.0.0-stage → 1.0.1

package/dist/catalog/types.js

@@ -0,0 +1,423 @@
+import { googleProfile } from '../profiles/google.js';
+import { ruleFor } from '../profiles/registry.js';
+import { lifecycleOf } from '../vocabulary/index.js';
+export const CATEGORY_LABELS = {
+    business: 'Business & Organization',
+    content: 'Content & Media',
+    commerce: 'Products & Services',
+    people: 'People & Events',
+    navigation: 'Navigation & Structure',
+    reviews: 'Reviews & Ratings',
+};
+/**
+ * Curated catalog of Schema.org types relevant for SEO: types that make a page
+ * eligible for a search feature, or that sites commonly describe themselves
+ * and their pages with. Not the whole vocabulary — any current Schema.org
+ * type can be configured.
+ */
+const CATALOG_ENTRIES = [
+    // ── Business & Organization ──
+    {
+        type: 'LocalBusiness',
+        label: 'Local Business',
+        description: 'A physical business or local service with an address.',
+        category: 'business',
+        siteLevel: true,
+        documentLevel: false,
+    },
+    {
+        type: 'ProfessionalService',
+        label: 'Professional Service',
+        description: 'Consulting, legal, accounting, or other professional services.',
+        category: 'business',
+        siteLevel: true,
+        documentLevel: false,
+    },
+    {
+        type: 'Organization',
+        label: 'Organization',
+        description: 'A company or organization without a physical storefront.',
+        category: 'business',
+        siteLevel: true,
+        documentLevel: false,
+    },
+    {
+        type: 'Restaurant',
+        label: 'Restaurant',
+        description: 'A food service establishment.',
+        category: 'business',
+        siteLevel: true,
+        documentLevel: false,
+    },
+    {
+        type: 'MedicalBusiness',
+        label: 'Medical Business',
+        description: 'Clinics, dentists, hospitals, and healthcare providers.',
+        category: 'business',
+        siteLevel: true,
+        documentLevel: false,
+    },
+    {
+        type: 'LegalService',
+        label: 'Legal Service',
+        description: 'Law firms and legal service providers.',
+        category: 'business',
+        siteLevel: true,
+        documentLevel: false,
+    },
+    {
+        type: 'FinancialService',
+        label: 'Financial Service',
+        description: 'Banks, insurance companies, and financial advisors.',
+        category: 'business',
+        siteLevel: true,
+        documentLevel: false,
+    },
+    {
+        type: 'RealEstateAgent',
+        label: 'Real Estate Agent',
+        description: 'Real estate agencies and property services.',
+        category: 'business',
+        siteLevel: true,
+        documentLevel: false,
+    },
+    {
+        type: 'AutoDealer',
+        label: 'Auto Dealer',
+        description: 'Car dealerships and vehicle sales.',
+        category: 'business',
+        siteLevel: true,
+        documentLevel: false,
+    },
+    {
+        type: 'HealthAndBeautyBusiness',
+        label: 'Health & Beauty',
+        description: 'Spas, salons, and beauty services.',
+        category: 'business',
+        siteLevel: true,
+        documentLevel: false,
+    },
+    {
+        type: 'FoodEstablishment',
+        label: 'Food Establishment',
+        description: 'Cafes, bars, bakeries, and food vendors.',
+        category: 'business',
+        siteLevel: true,
+        documentLevel: false,
+    },
+    {
+        type: 'EntertainmentBusiness',
+        label: 'Entertainment',
+        description: 'Cinemas, bowling alleys, and entertainment venues.',
+        category: 'business',
+        siteLevel: true,
+        documentLevel: false,
+    },
+    {
+        type: 'SportsActivityLocation',
+        label: 'Sports & Fitness',
+        description: 'Gyms, sports clubs, and fitness centers.',
+        category: 'business',
+        siteLevel: true,
+        documentLevel: false,
+    },
+    {
+        type: 'LodgingBusiness',
+        label: 'Lodging',
+        description: 'Hotels, hostels, and bed & breakfasts.',
+        category: 'business',
+        siteLevel: true,
+        documentLevel: false,
+    },
+    // ── Content ──
+    {
+        type: 'Article',
+        label: 'Article',
+        description: 'A news, blog, or editorial article.',
+        category: 'content',
+        siteLevel: false,
+        documentLevel: true,
+    },
+    {
+        type: 'BlogPosting',
+        label: 'Blog Post',
+        description: 'A blog post or journal entry.',
+        category: 'content',
+        siteLevel: false,
+        documentLevel: true,
+    },
+    {
+        type: 'NewsArticle',
+        label: 'News Article',
+        description: 'A news story with timely reporting.',
+        category: 'content',
+        siteLevel: false,
+        documentLevel: true,
+    },
+    {
+        type: 'HowTo',
+        label: 'How-To',
+        description: 'Step-by-step instructions for a task.',
+        category: 'content',
+        siteLevel: false,
+        documentLevel: true,
+    },
+    {
+        type: 'Recipe',
+        label: 'Recipe',
+        description: 'A food recipe with ingredients and steps.',
+        category: 'content',
+        siteLevel: false,
+        documentLevel: true,
+    },
+    {
+        type: 'Course',
+        label: 'Course',
+        description: 'An educational course or training program.',
+        category: 'content',
+        siteLevel: false,
+        documentLevel: true,
+    },
+    // ── Commerce & Services ──
+    {
+        type: 'Product',
+        label: 'Product',
+        description: 'A product available for purchase.',
+        category: 'commerce',
+        siteLevel: false,
+        documentLevel: true,
+    },
+    {
+        type: 'Service',
+        label: 'Service',
+        description: 'A service offered by a business.',
+        category: 'commerce',
+        siteLevel: false,
+        documentLevel: true,
+    },
+    {
+        type: 'Offer',
+        label: 'Offer',
+        description: 'A pricing offer for a product or service.',
+        category: 'commerce',
+        siteLevel: false,
+        documentLevel: true,
+    },
+    // ── People & Events ──
+    {
+        type: 'Person',
+        label: 'Person',
+        description: 'An individual — author, founder, team member.',
+        category: 'people',
+        siteLevel: true,
+        documentLevel: true,
+    },
+    {
+        type: 'Event',
+        label: 'Event',
+        description: 'A scheduled event — conference, workshop, webinar.',
+        category: 'people',
+        siteLevel: false,
+        documentLevel: true,
+    },
+    {
+        type: 'JobPosting',
+        label: 'Job Posting',
+        description: 'A job listing or career opportunity.',
+        category: 'people',
+        siteLevel: false,
+        documentLevel: true,
+    },
+    // ── Navigation & Structure ──
+    {
+        type: 'WebSite',
+        label: 'Website',
+        description: 'The website itself — gives search engines its name, on the home page.',
+        category: 'navigation',
+        siteLevel: true,
+        documentLevel: false,
+    },
+    {
+        type: 'WebPage',
+        label: 'Web Page',
+        description: 'A standard web page. Default type for all pages.',
+        category: 'navigation',
+        siteLevel: false,
+        documentLevel: true,
+    },
+    {
+        type: 'BreadcrumbList',
+        label: 'Breadcrumb',
+        description: 'Navigation trail showing page hierarchy.',
+        category: 'navigation',
+        siteLevel: false,
+        documentLevel: true,
+    },
+    {
+        type: 'FAQPage',
+        label: 'FAQ Page',
+        description: 'A page with question and answer pairs.',
+        category: 'navigation',
+        siteLevel: false,
+        documentLevel: true,
+    },
+    // ── Content (continued) ──
+    {
+        type: 'VideoObject',
+        label: 'Video',
+        description: 'A video with playback and metadata.',
+        category: 'content',
+        siteLevel: false,
+        documentLevel: true,
+    },
+    {
+        type: 'ImageObject',
+        label: 'Image',
+        description: 'An image with credits and metadata.',
+        category: 'content',
+        siteLevel: false,
+        documentLevel: true,
+    },
+    {
+        type: 'Dataset',
+        label: 'Dataset',
+        description: 'A structured dataset, for dataset search engines.',
+        category: 'content',
+        siteLevel: false,
+        documentLevel: true,
+    },
+    {
+        type: 'Movie',
+        label: 'Movie',
+        description: 'A movie with cast, crew, and release info.',
+        category: 'content',
+        siteLevel: false,
+        documentLevel: true,
+    },
+    {
+        type: 'DiscussionForumPosting',
+        label: 'Forum Post',
+        description: 'A posting in a discussion forum or community.',
+        category: 'content',
+        siteLevel: false,
+        documentLevel: true,
+    },
+    {
+        type: 'SpeakableSpecification',
+        label: 'Speakable',
+        description: 'Content sections suitable for voice assistant playback.',
+        category: 'content',
+        siteLevel: false,
+        documentLevel: true,
+    },
+    // ── Commerce & Services (continued) ──
+    {
+        type: 'SoftwareApplication',
+        label: 'Software App',
+        description: 'A software application or mobile app listing.',
+        category: 'commerce',
+        siteLevel: false,
+        documentLevel: true,
+    },
+    {
+        type: 'VacationRental',
+        label: 'Vacation Rental',
+        description: 'A vacation rental property listing.',
+        category: 'commerce',
+        siteLevel: false,
+        documentLevel: true,
+    },
+    {
+        type: 'EmployerAggregateRating',
+        label: 'Employer Rating',
+        description: 'Aggregate employee rating of an employer.',
+        category: 'commerce',
+        siteLevel: false,
+        documentLevel: true,
+    },
+    // ── Navigation & Structure (continued) ──
+    {
+        type: 'ItemList',
+        label: 'Item List',
+        description: 'An ordered or unordered list of items for carousel display.',
+        category: 'navigation',
+        siteLevel: false,
+        documentLevel: true,
+    },
+    {
+        type: 'ProfilePage',
+        label: 'Profile Page',
+        description: 'A page representing a person or organization profile.',
+        category: 'navigation',
+        siteLevel: false,
+        documentLevel: true,
+    },
+    {
+        type: 'QAPage',
+        label: 'Q&A Page',
+        description: 'A page with a single question and community answers.',
+        category: 'navigation',
+        siteLevel: false,
+        documentLevel: true,
+    },
+    // ── Reviews & Ratings ──
+    {
+        type: 'Review',
+        label: 'Review',
+        description: 'A single review of a product, service, or business.',
+        category: 'reviews',
+        siteLevel: false,
+        documentLevel: true,
+    },
+    {
+        type: 'AggregateRating',
+        label: 'Aggregate Rating',
+        description: 'Average rating from multiple reviews.',
+        category: 'reviews',
+        siteLevel: false,
+        documentLevel: true,
+    },
+];
+/** The Google feature of an entry, from the Google profile's rule for its type */
+function withFeature(entry) {
+    const rule = ruleFor(googleProfile, entry.type);
+    const lifecycle = lifecycleOf(entry.type);
+    return {
+        ...entry,
+        richResult: rule?.feature ?? null,
+        richResultStatus: rule?.status ?? 'none',
+        docsUrl: rule?.source ?? '',
+        ...(lifecycle ? { lifecycle } : {}),
+    };
+}
+/**
+ * The catalog. Each type's Google feature, status and documentation come from
+ * the Google profile, so the catalog cannot disagree with the rules findings
+ * are checked against.
+ */
+export const SCHEMA_CATALOG = CATALOG_ENTRIES.map(withFeature);
+// Pre-built indexes for O(1) lookups on the static catalog
+const catalogByType = new Map(SCHEMA_CATALOG.map((t) => [t.type, t]));
+const catalogByCategory = new Map(Object.keys(CATEGORY_LABELS).map((cat) => [
+    cat,
+    SCHEMA_CATALOG.filter((t) => t.category === cat),
+]));
+const siteLevelTypes = SCHEMA_CATALOG.filter((t) => t.siteLevel);
+const documentLevelTypes = SCHEMA_CATALOG.filter((t) => t.documentLevel);
+/** Look up a catalog type by its Schema.org @type value */
+export function getCatalogType(type) {
+    return catalogByType.get(type);
+}
+/** Get catalog types filtered by category */
+export function getCatalogByCategory(category) {
+    return catalogByCategory.get(category) ?? [];
+}
+/** Get catalog types that can be used at site level */
+export function getSiteLevelTypes() {
+    return siteLevelTypes;
+}
+/** Get catalog types that can be used at document level */
+export function getDocumentLevelTypes() {
+    return documentLevelTypes;
+}
+//# sourceMappingURL=types.js.map

package/dist/catalog/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/catalog/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AAGjD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAsCpD,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,QAAQ,EAAE,yBAAyB;IACnC,OAAO,EAAE,iBAAiB;IAC1B,QAAQ,EAAE,qBAAqB;IAC/B,MAAM,EAAE,iBAAiB;IACzB,UAAU,EAAE,wBAAwB;IACpC,OAAO,EAAE,mBAAmB;CACa,CAAA;AAE3C;;;;;GAKG;AACH,MAAM,eAAe,GAA4B;IAC/C,gCAAgC;IAChC;QACE,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,uDAAuD;QACpE,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,KAAK;KACrB;IACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,gEAAgE;QAC7E,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,KAAK;KACrB;IACD;QACE,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,0DAA0D;QACvE,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,KAAK;KACrB;IACD;QACE,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,+BAA+B;QAC5C,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,KAAK;KACrB;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,kBAAkB;QACzB,WAAW,EAAE,yDAAyD;QACtE,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,KAAK;KACrB;IACD;QACE,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,wCAAwC;QACrD,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,KAAK;KACrB;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,qDAAqD;QAClE,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,KAAK;KACrB;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,6CAA6C;QAC1D,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,KAAK;KACrB;IACD;QACE,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,oCAAoC;QACjD,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,KAAK;KACrB;IACD;QACE,IAAI,EAAE,yBAAyB;QAC/B,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,oCAAoC;QACjD,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,KAAK;KACrB;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,0CAA0C;QACvD,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,KAAK;KACrB;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,oDAAoD;QACjE,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,KAAK;KACrB;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,KAAK,EAAE,kBAAkB;QACzB,WAAW,EAAE,0CAA0C;QACvD,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,KAAK;KACrB;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,wCAAwC;QACrD,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,KAAK;KACrB;IAED,gBAAgB;IAChB;QACE,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,qCAAqC;QAClD,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,IAAI;KACpB;IACD;QACE,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,+BAA+B;QAC5C,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,IAAI;KACpB;IACD;QACE,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,qCAAqC;QAClD,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,IAAI;KACpB;IACD;QACE,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,uCAAuC;QACpD,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,IAAI;KACpB;IACD;QACE,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,2CAA2C;QACxD,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,IAAI;KACpB;IACD;QACE,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,4CAA4C;QACzD,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,IAAI;KACpB;IAED,4BAA4B;IAC5B;QACE,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,mCAAmC;QAChD,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,IAAI;KACpB;IACD;QACE,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,kCAAkC;QAC/C,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,IAAI;KACpB;IACD;QACE,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,2CAA2C;QACxD,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,IAAI;KACpB;IAED,wBAAwB;IACxB;QACE,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,+CAA+C;QAC5D,QAAQ,EAAE,QAAQ;QAClB,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,IAAI;KACpB;IACD;QACE,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,oDAAoD;QACjE,QAAQ,EAAE,QAAQ;QAClB,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,IAAI;KACpB;IACD;QACE,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,sCAAsC;QACnD,QAAQ,EAAE,QAAQ;QAClB,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,IAAI;KACpB;IAED,+BAA+B;IAC/B;QACE,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,uEAAuE;QACpF,QAAQ,EAAE,YAAY;QACtB,SAAS,EAAE,IAAI;QACf,aAAa,EAAE,KAAK;KACrB;IACD;QACE,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,kDAAkD;QAC/D,QAAQ,EAAE,YAAY;QACtB,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,IAAI;KACpB;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,0CAA0C;QACvD,QAAQ,EAAE,YAAY;QACtB,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,IAAI;KACpB;IACD;QACE,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,wCAAwC;QACrD,QAAQ,EAAE,YAAY;QACtB,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,IAAI;KACpB;IAED,4BAA4B;IAC5B;QACE,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,qCAAqC;QAClD,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,IAAI;KACpB;IACD;QACE,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,qCAAqC;QAClD,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,IAAI;KACpB;IACD;QACE,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,mDAAmD;QAChE,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,IAAI;KACpB;IACD;QACE,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,4CAA4C;QACzD,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,IAAI;KACpB;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,+CAA+C;QAC5D,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,IAAI;KACpB;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,yDAAyD;QACtE,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,IAAI;KACpB;IAED,wCAAwC;IACxC;QACE,IAAI,EAAE,qBAAqB;QAC3B,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,+CAA+C;QAC5D,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,IAAI;KACpB;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,qCAAqC;QAClD,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,IAAI;KACpB;IACD;QACE,IAAI,EAAE,yBAAyB;QAC/B,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,2CAA2C;QACxD,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,IAAI;KACpB;IAED,2CAA2C;IAC3C;QACE,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,6DAA6D;QAC1E,QAAQ,EAAE,YAAY;QACtB,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,IAAI;KACpB;IACD;QACE,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,uDAAuD;QACpE,QAAQ,EAAE,YAAY;QACtB,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,IAAI;KACpB;IACD;QACE,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,sDAAsD;QACnE,QAAQ,EAAE,YAAY;QACtB,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,IAAI;KACpB;IAED,0BAA0B;IAC1B;QACE,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,qDAAqD;QAClE,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,IAAI;KACpB;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,kBAAkB;QACzB,WAAW,EAAE,uCAAuC;QACpD,QAAQ,EAAE,SAAS;QACnB,SAAS,EAAE,KAAK;QAChB,aAAa,EAAE,IAAI;KACpB;CACF,CAAA;AAED,kFAAkF;AAClF,SAAS,WAAW,CAAC,KAAmB;IACtC,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;IAC/C,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACzC,OAAO;QACL,GAAG,KAAK;QACR,UAAU,EAAE,IAAI,EAAE,OAAO,IAAI,IAAI;QACjC,gBAAgB,EAAE,IAAI,EAAE,MAAM,IAAI,MAAM;QACxC,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,EAAE;QAC3B,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpC,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAA2B,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;AAEtF,2DAA2D;AAC3D,MAAM,aAAa,GAAG,IAAI,GAAG,CAAsB,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;AAE1F,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAC9B,MAAM,CAAC,IAAI,CAAC,eAAe,CAAuB,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;IAC/D,GAAG;IACH,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,GAAG,CAAC;CACjD,CAAC,CACH,CAAA;AAED,MAAM,cAAc,GAA2B,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;AACxF,MAAM,kBAAkB,GAA2B,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAA;AAEhG,2DAA2D;AAC3D,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;AAChC,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,oBAAoB,CAAC,QAAyB;IAC5D,OAAO,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAA;AAC9C,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,iBAAiB;IAC/B,OAAO,cAAc,CAAA;AACvB,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,qBAAqB;IACnC,OAAO,kBAAkB,CAAA;AAC3B,CAAC"}

package/dist/create-seo.d.ts

@@ -0,0 +1,70 @@
+import type { SeoConfigData } from '@krantho/seo-shared';
+import type { ComposeFromConfigOptions, ResolvedEntity } from './graph/compose-from-config.js';
+import type { JsonLdGraph, SeoGraphConfig } from './graph/types.js';
+import './profiles/index.js';
+import type { FeatureEligibility } from './profiles/eligibility.js';
+import type { Finding, GraphNode } from './validate/types.js';
+type Scopes = Readonly<Record<string, SeoConfigData>>;
+/** The configuration the SEO subsystem is created from: the `site` and `seo` sections of the loaded instance */
+export interface SeoSettings {
+    readonly site: SeoGraphConfig & {
+        readonly sameAs: readonly string[];
+    };
+    readonly seo: {
+        readonly identity?: string | undefined;
+        readonly collections: Readonly<Record<string, readonly string[]>>;
+        readonly routes: Readonly<Record<string, readonly string[]>>;
+        readonly site?: SeoConfigData | undefined;
+        readonly richCollections: Scopes;
+        readonly richRoutes: Scopes;
+        readonly readers: readonly string[];
+        readonly definitions: {
+            readonly site: SeoConfigData | null;
+            readonly collections: Scopes;
+            readonly routes: Scopes;
+        };
+    };
+}
+/** A problem with the configuration itself, naming the setting that fixes it */
+export interface ConfigurationFinding {
+    readonly severity: 'error' | 'warning' | 'info';
+    /** The configuration path to set or change, e.g. `site.logo` */
+    readonly setting: string;
+    readonly message: string;
+}
+/** Thrown when the configuration lacks what the structured data requires */
+export declare class SeoConfigurationError extends Error {
+    readonly findings: readonly ConfigurationFinding[];
+    constructor(findings: readonly ConfigurationFinding[]);
+}
+/** The SEO subsystem of one site, created from its configuration */
+export interface Seo {
+    /** The site's identity and address, as entities carry it */
+    readonly site: SeoGraphConfig;
+    /** The reader profiles graphs are checked against */
+    readonly readers: readonly string[];
+    /** What the configuration could do better — recommended values it lacks, pending terms it uses */
+    readonly findings: readonly ConfigurationFinding[];
+    /** Compose a page's graph with the site's identity */
+    compose(options: Omit<ComposeFromConfigOptions, 'siteConfig'>): JsonLdGraph;
+    /** Each entity of a page with its properties' values and sources, as the graph would carry them */
+    resolve(options: Omit<ComposeFromConfigOptions, 'siteConfig' | 'onFinding'>): ResolvedEntity[];
+    /** Validate a graph against the vocabulary and the active readers */
+    validate(graph: JsonLdGraph | GraphNode): Finding[];
+    /** The search features of the active readers a graph's entities can appear in, with what they lack */
+    features(graph: JsonLdGraph | GraphNode): FeatureEligibility[];
+}
+/**
+ * Create a site's SEO subsystem from its loaded configuration: the site's
+ * identity from `site`, the active readers from `seo.readers`, and the types
+ * and site entities from the `seo` section and its definition files.
+ *
+ * Fails fast on what is required, and only on that: an unknown reader, a type
+ * the vocabulary lacks or has superseded or retired, or a value of the site's
+ * identity an active reader requires throws a {@link SeoConfigurationError}
+ * naming each setting. A value a reader only recommends is a warning in
+ * `findings` and never stops anything.
+ */
+export declare function createSeo(settings: SeoSettings): Seo;
+export {};
+//# sourceMappingURL=create-seo.d.ts.map

package/dist/create-seo.d.ts.map

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

package/dist/create-seo.js

@@ -0,0 +1,137 @@
+import { composeFromConfig, resolvePageEntities } from './graph/compose-from-config.js';
+import { siteSettingFor } from './graph/resolve-properties.js';
+import './profiles/index.js';
+import { featureEligibility } from './profiles/eligibility.js';
+import { getProfile, ruleFor } from './profiles/registry.js';
+import { isEmpty } from './types/values.js';
+import { validateGraph } from './validate/validate-graph.js';
+import { getVocabularyType, lifecycleOf } from './vocabulary/index.js';
+/** Thrown when the configuration lacks what the structured data requires */
+export class SeoConfigurationError extends Error {
+    findings;
+    constructor(findings) {
+        const body = findings.map((f) => `  - ${f.setting}: ${f.message}`).join('\n');
+        super(`Invalid SEO configuration:\n${body}`);
+        this.name = 'SeoConfigurationError';
+        this.findings = findings;
+    }
+}
+/** Every type the configuration names, with the setting it is named in */
+function configuredTypes(seo) {
+    const entities = (setting, scope) => (scope?.entities ?? []).map((entity) => [setting, entity['@type']]);
+    const scopes = (setting, record) => Object.entries(record).flatMap(([key, scope]) => entities(`${setting}.${key}`, scope));
+    const lists = (setting, record) => Object.entries(record).flatMap(([key, types]) => types.map((type) => [`${setting}.${key}`, type]));
+    const files = seo.definitions;
+    return [
+        ...(seo.identity ? [['seo.identity', seo.identity]] : []),
+        ...lists('seo.collections', seo.collections),
+        ...lists('seo.routes', seo.routes),
+        ...entities('seo.site', seo.site),
+        ...scopes('seo.richCollections', seo.richCollections),
+        ...scopes('seo.richRoutes', seo.richRoutes),
+        ...entities('seo.configDir (site)', files.site),
+        ...scopes('seo.configDir (collections)', files.collections),
+        ...scopes('seo.configDir (routes)', files.routes),
+    ];
+}
+/** A configured type must be a current Schema.org type; a pending one is noted */
+function typeFindings(setting, type) {
+    if (!getVocabularyType(type)) {
+        return [{ severity: 'error', setting, message: `"${type}" is not a Schema.org type.` }];
+    }
+    const lifecycle = lifecycleOf(type);
+    if (lifecycle?.status === 'superseded') {
+        return [
+            {
+                severity: 'error',
+                setting,
+                message: `"${type}" is superseded by "${lifecycle.by}" in Schema.org.`,
+            },
+        ];
+    }
+    if (lifecycle?.status === 'retired') {
+        return [{ severity: 'error', setting, message: `"${type}" is retired from Schema.org.` }];
+    }
+    if (lifecycle?.status === 'pending') {
+        return [{ severity: 'info', setting, message: `"${type}" is a pending Schema.org term.` }];
+    }
+    return [];
+}
+/** The site entities the configuration defines, from every place it can define them */
+function siteEntities(seo) {
+    const fromIdentity = seo.identity ? [{ '@type': seo.identity, properties: {} }] : [];
+    return [...(seo.definitions.site?.entities ?? []), ...(seo.site?.entities ?? fromIdentity)];
+}
+/** Values a reader needs from the site's identity that the configuration does not set */
+function identityFindings(settings, readers) {
+    const findings = [];
+    for (const entity of siteEntities(settings.seo)) {
+        const type = entity['@type'];
+        for (const profile of readers) {
+            const rule = ruleFor(profile, type);
+            if (!rule || rule.status === 'none' || rule.status === 'retired')
+                continue;
+            const check = (properties, severity, verb) => {
+                for (const property of properties ?? []) {
+                    const setting = siteSettingFor(type, property);
+                    if (!setting || !isEmpty(entity.properties[property]) || !isEmpty(settings.site[setting]))
+                        continue;
+                    const message = `${profile.name} ${verb} "${property}" on ${type} (${rule.source}).`;
+                    findings.push({ severity, setting: `site.${setting}`, message });
+                }
+            };
+            check(rule.required, 'error', 'requires');
+            check(rule.recommended, 'warning', 'recommends');
+        }
+    }
+    return findings;
+}
+function unique(findings) {
+    const seen = new Set();
+    return findings.filter((f) => {
+        const key = `${f.severity}|${f.setting}|${f.message}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+/**
+ * Create a site's SEO subsystem from its loaded configuration: the site's
+ * identity from `site`, the active readers from `seo.readers`, and the types
+ * and site entities from the `seo` section and its definition files.
+ *
+ * Fails fast on what is required, and only on that: an unknown reader, a type
+ * the vocabulary lacks or has superseded or retired, or a value of the site's
+ * identity an active reader requires throws a {@link SeoConfigurationError}
+ * naming each setting. A value a reader only recommends is a warning in
+ * `findings` and never stops anything.
+ */
+export function createSeo(settings) {
+    const unknownReaders = settings.seo.readers.filter((id) => !getProfile(id));
+    const readers = settings.seo.readers.flatMap((id) => getProfile(id) ?? []);
+    const findings = unique([
+        ...unknownReaders.map((id) => ({
+            severity: 'error',
+            setting: 'seo.readers',
+            message: `No reader profile "${id}" is registered.`,
+        })),
+        ...configuredTypes(settings.seo).flatMap(([setting, type]) => typeFindings(setting, type)),
+        ...identityFindings(settings, readers),
+    ]);
+    const errors = findings.filter((f) => f.severity === 'error');
+    if (errors.length > 0)
+        throw new SeoConfigurationError(errors);
+    const site = { ...settings.site };
+    const ids = readers.map((profile) => profile.id);
+    return {
+        site,
+        readers: ids,
+        findings,
+        compose: (options) => composeFromConfig({ ...options, siteConfig: site }),
+        resolve: (options) => resolvePageEntities({ ...options, siteConfig: site }),
+        validate: (graph) => validateGraph(graph, { profiles: ids }),
+        features: (graph) => featureEligibility(graph, ids),
+    };
+}
+//# sourceMappingURL=create-seo.js.map

package/dist/create-seo.js.map

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

package/dist/decorators/breadcrumb.d.ts

@@ -0,0 +1,12 @@
+import type { TrailItem } from '@krantho/core';
+import type { SchemaEntity } from '../graph/types.js';
+import type { Decorator } from './types.js';
+/** A trail as BreadcrumbList items; the last one may leave out its URL */
+export declare function breadcrumbItems(trail: readonly TrailItem[]): SchemaEntity[];
+/**
+ * The page's place in the hierarchy: a BreadcrumbList from the trail it
+ * renders — a configured BreadcrumbList is built from the same trail — linked
+ * from the page node.
+ */
+export declare const breadcrumbDecorator: Decorator;
+//# sourceMappingURL=breadcrumb.d.ts.map