@krantho/seo 0.0.0-stage → 1.0.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumb.d.ts","sourceRoot":"","sources":["../../src/decorators/breadcrumb.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,YAAY,EAAE,CAO3E;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAkBjC,CAAA"}

package/dist/decorators/breadcrumb.js

@@ -0,0 +1,36 @@
+import { isA, nodeById, ref } from './nodes.js';
+/** A trail as BreadcrumbList items; the last one may leave out its URL */
+export function breadcrumbItems(trail) {
+    return trail.map((step, index) => ({
+        '@type': 'ListItem',
+        position: index + 1,
+        name: step.name,
+        ...(step.url ? { item: step.url } : {}),
+    }));
+}
+/**
+ * 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 const breadcrumbDecorator = {
+    id: 'breadcrumb',
+    decorate(graph, page) {
+        let list = graph.find((node) => isA(node, 'BreadcrumbList'));
+        if (!list) {
+            if (!page.trail?.length)
+                return graph;
+            list = {
+                '@type': 'BreadcrumbList',
+                '@id': `${page.pageId.replace(/#[^#]*$/, '')}#breadcrumb`,
+                itemListElement: breadcrumbItems(page.trail),
+            };
+            graph.push(list);
+        }
+        const node = nodeById(graph, page.pageId);
+        if (node && list['@id'] && node['breadcrumb'] === undefined)
+            node['breadcrumb'] = ref(list['@id']);
+        return graph;
+    },
+};
+//# sourceMappingURL=breadcrumb.js.map

package/dist/decorators/breadcrumb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumb.js","sourceRoot":"","sources":["../../src/decorators/breadcrumb.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AAG/C,0EAA0E;AAC1E,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACjC,OAAO,EAAE,UAAU;QACnB,QAAQ,EAAE,KAAK,GAAG,CAAC;QACnB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxC,CAAC,CAAC,CAAA;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAc;IAC5C,EAAE,EAAE,YAAY;IAChB,QAAQ,CAAC,KAAK,EAAE,IAAI;QAClB,IAAI,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAA;QAC5D,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM;gBAAE,OAAO,KAAK,CAAA;YACrC,IAAI,GAAG;gBACL,OAAO,EAAE,gBAAgB;gBACzB,KAAK,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,aAAa;gBACzD,eAAe,EAAE,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC;aAC7C,CAAA;YACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAClB,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;QACzC,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK,SAAS;YACzD,IAAI,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;QACvC,OAAO,KAAK,CAAA;IACd,CAAC;CACF,CAAA"}

package/dist/decorators/index.d.ts

@@ -0,0 +1,8 @@
+export { breadcrumbDecorator, breadcrumbItems } from './breadcrumb.js';
+export { pageDecorator, pageTypeFor } from './page.js';
+export { registerDecorator, registeredDecorators } from './registry.js';
+export { sequenceDecorator } from './sequence.js';
+export type { Decorator, PageContext, ResolvedStructure } from './types.js';
+/** krantho's decorators, in the order they run: the page node, then its trail, then its sequence */
+export declare const BUILT_IN_DECORATORS: readonly [import("./types.js").Decorator, import("./types.js").Decorator, import("./types.js").Decorator];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACtE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AACtD,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACjD,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAE3E,oGAAoG;AACpG,eAAO,MAAM,mBAAmB,2GAAmE,CAAA"}

package/dist/decorators/index.js

@@ -0,0 +1,13 @@
+import { breadcrumbDecorator } from './breadcrumb.js';
+import { pageDecorator } from './page.js';
+import { registerDecorator } from './registry.js';
+import { sequenceDecorator } from './sequence.js';
+export { breadcrumbDecorator, breadcrumbItems } from './breadcrumb.js';
+export { pageDecorator, pageTypeFor } from './page.js';
+export { registerDecorator, registeredDecorators } from './registry.js';
+export { sequenceDecorator } from './sequence.js';
+/** krantho's decorators, in the order they run: the page node, then its trail, then its sequence */
+export const BUILT_IN_DECORATORS = [pageDecorator, breadcrumbDecorator, sequenceDecorator];
+for (const decorator of BUILT_IN_DECORATORS)
+    registerDecorator(decorator);
+//# sourceMappingURL=index.js.map

package/dist/decorators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAEjD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACtE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AACtD,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAGjD,oGAAoG;AACpG,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,aAAa,EAAE,mBAAmB,EAAE,iBAAiB,CAAU,CAAA;AAEnG,KAAK,MAAM,SAAS,IAAI,mBAAmB;IAAE,iBAAiB,CAAC,SAAS,CAAC,CAAA"}

package/dist/decorators/nodes.d.ts

@@ -0,0 +1,12 @@
+import type { SchemaEntity } from '../graph/types.js';
+/** Whether the node is of the type or one of its subtypes */
+export declare function isA(node: SchemaEntity, type: string): boolean;
+/** The node with the `@id` */
+export declare function nodeById(graph: readonly SchemaEntity[], id: string): SchemaEntity | undefined;
+/** A reference to a node */
+export declare function ref(id: string): {
+    '@id': string;
+};
+/** Add a value to a property that may already hold one or several */
+export declare function addValue(node: SchemaEntity, property: string, value: unknown): void;
+//# sourceMappingURL=nodes.d.ts.map

package/dist/decorators/nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.d.ts","sourceRoot":"","sources":["../../src/decorators/nodes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAUrD,6DAA6D;AAC7D,wBAAgB,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,8BAA8B;AAC9B,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE7F;AAED,4BAA4B;AAC5B,wBAAgB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAEjD;AAED,qEAAqE;AACrE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAInF"}

package/dist/decorators/nodes.js

@@ -0,0 +1,29 @@
+import { isSubtypeOf } from '../vocabulary/index.js';
+/** The node's types, whether `@type` is one or several */
+function typesOf(node) {
+    const type = node['@type'];
+    if (typeof type === 'string')
+        return [type];
+    return Array.isArray(type) ? type.filter((t) => typeof t === 'string') : [];
+}
+/** Whether the node is of the type or one of its subtypes */
+export function isA(node, type) {
+    return typesOf(node).some((own) => isSubtypeOf(own, type));
+}
+/** The node with the `@id` */
+export function nodeById(graph, id) {
+    return graph.find((node) => node['@id'] === id);
+}
+/** A reference to a node */
+export function ref(id) {
+    return { '@id': id };
+}
+/** Add a value to a property that may already hold one or several */
+export function addValue(node, property, value) {
+    const current = node[property];
+    if (current === undefined)
+        node[property] = value;
+    else
+        node[property] = [...(Array.isArray(current) ? current : [current]), value];
+}
+//# sourceMappingURL=nodes.js.map

package/dist/decorators/nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.js","sourceRoot":"","sources":["../../src/decorators/nodes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAEpD,0DAA0D;AAC1D,SAAS,OAAO,CAAC,IAAkB;IACjC,MAAM,IAAI,GAAY,IAAI,CAAC,OAAO,CAAC,CAAA;IACnC,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3C,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AAC1F,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,GAAG,CAAC,IAAkB,EAAE,IAAY;IAClD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAA;AAC5D,CAAC;AAED,8BAA8B;AAC9B,MAAM,UAAU,QAAQ,CAAC,KAA8B,EAAE,EAAU;IACjE,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAA;AACjD,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,GAAG,CAAC,EAAU;IAC5B,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;AACtB,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,QAAQ,CAAC,IAAkB,EAAE,QAAgB,EAAE,KAAc;IAC3E,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC9B,IAAI,OAAO,KAAK,SAAS;QAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAA;;QAC5C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;AAClF,CAAC"}

package/dist/decorators/page.d.ts

@@ -0,0 +1,13 @@
+import type { Decorator } from './types.js';
+/**
+ * The Schema.org type of a page of the kind — a named kind, or a current
+ * WebPage type — or undefined when the kind names neither
+ */
+export declare function pageTypeFor(kind: string | undefined): string | undefined;
+/**
+ * The page node: the page's configured WebPage type, or a node of the type its
+ * kind names. It is part of the WebSite, its main entity is what the page is
+ * about, and it carries the page's URL, name, image, language and date.
+ */
+export declare const pageDecorator: Decorator;
+//# sourceMappingURL=page.d.ts.map

package/dist/decorators/page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../src/decorators/page.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAU3C;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAOxE;AAiBD;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,SAmB3B,CAAA"}

package/dist/decorators/page.js

@@ -0,0 +1,68 @@
+import { isEmpty } from '../types/values.js';
+import { getVocabularyType, isSubtypeOf, lifecycleOf } from '../vocabulary/index.js';
+import { isA, nodeById, ref } from './nodes.js';
+const PAGE_KINDS = {
+    item: 'ItemPage',
+    collection: 'CollectionPage',
+    about: 'AboutPage',
+    faq: 'FAQPage',
+    profile: 'ProfilePage',
+};
+/**
+ * The Schema.org type of a page of the kind — a named kind, or a current
+ * WebPage type — or undefined when the kind names neither
+ */
+export function pageTypeFor(kind) {
+    if (kind === undefined)
+        return 'WebPage';
+    const named = PAGE_KINDS[kind];
+    if (named)
+        return named;
+    if (!getVocabularyType(kind) || !isSubtypeOf(kind, 'WebPage'))
+        return undefined;
+    const status = lifecycleOf(kind)?.status;
+    return status === 'superseded' || status === 'retired' ? undefined : kind;
+}
+/** An image value as the ImageObject `primaryImageOfPage` takes */
+function imageObject(image) {
+    const first = Array.isArray(image) ? image[0] : image;
+    if (typeof first === 'string')
+        return { '@type': 'ImageObject', url: first };
+    if (first && typeof first === 'object' && first['@type'] === 'ImageObject') {
+        return first;
+    }
+    return undefined;
+}
+/** Set the property unless the node already has a value for it */
+function fill(node, property, value) {
+    if (isEmpty(node[property]) && !isEmpty(value))
+        node[property] = value;
+}
+/**
+ * The page node: the page's configured WebPage type, or a node of the type its
+ * kind names. It is part of the WebSite, its main entity is what the page is
+ * about, and it carries the page's URL, name, image, language and date.
+ */
+export const pageDecorator = {
+    id: 'page',
+    decorate(graph, page) {
+        let node = nodeById(graph, page.pageId);
+        if (!node) {
+            node = { '@type': pageTypeFor(page.kind) ?? 'WebPage', '@id': page.pageId };
+            graph.push(node);
+        }
+        const website = graph.find((entity) => isA(entity, 'WebSite'));
+        const main = page.mainEntityId ? nodeById(graph, page.mainEntityId) : undefined;
+        fill(node, 'url', page.url);
+        fill(node, 'name', page.title);
+        if (website?.['@id'])
+            fill(node, 'isPartOf', ref(website['@id']));
+        if (main?.['@id'])
+            fill(node, 'mainEntity', ref(main['@id']));
+        fill(node, 'primaryImageOfPage', imageObject(main?.['image']));
+        fill(node, 'dateModified', page.dateModified);
+        fill(node, 'inLanguage', page.language);
+        return graph;
+    },
+};
+//# sourceMappingURL=page.js.map

package/dist/decorators/page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.js","sourceRoot":"","sources":["../../src/decorators/page.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC5C,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACpF,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AAG/C,MAAM,UAAU,GAAqC;IACnD,IAAI,EAAE,UAAU;IAChB,UAAU,EAAE,gBAAgB;IAC5B,KAAK,EAAE,WAAW;IAClB,GAAG,EAAE,SAAS;IACd,OAAO,EAAE,aAAa;CACvB,CAAA;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAwB;IAClD,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IACxC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;IAC9B,IAAI,KAAK;QAAE,OAAO,KAAK,CAAA;IACvB,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC;QAAE,OAAO,SAAS,CAAA;IAC/E,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACxC,OAAO,MAAM,KAAK,YAAY,IAAI,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAA;AAC3E,CAAC;AAED,mEAAmE;AACnE,SAAS,WAAW,CAAC,KAAc;IACjC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,KAAK,EAAE,CAAA;IAC5E,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAK,KAAsB,CAAC,OAAO,CAAC,KAAK,aAAa,EAAE,CAAC;QAC7F,OAAO,KAAK,CAAA;IACd,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,kEAAkE;AAClE,SAAS,IAAI,CAAC,IAAkB,EAAE,QAAgB,EAAE,KAAc;IAChE,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAA;AACxE,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAc;IACtC,EAAE,EAAE,MAAM;IACV,QAAQ,CAAC,KAAK,EAAE,IAAI;QAClB,IAAI,IAAI,GAAG,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;QACvC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,EAAE,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,CAAA;YAC3E,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAClB,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAA;QAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QAC/E,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAA;QAC3B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;QAC9B,IAAI,OAAO,EAAE,CAAC,KAAK,CAAC;YAAE,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;QACjE,IAAI,IAAI,EAAE,CAAC,KAAK,CAAC;YAAE,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;QAC7D,IAAI,CAAC,IAAI,EAAE,oBAAoB,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;QAC9D,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,YAAY,CAAC,CAAA;QAC7C,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAA;QACvC,OAAO,KAAK,CAAA;IACd,CAAC;CACF,CAAA"}

package/dist/decorators/registry.d.ts

@@ -0,0 +1,11 @@
+import type { Decorator } from './types.js';
+/**
+ * Register a page-structure decorator. A site registers its own for
+ * structures krantho does not know, the same way krantho registers its
+ * built-ins; one with the id of a registered decorator replaces it in place.
+ * Returns a function that restores the previous registration.
+ */
+export declare function registerDecorator(decorator: Decorator): () => void;
+/** The registered decorators, in the order they run */
+export declare function registeredDecorators(): readonly Decorator[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/decorators/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/decorators/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAI3C;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,IAAI,CAWlE;AAED,uDAAuD;AACvD,wBAAgB,oBAAoB,IAAI,SAAS,SAAS,EAAE,CAE3D"}

package/dist/decorators/registry.js

@@ -0,0 +1,29 @@
+const decorators = [];
+/**
+ * Register a page-structure decorator. A site registers its own for
+ * structures krantho does not know, the same way krantho registers its
+ * built-ins; one with the id of a registered decorator replaces it in place.
+ * Returns a function that restores the previous registration.
+ */
+export function registerDecorator(decorator) {
+    const index = decorators.findIndex((registered) => registered.id === decorator.id);
+    const previous = index >= 0 ? decorators[index] : undefined;
+    if (index >= 0)
+        decorators[index] = decorator;
+    else
+        decorators.push(decorator);
+    return () => {
+        const at = decorators.indexOf(decorator);
+        if (at < 0)
+            return;
+        if (previous)
+            decorators[at] = previous;
+        else
+            decorators.splice(at, 1);
+    };
+}
+/** The registered decorators, in the order they run */
+export function registeredDecorators() {
+    return [...decorators];
+}
+//# sourceMappingURL=registry.js.map

package/dist/decorators/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/decorators/registry.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAgB,EAAE,CAAA;AAElC;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAoB;IACpD,MAAM,KAAK,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,KAAK,SAAS,CAAC,EAAE,CAAC,CAAA;IAClF,MAAM,QAAQ,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAC3D,IAAI,KAAK,IAAI,CAAC;QAAE,UAAU,CAAC,KAAK,CAAC,GAAG,SAAS,CAAA;;QACxC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAC/B,OAAO,GAAG,EAAE;QACV,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;QACxC,IAAI,EAAE,GAAG,CAAC;YAAE,OAAM;QAClB,IAAI,QAAQ;YAAE,UAAU,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAA;;YAClC,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;IAC/B,CAAC,CAAA;AACH,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,oBAAoB;IAClC,OAAO,CAAC,GAAG,UAAU,CAAC,CAAA;AACxB,CAAC"}

package/dist/decorators/sequence.d.ts

@@ -0,0 +1,8 @@
+import type { Decorator } from './types.js';
+/**
+ * The page's place in an ordered set — a docs area, a series: the set as a
+ * CollectionPage the page is part of, and the page's position in it. Order,
+ * as opposed to the hierarchy the breadcrumb states.
+ */
+export declare const sequenceDecorator: Decorator;
+//# sourceMappingURL=sequence.d.ts.map

package/dist/decorators/sequence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.d.ts","sourceRoot":"","sources":["../../src/decorators/sequence.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAY/B,CAAA"}

package/dist/decorators/sequence.js

@@ -0,0 +1,22 @@
+import { addValue, nodeById, ref } from './nodes.js';
+/**
+ * The page's place in an ordered set — a docs area, a series: the set as a
+ * CollectionPage the page is part of, and the page's position in it. Order,
+ * as opposed to the hierarchy the breadcrumb states.
+ */
+export const sequenceDecorator = {
+    id: 'sequence',
+    decorate(graph, page) {
+        const { sequence } = page;
+        const node = nodeById(graph, page.pageId);
+        if (!sequence || !node)
+            return graph;
+        const { name, url } = sequence.partOf;
+        if (!nodeById(graph, url))
+            graph.push({ '@type': 'CollectionPage', '@id': url, name, url });
+        addValue(node, 'isPartOf', ref(url));
+        node['position'] = sequence.position;
+        return graph;
+    },
+};
+//# sourceMappingURL=sequence.js.map

package/dist/decorators/sequence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.js","sourceRoot":"","sources":["../../src/decorators/sequence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AAGpD;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAc;IAC1C,EAAE,EAAE,UAAU;IACd,QAAQ,CAAC,KAAK,EAAE,IAAI;QAClB,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAA;QACzB,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;QACzC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,CAAA;QACpC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAA;QACrC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAA;QAC3F,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;QACpC,IAAI,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAA;QACpC,OAAO,KAAK,CAAA;IACd,CAAC;CACF,CAAA"}

package/dist/decorators/types.d.ts

@@ -0,0 +1,30 @@
+import type { PageStructure, TrailItem } from '@krantho/core';
+import type { SchemaEntity, SeoGraphConfig } from '../graph/types.js';
+/** The page a graph describes, as the decorators see it */
+export interface PageContext {
+    readonly site: SeoGraphConfig;
+    readonly path: string;
+    /** The page's absolute URL */
+    readonly url: string;
+    /** The `@id` of the page node: a configured WebPage type of the page, or `<url>/#webpage` */
+    readonly pageId: string;
+    /** The `@id` of the entity the page is about, when it has one besides the page itself */
+    readonly mainEntityId?: string | undefined;
+    readonly title?: string | undefined;
+    readonly language?: string | undefined;
+    readonly dateModified?: string | undefined;
+}
+/** A page's structure with every trail URL absolute and the page itself last */
+export interface ResolvedStructure extends PageStructure {
+    readonly trail?: readonly TrailItem[] | undefined;
+}
+/**
+ * Turns a fact of the page's structure into graph nodes and edges. Decorators
+ * run in registration order after the entities are built and their references
+ * resolved; each returns the graph it was given, changed.
+ */
+export interface Decorator {
+    readonly id: string;
+    decorate(graph: SchemaEntity[], page: PageContext & ResolvedStructure): SchemaEntity[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/decorators/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAErE,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,8BAA8B;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,6FAA6F;IAC7F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,yFAAyF;IACzF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC3C;AAED,gFAAgF;AAChF,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,CAAA;CAClD;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,WAAW,GAAG,iBAAiB,GAAG,YAAY,EAAE,CAAA;CACvF"}

package/dist/decorators/types.js

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

package/dist/decorators/types.js.map

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

package/dist/define-seo.d.ts

@@ -0,0 +1,21 @@
+import type { Decorator } from './decorators/index.js';
+import type { ReaderProfile } from './profiles/index.js';
+import type { TypeDefinition } from './types/index.js';
+/** What a site adds to krantho's structured data */
+export interface SeoExtensions {
+    /** How the site's own Schema.org types are built, or how a built-in one is built differently */
+    readonly types?: readonly TypeDefinition[] | undefined;
+    /** Readers besides Google and Bing; activate one with `seo.readers` */
+    readonly profiles?: readonly ReaderProfile[] | undefined;
+    /** Page structures krantho does not know, decorated after the built-in ones */
+    readonly decorators?: readonly Decorator[] | undefined;
+}
+/**
+ * Register a site's own types, reader profiles and page-structure decorators,
+ * all or none: when one is refused (an unknown or retired type, a rule without
+ * a source), the ones registered before it are removed and the error is
+ * thrown. Call it once, in a module the server loads before it renders pages.
+ * Returns a function that restores what was registered before.
+ */
+export declare function defineSeo(extensions: SeoExtensions): () => void;
+//# sourceMappingURL=define-seo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define-seo.d.ts","sourceRoot":"","sources":["../src/define-seo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAEtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAGtD,oDAAoD;AACpD,MAAM,WAAW,aAAa;IAC5B,gGAAgG;IAChG,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,cAAc,EAAE,GAAG,SAAS,CAAA;IACtD,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,aAAa,EAAE,GAAG,SAAS,CAAA;IACxD,+EAA+E;IAC/E,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,CAAA;CACvD;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,aAAa,GAAG,MAAM,IAAI,CAc/D"}

package/dist/define-seo.js

@@ -0,0 +1,31 @@
+import { registerDecorator } from './decorators/index.js';
+import { registerProfile } from './profiles/index.js';
+import { registerType } from './types/index.js';
+/**
+ * Register a site's own types, reader profiles and page-structure decorators,
+ * all or none: when one is refused (an unknown or retired type, a rule without
+ * a source), the ones registered before it are removed and the error is
+ * thrown. Call it once, in a module the server loads before it renders pages.
+ * Returns a function that restores what was registered before.
+ */
+export function defineSeo(extensions) {
+    const restores = [];
+    const restoreAll = () => {
+        for (const restore of restores.reverse())
+            restore();
+    };
+    try {
+        for (const type of extensions.types ?? [])
+            restores.push(registerType(type));
+        for (const profile of extensions.profiles ?? [])
+            restores.push(registerProfile(profile));
+        for (const decorator of extensions.decorators ?? [])
+            restores.push(registerDecorator(decorator));
+    }
+    catch (error) {
+        restoreAll();
+        throw error;
+    }
+    return restoreAll;
+}
+//# sourceMappingURL=define-seo.js.map

package/dist/define-seo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-seo.js","sourceRoot":"","sources":["../src/define-seo.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAEzD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAErD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAY/C;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,UAAyB;IACjD,MAAM,QAAQ,GAAsB,EAAE,CAAA;IACtC,MAAM,UAAU,GAAG,GAAS,EAAE;QAC5B,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE;YAAE,OAAO,EAAE,CAAA;IACrD,CAAC,CAAA;IACD,IAAI,CAAC;QACH,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,IAAI,EAAE;YAAE,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAA;QAC5E,KAAK,MAAM,OAAO,IAAI,UAAU,CAAC,QAAQ,IAAI,EAAE;YAAE,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAA;QACxF,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,UAAU,IAAI,EAAE;YAAE,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAA;IAClG,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,UAAU,EAAE,CAAA;QACZ,MAAM,KAAK,CAAA;IACb,CAAC;IACD,OAAO,UAAU,CAAA;AACnB,CAAC"}

package/dist/graph/build-entity.d.ts

@@ -0,0 +1,47 @@
+import '../types/built-in/index.js';
+import type { TrailItem } from '@krantho/core';
+import type { EntityLevel, ReferenceRule, ResolvedProperty, TypeDefinition } from '../types/definition.js';
+import type { ComputedValues } from './resolve-properties.js';
+import type { SchemaEntity, SeoGraphConfig } from './types.js';
+/** What one entity is built from */
+export interface EntityInput {
+    readonly type: string;
+    readonly level: EntityLevel;
+    /** The entity's `@id` as configured; derived from its type when absent */
+    readonly id?: string | undefined;
+    readonly configured: Readonly<Record<string, unknown>>;
+    readonly fields: Readonly<Record<string, unknown>>;
+    readonly fieldMappings?: Readonly<Record<string, string>> | undefined;
+    readonly computed: ComputedValues;
+    readonly site: SeoGraphConfig;
+    readonly path: string;
+    readonly title?: string | undefined;
+    readonly faq?: ReadonlyArray<{
+        question: string;
+        answer: string;
+    }> | undefined;
+    readonly trail?: readonly TrailItem[] | undefined;
+}
+/** A built entity with what the composer needs to finish the graph */
+export interface ComposedNode {
+    readonly entity: SchemaEntity;
+    readonly level: EntityLevel;
+    readonly references: Readonly<Record<string, ReferenceRule>>;
+}
+/** Whether a resolved value belongs on the entity the builder made */
+export declare function carries(property: string, resolved: ResolvedProperty, type: string, definition: TypeDefinition | undefined): boolean;
+/** An entity's definition, `@id` and resolved values — what building it starts from */
+export declare function entityInputValues(input: EntityInput): {
+    definition: TypeDefinition | undefined;
+    id: string;
+    values: Map<string, ResolvedProperty>;
+};
+/**
+ * Build one entity: resolve its property values, let the type's definition
+ * shape it (a typed node with no properties when none is registered), then
+ * carry every resolved value the builder left out and the type accepts — so
+ * no builder can drop a configured or computed value. A nested node from
+ * content gets the type its property names.
+ */
+export declare function buildEntity(input: EntityInput): ComposedNode;
+//# sourceMappingURL=build-entity.d.ts.map

package/dist/graph/build-entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-entity.d.ts","sourceRoot":"","sources":["../../src/graph/build-entity.ts"],"names":[],"mappings":"AAAA,OAAO,4BAA4B,CAAA;AACnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAEV,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,cAAc,EACf,MAAM,wBAAwB,CAAA;AAK/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAG7D,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAE9D,oCAAoC;AACpC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACtD,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAClD,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;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,QAAQ,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS,CAAA;IAC9E,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,CAAA;CAClD;AAED,sEAAsE;AACtE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAA;CAC7D;AAYD,sEAAsE;AACtE,wBAAgB,OAAO,CACrB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,cAAc,GAAG,SAAS,GACrC,OAAO,CAUT;AAED,uFAAuF;AACvF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG;IACrD,UAAU,EAAE,cAAc,GAAG,SAAS,CAAA;IACtC,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;CACtC,CAIA;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAwB5D"}

package/dist/graph/build-entity.js

@@ -0,0 +1,69 @@
+import '../types/built-in/index.js';
+import { getTypeDefinition } from '../types/registry.js';
+import { isEmpty } from '../types/values.js';
+import { isPropertyOfType, isSubtypeOf } from '../vocabulary/index.js';
+import { businessId, documentId } from './id-conventions.js';
+import { resolveProperties } from './resolve-properties.js';
+import { typedValue } from './typed-value.js';
+/** The `@id` of an entity without a configured one */
+function entityId(input, definition) {
+    const { baseUrl } = input.site;
+    const path = input.level === 'site' ? '' : input.path;
+    if (definition)
+        return documentId(baseUrl, definition.scope === 'site' ? '' : path, definition.idFragment);
+    if (input.level === 'site' && isSubtypeOf(input.type, 'Organization'))
+        return businessId(baseUrl);
+    return documentId(baseUrl, path, input.type.toLowerCase());
+}
+/** Whether a resolved value belongs on the entity the builder made */
+export function carries(property, resolved, type, definition) {
+    if (resolved.source === 'manual')
+        return true;
+    if (resolved.source === 'computed' &&
+        definition?.computed &&
+        !definition.computed.includes(property)) {
+        return false;
+    }
+    return isPropertyOfType(property, type);
+}
+/** An entity's definition, `@id` and resolved values — what building it starts from */
+export function entityInputValues(input) {
+    const definition = getTypeDefinition(input.type);
+    const id = input.id ?? entityId(input, definition);
+    return { definition, id, values: resolveProperties({ ...input, definition }) };
+}
+/**
+ * Build one entity: resolve its property values, let the type's definition
+ * shape it (a typed node with no properties when none is registered), then
+ * carry every resolved value the builder left out and the type accepts — so
+ * no builder can drop a configured or computed value. A nested node from
+ * content gets the type its property names.
+ */
+export function buildEntity(input) {
+    const { definition, id, values } = entityInputValues(input);
+    const context = {
+        type: input.type,
+        id,
+        level: input.level,
+        site: input.site,
+        path: input.level === 'site' ? '/' : input.path,
+        values,
+        title: input.title,
+        faq: input.faq,
+        trail: input.trail,
+    };
+    const entity = definition
+        ? definition.build(context)
+        : { '@type': input.type, '@id': id };
+    for (const [property, resolved] of values) {
+        if (!isEmpty(entity[property]))
+            continue;
+        if (!carries(property, resolved, input.type, definition))
+            continue;
+        // Configured values are carried as set; validation reports what does not conform.
+        entity[property] =
+            resolved.source === 'manual' ? resolved.value : typedValue(property, resolved.value);
+    }
+    return { entity, level: input.level, references: definition?.references ?? {} };
+}
+//# sourceMappingURL=build-entity.js.map

package/dist/graph/build-entity.js.map

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