@krantho/seo 0.0.0-stage → 1.0.0

package/dist/types/built-in/site.js

@@ -0,0 +1,35 @@
+import { ORGANIZATION_RULE, siteOrganization } from '../context.js';
+/**
+ * The site's organization. Its identity — name, address, logo, description,
+ * profiles — comes from the site configuration and is carried by the
+ * composer; the builder only places it.
+ */
+export const organizationType = {
+    type: 'Organization',
+    scope: 'site',
+    idFragment: 'business',
+    build: (context) => ({ '@type': context.type, '@id': context.id }),
+};
+/** A business with a physical location, identified like the Organization */
+export const localBusinessType = { ...organizationType, type: 'LocalBusiness' };
+/** The website, published by the site's organization */
+export const webSiteType = {
+    type: 'WebSite',
+    scope: 'site',
+    idFragment: 'website',
+    references: { publisher: ORGANIZATION_RULE },
+    build: (context) => ({
+        '@type': context.type,
+        '@id': context.id,
+        publisher: siteOrganization(context),
+    }),
+};
+/** The person behind the site, named by the content's author when a page describes them */
+export const personType = {
+    type: 'Person',
+    scope: 'site',
+    idFragment: 'person',
+    fields: { name: ['author'] },
+    build: (context) => ({ '@type': context.type, '@id': context.id }),
+};
+//# sourceMappingURL=site.js.map

package/dist/types/built-in/site.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site.js","sourceRoot":"","sources":["../../../src/types/built-in/site.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAGnE;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC9C,IAAI,EAAE,cAAc;IACpB,KAAK,EAAE,MAAM;IACb,UAAU,EAAE,UAAU;IACtB,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;CACnE,CAAA;AAED,4EAA4E;AAC5E,MAAM,CAAC,MAAM,iBAAiB,GAAmB,EAAE,GAAG,gBAAgB,EAAE,IAAI,EAAE,eAAe,EAAE,CAAA;AAE/F,wDAAwD;AACxD,MAAM,CAAC,MAAM,WAAW,GAAmB;IACzC,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,MAAM;IACb,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,EAAE,SAAS,EAAE,iBAAiB,EAAE;IAC5C,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACnB,OAAO,EAAE,OAAO,CAAC,IAAI;QACrB,KAAK,EAAE,OAAO,CAAC,EAAE;QACjB,SAAS,EAAE,gBAAgB,CAAC,OAAO,CAAC;KACrC,CAAC;CACH,CAAA;AAED,2FAA2F;AAC3F,MAAM,CAAC,MAAM,UAAU,GAAmB;IACxC,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,MAAM;IACb,UAAU,EAAE,QAAQ;IACpB,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE;IAC5B,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;CACnE,CAAA"}

package/dist/types/context.d.ts

@@ -0,0 +1,26 @@
+import type { BuildContext, ReferenceRule } from './definition.js';
+/** A property's resolved value */
+export declare function propertyValue(context: BuildContext, property: string): unknown;
+/** A property's resolved value as a string, '' when absent or not text */
+export declare function textOf(context: BuildContext, property: string): string;
+/** The site's organization, which publishes, provides and organizes on the site's behalf */
+export declare function siteOrganization(context: BuildContext): {
+    '@id': string;
+};
+/** The site entity a WebSite reference points at */
+export declare function siteWebsite(context: BuildContext): {
+    '@id': string;
+};
+/**
+ * The author: the content's own (a name becomes a Person; a node is kept as
+ * it is), else a reference to the site's Person, which the composer
+ * resolves by `AUTHOR_RULE`.
+ */
+export declare function authorOf(context: BuildContext): unknown;
+/** An author is the configured Person, else the publishing Organization */
+export declare const AUTHOR_RULE: ReferenceRule;
+/** Publisher, provider, organizer, hiring organization: the site's Organization */
+export declare const ORGANIZATION_RULE: ReferenceRule;
+/** The WebSite a page belongs to, when the site configures one */
+export declare const WEBSITE_RULE: ReferenceRule;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/types/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAGlE,kCAAkC;AAClC,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE9E;AAED,0EAA0E;AAC1E,wBAAgB,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAEzE;AAED,oDAAoD;AACpD,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAKvD;AAED,2EAA2E;AAC3E,eAAO,MAAM,WAAW,EAAE,aAGzB,CAAA;AAED,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,EAAE,aAG/B,CAAA;AAED,kEAAkE;AAClE,eAAO,MAAM,YAAY,EAAE,aAAuD,CAAA"}

package/dist/types/context.js

@@ -0,0 +1,44 @@
+import { businessId, personId, websiteId } from '../graph/id-conventions.js';
+import { asString, ref } from './values.js';
+/** A property's resolved value */
+export function propertyValue(context, property) {
+    return context.values.get(property)?.value;
+}
+/** A property's resolved value as a string, '' when absent or not text */
+export function textOf(context, property) {
+    return asString(propertyValue(context, property));
+}
+/** The site's organization, which publishes, provides and organizes on the site's behalf */
+export function siteOrganization(context) {
+    return ref(businessId(context.site.baseUrl));
+}
+/** The site entity a WebSite reference points at */
+export function siteWebsite(context) {
+    return ref(websiteId(context.site.baseUrl));
+}
+/**
+ * The author: the content's own (a name becomes a Person; a node is kept as
+ * it is), else a reference to the site's Person, which the composer
+ * resolves by `AUTHOR_RULE`.
+ */
+export function authorOf(context) {
+    const author = propertyValue(context, 'author');
+    if (typeof author === 'string' && author.length > 0)
+        return { '@type': 'Person', name: author };
+    if (author && typeof author === 'object')
+        return author;
+    return ref(personId(context.site.baseUrl));
+}
+/** An author is the configured Person, else the publishing Organization */
+export const AUTHOR_RULE = {
+    types: ['Person', 'Organization'],
+    resolve: 'site-entity',
+};
+/** Publisher, provider, organizer, hiring organization: the site's Organization */
+export const ORGANIZATION_RULE = {
+    types: ['Organization', 'Person'],
+    resolve: 'site-entity',
+};
+/** The WebSite a page belongs to, when the site configures one */
+export const WEBSITE_RULE = { types: ['WebSite'], resolve: 'omit' };
+//# sourceMappingURL=context.js.map

package/dist/types/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/types/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAE5E,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,aAAa,CAAA;AAE3C,kCAAkC;AAClC,MAAM,UAAU,aAAa,CAAC,OAAqB,EAAE,QAAgB;IACnE,OAAO,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAA;AAC5C,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,MAAM,CAAC,OAAqB,EAAE,QAAgB;IAC5D,OAAO,QAAQ,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAA;AACnD,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,gBAAgB,CAAC,OAAqB;IACpD,OAAO,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;AAC9C,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,WAAW,CAAC,OAAqB;IAC/C,OAAO,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;AAC7C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAqB;IAC5C,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IAC/C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IAC/F,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAA;IACvD,OAAO,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;AAC5C,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,MAAM,WAAW,GAAkB;IACxC,KAAK,EAAE,CAAC,QAAQ,EAAE,cAAc,CAAC;IACjC,OAAO,EAAE,aAAa;CACvB,CAAA;AAED,mFAAmF;AACnF,MAAM,CAAC,MAAM,iBAAiB,GAAkB;IAC9C,KAAK,EAAE,CAAC,cAAc,EAAE,QAAQ,CAAC;IACjC,OAAO,EAAE,aAAa;CACvB,CAAA;AAED,kEAAkE;AAClE,MAAM,CAAC,MAAM,YAAY,GAAkB,EAAE,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAA"}

package/dist/types/definition.d.ts

@@ -0,0 +1,58 @@
+import type { TrailItem } from '@krantho/core';
+import type { PropertySource } from '../catalog/property-atoms.js';
+import type { SchemaEntity, SeoGraphConfig } from '../graph/types.js';
+/** A property's effective value and where it comes from */
+export interface ResolvedProperty {
+    readonly value: unknown;
+    readonly source: PropertySource;
+    /** Where the value was read: a content field, a configuration setting, or how it was computed */
+    readonly origin: string;
+}
+/** Whether an entity describes the site as a whole or the page being rendered */
+export type EntityLevel = 'site' | 'document';
+/** What a type definition builds an entity from */
+export interface BuildContext {
+    /** The Schema.org type being built — the definition's own, or a configured subtype */
+    readonly type: string;
+    readonly id: string;
+    readonly level: EntityLevel;
+    readonly site: SeoGraphConfig;
+    /** The page path, `/` for site entities */
+    readonly path: string;
+    /** Every property's resolved value, by Schema.org property name */
+    readonly values: ReadonlyMap<string, ResolvedProperty>;
+    /** The page's title, as its content states it */
+    readonly title?: string | undefined;
+    /** Question and answer pairs the page renders */
+    readonly faq?: ReadonlyArray<{
+        question: string;
+        answer: string;
+    }> | undefined;
+    /** The trail the page renders, root first, with absolute URLs */
+    readonly trail?: readonly TrailItem[] | undefined;
+}
+/** How the composer satisfies a reference whose target is not in the graph */
+export interface ReferenceRule {
+    /** Acceptable target types, in order of preference */
+    readonly types: readonly string[];
+    /** `site-entity`: point it at a site entity of an acceptable type; `omit`: remove it */
+    readonly resolve: 'site-entity' | 'omit';
+}
+/** How krantho builds one Schema.org type */
+export interface TypeDefinition {
+    /** The Schema.org type; it must exist in the vocabulary and be current */
+    readonly type: string;
+    /** `site`: one entity for the whole site, whose `@id` does not depend on the page */
+    readonly scope: 'site' | 'document';
+    /** The `@id` fragment: `#article`, `#business` … */
+    readonly idFragment: string;
+    /** Content fields, besides one named after the property, that hold a property's value */
+    readonly fields?: Readonly<Record<string, readonly string[]>> | undefined;
+    /** Computed page properties the entity carries; all of them when absent */
+    readonly computed?: readonly string[] | undefined;
+    /** Properties whose values are references the composer must resolve */
+    readonly references?: Readonly<Record<string, ReferenceRule>> | undefined;
+    /** The entity's structure; values the builder leaves out are carried by the composer */
+    build(context: BuildContext): SchemaEntity;
+}
+//# sourceMappingURL=definition.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/types/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAErE,2DAA2D;AAC3D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,iGAAiG;IACjG,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,iFAAiF;AACjF,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,CAAA;AAE7C,mDAAmD;AACnD,MAAM,WAAW,YAAY;IAC3B,sFAAsF;IACtF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;IAC7B,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;IACtD,iDAAiD;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,iDAAiD;IACjD,QAAQ,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS,CAAA;IAC9E,iEAAiE;IACjE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,CAAA;CAClD;AAED,8EAA8E;AAC9E,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,wFAAwF;IACxF,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAAA;CACzC;AAED,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,qFAAqF;IACrF,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAAA;IACnC,oDAAoD;IACpD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,yFAAyF;IACzF,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,GAAG,SAAS,CAAA;IACzE,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IACjD,uEAAuE;IACvE,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,GAAG,SAAS,CAAA;IACzE,wFAAwF;IACxF,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,CAAA;CAC3C"}

package/dist/types/definition.js

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

package/dist/types/definition.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,4 @@
+export { BUILT_IN_TYPES } from './built-in/index.js';
+export type { BuildContext, EntityLevel, ReferenceRule, ResolvedProperty, TypeDefinition, } from './definition.js';
+export { getTypeDefinition, registeredTypes, registerType } from './registry.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,YAAY,EACV,YAAY,EACZ,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,cAAc,GACf,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA"}

package/dist/types/index.js

@@ -0,0 +1,3 @@
+export { BUILT_IN_TYPES } from './built-in/index.js';
+export { getTypeDefinition, registeredTypes, registerType } from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAQpD,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA"}

package/dist/types/registry.d.ts

@@ -0,0 +1,14 @@
+import type { TypeDefinition } from './definition.js';
+/**
+ * Register how a Schema.org type is built. A site registers its own types the
+ * same way krantho registers its built-ins; a later registration for a type
+ * replaces the earlier one. Throws for a type the vocabulary does not have, or
+ * one Schema.org has superseded or retired. Returns a function that restores
+ * the previous registration.
+ */
+export declare function registerType(definition: TypeDefinition): () => void;
+/** The definition registered for the type; undefined builds it generically */
+export declare function getTypeDefinition(type: string): TypeDefinition | undefined;
+/** The types with a registered definition */
+export declare function registeredTypes(): readonly string[];
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/types/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAIrD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,IAAI,CAenE;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAE1E;AAED,6CAA6C;AAC7C,wBAAgB,eAAe,IAAI,SAAS,MAAM,EAAE,CAEnD"}

package/dist/types/registry.js

@@ -0,0 +1,37 @@
+import { getVocabularyType, lifecycleOf } from '../vocabulary/index.js';
+const definitions = new Map();
+/**
+ * Register how a Schema.org type is built. A site registers its own types the
+ * same way krantho registers its built-ins; a later registration for a type
+ * replaces the earlier one. Throws for a type the vocabulary does not have, or
+ * one Schema.org has superseded or retired. Returns a function that restores
+ * the previous registration.
+ */
+export function registerType(definition) {
+    if (!getVocabularyType(definition.type)) {
+        throw new Error(`registerType: "${definition.type}" is not a Schema.org type.`);
+    }
+    const lifecycle = lifecycleOf(definition.type);
+    if (lifecycle?.status === 'superseded' || lifecycle?.status === 'retired') {
+        throw new Error(`registerType: "${definition.type}" is ${lifecycle.status} in Schema.org.`);
+    }
+    const previous = definitions.get(definition.type);
+    definitions.set(definition.type, definition);
+    return () => {
+        if (definitions.get(definition.type) !== definition)
+            return;
+        if (previous)
+            definitions.set(definition.type, previous);
+        else
+            definitions.delete(definition.type);
+    };
+}
+/** The definition registered for the type; undefined builds it generically */
+export function getTypeDefinition(type) {
+    return definitions.get(type);
+}
+/** The types with a registered definition */
+export function registeredTypes() {
+    return [...definitions.keys()];
+}
+//# sourceMappingURL=registry.js.map

package/dist/types/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/types/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAGvE,MAAM,WAAW,GAAG,IAAI,GAAG,EAA0B,CAAA;AAErD;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,UAA0B;IACrD,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,kBAAkB,UAAU,CAAC,IAAI,6BAA6B,CAAC,CAAA;IACjF,CAAC;IACD,MAAM,SAAS,GAAG,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;IAC9C,IAAI,SAAS,EAAE,MAAM,KAAK,YAAY,IAAI,SAAS,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC;QAC1E,MAAM,IAAI,KAAK,CAAC,kBAAkB,UAAU,CAAC,IAAI,QAAQ,SAAS,CAAC,MAAM,iBAAiB,CAAC,CAAA;IAC7F,CAAC;IACD,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;IACjD,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;IAC5C,OAAO,GAAG,EAAE;QACV,IAAI,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,UAAU;YAAE,OAAM;QAC3D,IAAI,QAAQ;YAAE,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;;YACnD,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;IAC1C,CAAC,CAAA;AACH,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;AAC9B,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,CAAA;AAChC,CAAC"}

package/dist/types/values.d.ts

@@ -0,0 +1,23 @@
+import type { SchemaEntity } from '../graph/types.js';
+/** Whether a value carries nothing: undefined, null, an empty string or an empty array */
+export declare function isEmpty(value: unknown): boolean;
+/** A string value, or '' when the value is not a string */
+export declare function asString(value: unknown): string;
+/**
+ * A list of strings: an array's string entries, a comma-separated string
+ * split, or a single string. Empty entries are dropped.
+ */
+export declare function asStringList(value: unknown): string[];
+/** The entity without empty properties, so JSON-LD output stays clean */
+export declare function compact(entity: SchemaEntity): SchemaEntity;
+/**
+ * A sub-entity from a value that is either an object (its properties, typed)
+ * or a string (wrapped as `{ '@type': type, [stringKey]: value }`); undefined
+ * when there is nothing to wrap.
+ */
+export declare function asSubEntity(value: unknown, type: string, stringKey: string): SchemaEntity | undefined;
+/** A reference to the node with that `@id` */
+export declare function ref(id: string): {
+    '@id': string;
+};
+//# sourceMappingURL=values.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../src/types/values.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,0FAA0F;AAC1F,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAI/C;AAED,2DAA2D;AAC3D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE/C;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAOrD;AAED,yEAAyE;AACzE,wBAAgB,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAM1D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,YAAY,GAAG,SAAS,CAQ1B;AAED,8CAA8C;AAC9C,wBAAgB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAEjD"}

package/dist/types/values.js

@@ -0,0 +1,52 @@
+/** Whether a value carries nothing: undefined, null, an empty string or an empty array */
+export function isEmpty(value) {
+    if (value === undefined || value === null)
+        return true;
+    if (typeof value === 'string')
+        return value.length === 0;
+    return Array.isArray(value) && value.length === 0;
+}
+/** A string value, or '' when the value is not a string */
+export function asString(value) {
+    return typeof value === 'string' ? value : '';
+}
+/**
+ * A list of strings: an array's string entries, a comma-separated string
+ * split, or a single string. Empty entries are dropped.
+ */
+export function asStringList(value) {
+    const items = Array.isArray(value)
+        ? value.filter((v) => typeof v === 'string')
+        : typeof value === 'string'
+            ? value.split(',')
+            : [];
+    return items.map((s) => s.trim()).filter((s) => s.length > 0);
+}
+/** The entity without empty properties, so JSON-LD output stays clean */
+export function compact(entity) {
+    const result = { '@type': entity['@type'] };
+    for (const [key, value] of Object.entries(entity)) {
+        if (!isEmpty(value))
+            result[key] = value;
+    }
+    return result;
+}
+/**
+ * A sub-entity from a value that is either an object (its properties, typed)
+ * or a string (wrapped as `{ '@type': type, [stringKey]: value }`); undefined
+ * when there is nothing to wrap.
+ */
+export function asSubEntity(value, type, stringKey) {
+    if (value && typeof value === 'object' && !Array.isArray(value)) {
+        return compact({ '@type': type, ...value });
+    }
+    if (typeof value === 'string' && value.length > 0) {
+        return compact({ '@type': type, [stringKey]: value });
+    }
+    return undefined;
+}
+/** A reference to the node with that `@id` */
+export function ref(id) {
+    return { '@id': id };
+}
+//# sourceMappingURL=values.js.map

package/dist/types/values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.js","sourceRoot":"","sources":["../../src/types/values.ts"],"names":[],"mappings":"AAEA,0FAA0F;AAC1F,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IACtD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAA;IACxD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,CAAA;AACnD,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAChC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;QACzD,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ;YACzB,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC;YAClB,CAAC,CAAC,EAAE,CAAA;IACR,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;AAC/D,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,OAAO,CAAC,MAAoB;IAC1C,MAAM,MAAM,GAAiB,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,CAAA;IACzD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;IAC1C,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CACzB,KAAc,EACd,IAAY,EACZ,SAAiB;IAEjB,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,OAAO,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,GAAI,KAAiC,EAAE,CAAC,CAAA;IAC1E,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,OAAO,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;IACvD,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,GAAG,CAAC,EAAU;IAC5B,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;AACtB,CAAC"}

package/dist/validate/check-terms.d.ts

@@ -0,0 +1,15 @@
+import type { Finding } from './types.js';
+/** What kind of term is checked, for the message */
+export type TermKind = 'Type' | 'Property' | 'Value';
+/** Where the term appears */
+export interface TermContext {
+    nodeId?: string | undefined;
+    type?: string | undefined;
+    property?: string | undefined;
+}
+/**
+ * Life-cycle findings for a Schema.org term: superseded and retired terms are
+ * errors (the message names the replacement), a pending term is information.
+ */
+export declare function termFindings(kind: TermKind, term: string, context: TermContext): Finding[];
+//# sourceMappingURL=check-terms.d.ts.map

package/dist/validate/check-terms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-terms.d.ts","sourceRoot":"","sources":["../../src/validate/check-terms.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEzC,oDAAoD;AACpD,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAA;AAEpD,6BAA6B;AAC7B,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC9B;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,EAAE,CAkC1F"}

package/dist/validate/check-terms.js

@@ -0,0 +1,42 @@
+import { lifecycleOf, termName } from '../vocabulary/index.js';
+/**
+ * Life-cycle findings for a Schema.org term: superseded and retired terms are
+ * errors (the message names the replacement), a pending term is information.
+ */
+export function termFindings(kind, term, context) {
+    const lifecycle = lifecycleOf(term);
+    if (!lifecycle)
+        return [];
+    const name = termName(term);
+    const base = { profile: 'schema.org', ...context };
+    switch (lifecycle.status) {
+        case 'superseded':
+            return [
+                {
+                    ...base,
+                    severity: 'error',
+                    code: 'superseded-term',
+                    message: `${kind} "${name}" is superseded by "${lifecycle.by}" in Schema.org.`,
+                },
+            ];
+        case 'retired':
+            return [
+                {
+                    ...base,
+                    severity: 'error',
+                    code: 'retired-term',
+                    message: `${kind} "${name}" is retired from Schema.org.`,
+                },
+            ];
+        case 'pending':
+            return [
+                {
+                    ...base,
+                    severity: 'info',
+                    code: 'pending-term',
+                    message: `${kind} "${name}" is a pending Schema.org term, not yet part of the core vocabulary.`,
+                },
+            ];
+    }
+}
+//# sourceMappingURL=check-terms.js.map

package/dist/validate/check-terms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-terms.js","sourceRoot":"","sources":["../../src/validate/check-terms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAa9D;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAc,EAAE,IAAY,EAAE,OAAoB;IAC7E,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;IACnC,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,CAAA;IACzB,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC3B,MAAM,IAAI,GAAG,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,EAAE,CAAA;IAClD,QAAQ,SAAS,CAAC,MAAM,EAAE,CAAC;QACzB,KAAK,YAAY;YACf,OAAO;gBACL;oBACE,GAAG,IAAI;oBACP,QAAQ,EAAE,OAAO;oBACjB,IAAI,EAAE,iBAAiB;oBACvB,OAAO,EAAE,GAAG,IAAI,KAAK,IAAI,uBAAuB,SAAS,CAAC,EAAE,kBAAkB;iBAC/E;aACF,CAAA;QACH,KAAK,SAAS;YACZ,OAAO;gBACL;oBACE,GAAG,IAAI;oBACP,QAAQ,EAAE,OAAO;oBACjB,IAAI,EAAE,cAAc;oBACpB,OAAO,EAAE,GAAG,IAAI,KAAK,IAAI,+BAA+B;iBACzD;aACF,CAAA;QACH,KAAK,SAAS;YACZ,OAAO;gBACL;oBACE,GAAG,IAAI;oBACP,QAAQ,EAAE,MAAM;oBAChB,IAAI,EAAE,cAAc;oBACpB,OAAO,EAAE,GAAG,IAAI,KAAK,IAAI,sEAAsE;iBAChG;aACF,CAAA;IACL,CAAC;AACH,CAAC"}

package/dist/validate/check-value.d.ts

@@ -0,0 +1,19 @@
+import type { Finding, GraphNode } from './types.js';
+/** Where a value appears */
+export interface ValuePlace {
+    nodeId?: string | undefined;
+    type?: string | undefined;
+    property: string;
+}
+/** The value's place, and the graph's node definitions by `@id` */
+export interface ValueContext {
+    where: ValuePlace;
+    definitions: ReadonlyMap<string, GraphNode>;
+}
+/**
+ * Findings for one value of a property: a reference must resolve to a node of
+ * a type in the property's range, a nested node must have such a type, and a
+ * literal must fit a data type or enumeration in range.
+ */
+export declare function valueFindings(value: unknown, context: ValueContext): Finding[];
+//# sourceMappingURL=check-value.d.ts.map

package/dist/validate/check-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-value.d.ts","sourceRoot":"","sources":["../../src/validate/check-value.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAEpD,4BAA4B;AAC5B,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,mEAAmE;AACnE,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,UAAU,CAAA;IACjB,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;CAC5C;AA8DD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,EAAE,CAW9E"}

package/dist/validate/check-value.js

@@ -0,0 +1,77 @@
+import { enumerationsOf, getVocabularyProperty, isDatatype, isEnumeration, isSubtypeOf, matchesDatatype, rangeAcceptsType, } from '../vocabulary/index.js';
+import { termFindings } from './check-terms.js';
+import { idOf, isObject, isReference, typesOf } from './graph-nodes.js';
+function display(value) {
+    const text = JSON.stringify(value) ?? String(value);
+    return text.length > 60 ? `${text.slice(0, 57)}…` : text;
+}
+function expected(range) {
+    return range.length <= 1
+        ? (range[0] ?? '')
+        : `${range.slice(0, -1).join(', ')} or ${range.at(-1)}`;
+}
+function outOfRange(where, range, got) {
+    return {
+        ...where,
+        severity: 'error',
+        code: 'value-out-of-range',
+        profile: 'schema.org',
+        message: `"${where.property}" expects ${expected(range)}; got ${got}.`,
+    };
+}
+/** Findings for a literal: it must match a data type, or name an enumeration member, in range */
+function literalFindings(value, range, where) {
+    if (range.some((type) => isDatatype(type) && matchesDatatype(type, value)))
+        return [];
+    if (typeof value === 'string') {
+        const enumerations = range.filter(isEnumeration);
+        const memberOf = enumerationsOf(value);
+        if (memberOf.some((member) => enumerations.some((type) => isSubtypeOf(member, type)))) {
+            return termFindings('Value', value, where);
+        }
+        // Schema.org accepts text where a thing is expected ("some data is better than none").
+        if (range.some((type) => !isDatatype(type) && !isEnumeration(type)))
+            return [];
+    }
+    return [outOfRange(where, range, display(value))];
+}
+/** Findings for a reference: its target must exist and have a type in range */
+function referenceFindings(id, range, context) {
+    const target = context.definitions.get(id);
+    const { where } = context;
+    if (!target) {
+        const message = `"${where.property}" refers to "${id}", which no node in the graph defines.`;
+        return [
+            { ...where, severity: 'error', code: 'unresolved-reference', profile: 'schema.org', message },
+        ];
+    }
+    return nodeTypeFindings(target, range, where, `"${id}" (${typesOf(target).join(', ')})`);
+}
+function nodeTypeFindings(node, range, where, got) {
+    const types = typesOf(node);
+    if (types.length === 0 || types.some((type) => rangeAcceptsType(where.property, type)))
+        return [];
+    return [outOfRange(where, range, got)];
+}
+/**
+ * Findings for one value of a property: a reference must resolve to a node of
+ * a type in the property's range, a nested node must have such a type, and a
+ * literal must fit a data type or enumeration in range.
+ */
+export function valueFindings(value, context) {
+    if (value === null || value === undefined)
+        return [];
+    const { where } = context;
+    const range = getVocabularyProperty(where.property)?.range ?? [];
+    if (range.length === 0)
+        return [];
+    if (isReference(value))
+        return referenceFindings(idOf(value) ?? '', range, context);
+    if (isObject(value)) {
+        if ('@value' in value)
+            return literalFindings(value['@value'], range, where);
+        return nodeTypeFindings(value, range, where, `a ${typesOf(value).join(', ')}`);
+    }
+    return literalFindings(value, range, where);
+}
+//# sourceMappingURL=check-value.js.map

package/dist/validate/check-value.js.map

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

package/dist/validate/graph-nodes.d.ts

@@ -0,0 +1,22 @@
+import type { GraphNode } from './types.js';
+/** Whether a value is a JSON object (not an array, not null) */
+export declare function isObject(value: unknown): value is GraphNode;
+/** A value as a list: arrays as they are, anything else as one element */
+export declare function asList(value: unknown): readonly unknown[];
+/** The node's types; empty when it has none */
+export declare function typesOf(node: GraphNode): readonly string[];
+/** The node's `@id`, when it has one */
+export declare function idOf(node: GraphNode): string | undefined;
+/** A reference: an object holding only `@id`, pointing at a node defined elsewhere */
+export declare function isReference(value: unknown): value is GraphNode;
+/** The top-level nodes of a graph: its `@graph` entries, or the root node itself */
+export declare function topLevelNodes(graph: GraphNode): readonly GraphNode[];
+/** The node's properties: every key that is not a JSON-LD keyword */
+export declare function propertyEntries(node: GraphNode): ReadonlyArray<readonly [string, unknown]>;
+/**
+ * Every node definition in the graph, top-level and nested, in document
+ * order. References are not definitions; a value object (`@value`) is not a
+ * node.
+ */
+export declare function allNodes(graph: GraphNode): readonly GraphNode[];
+//# sourceMappingURL=graph-nodes.d.ts.map

package/dist/validate/graph-nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-nodes.d.ts","sourceRoot":"","sources":["../../src/validate/graph-nodes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C,gEAAgE;AAChE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE3D;AAED,0EAA0E;AAC1E,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,OAAO,EAAE,CAEzD;AAED,+CAA+C;AAC/C,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,MAAM,EAAE,CAE1D;AAED,wCAAwC;AACxC,wBAAgB,IAAI,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAGxD;AAED,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D;AAED,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,SAAS,EAAE,CAGpE;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAE1F;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,SAAS,EAAE,CAW/D"}

package/dist/validate/graph-nodes.js

@@ -0,0 +1,50 @@
+/** Whether a value is a JSON object (not an array, not null) */
+export function isObject(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+/** A value as a list: arrays as they are, anything else as one element */
+export function asList(value) {
+    return Array.isArray(value) ? value : [value];
+}
+/** The node's types; empty when it has none */
+export function typesOf(node) {
+    return asList(node['@type']).filter((type) => typeof type === 'string');
+}
+/** The node's `@id`, when it has one */
+export function idOf(node) {
+    const id = node['@id'];
+    return typeof id === 'string' ? id : undefined;
+}
+/** A reference: an object holding only `@id`, pointing at a node defined elsewhere */
+export function isReference(value) {
+    return isObject(value) && idOf(value) !== undefined && Object.keys(value).length === 1;
+}
+/** The top-level nodes of a graph: its `@graph` entries, or the root node itself */
+export function topLevelNodes(graph) {
+    const nodes = '@graph' in graph ? asList(graph['@graph']) : [graph];
+    return nodes.filter(isObject);
+}
+/** The node's properties: every key that is not a JSON-LD keyword */
+export function propertyEntries(node) {
+    return Object.entries(node).filter(([key]) => !key.startsWith('@'));
+}
+/**
+ * Every node definition in the graph, top-level and nested, in document
+ * order. References are not definitions; a value object (`@value`) is not a
+ * node.
+ */
+export function allNodes(graph) {
+    const found = [];
+    const visit = (value) => {
+        for (const item of asList(value)) {
+            if (!isObject(item) || isReference(item) || '@value' in item)
+                continue;
+            found.push(item);
+            for (const [, child] of propertyEntries(item))
+                visit(child);
+        }
+    };
+    visit(topLevelNodes(graph));
+    return found;
+}
+//# sourceMappingURL=graph-nodes.js.map

package/dist/validate/graph-nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-nodes.js","sourceRoot":"","sources":["../../src/validate/graph-nodes.ts"],"names":[],"mappings":"AAEA,gEAAgE;AAChE,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAC7E,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;AAC/C,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,OAAO,CAAC,IAAe;IACrC,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAA;AACzF,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,IAAI,CAAC,IAAe;IAClC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;IACtB,OAAO,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;AAChD,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAA;AACxF,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,aAAa,CAAC,KAAgB;IAC5C,MAAM,KAAK,GAAG,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;IACnE,OAAO,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;AAC/B,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,eAAe,CAAC,IAAe;IAC7C,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAA;AACrE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAgB;IACvC,MAAM,KAAK,GAAgB,EAAE,CAAA;IAC7B,MAAM,KAAK,GAAG,CAAC,KAAc,EAAQ,EAAE;QACrC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,QAAQ,IAAI,IAAI;gBAAE,SAAQ;YACtE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAChB,KAAK,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC;gBAAE,KAAK,CAAC,KAAK,CAAC,CAAA;QAC7D,CAAC;IACH,CAAC,CAAA;IACD,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAA;IAC3B,OAAO,KAAK,CAAA;AACd,CAAC"}