@twin.org/standards-w3c-dcat 0.0.3-next.3

package/dist/types/models/IResource.d.ts

@@ -0,0 +1,119 @@
+import type { ObjectOrArray } from "@twin.org/core";
+import type { IJsonLdNodeObject } from "@twin.org/data-json-ld";
+import type { IAgent } from "@twin.org/standards-foaf";
+import type { IOdrlPolicy } from "@twin.org/standards-w3c-odrl";
+import type { DcatClasses } from "./dcatClasses.js";
+import type { DcatContextType } from "./dcatContextType.js";
+import type { IRelationship } from "./IRelationship.js";
+import type { DateTimeType, LiteralType } from "./types/dcatPropertyTypes.js";
+/**
+ * Base interface for DCAT catalogued resources.
+ * This is the parent class of dcat:Dataset, dcat:DataService, and dcat:Catalog.
+ * @see https://www.w3.org/TR/vocab-dcat-3/#Class:Resource
+ */
+export interface IResource extends IJsonLdNodeObject {
+    /**
+     * The JSON-LD context for the resource.
+     */
+    "@context"?: DcatContextType;
+    /**
+     * The type of the resource.
+     * Typically "Catalog", "Dataset", "DataService", "DatasetSeries", or the base "Resource".
+     */
+    "@type": typeof DcatClasses.Resource | typeof DcatClasses.Dataset | typeof DcatClasses.DataService | typeof DcatClasses.Catalog | typeof DcatClasses.DatasetSeries;
+    /**
+     * A name given to the resource.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_title
+     */
+    "dcterms:title"?: LiteralType;
+    /**
+     * A free-text account of the resource.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_description
+     */
+    "dcterms:description"?: LiteralType;
+    /**
+     * A unique identifier of the resource.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_identifier
+     */
+    "dcterms:identifier"?: LiteralType;
+    /**
+     * Date of formal issuance (publication) of the resource.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_release_date
+     */
+    "dcterms:issued"?: DateTimeType;
+    /**
+     * Most recent date on which the resource was changed, updated or modified.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_update_date
+     */
+    "dcterms:modified"?: DateTimeType;
+    /**
+     * A language of the resource.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_language
+     */
+    "dcterms:language"?: ObjectOrArray<string>;
+    /**
+     * An entity responsible for making the resource available.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_publisher
+     */
+    "dcterms:publisher"?: IAgent | string;
+    /**
+     * An entity responsible for producing the resource.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_creator
+     */
+    "dcterms:creator"?: IAgent;
+    /**
+     * Information about who can access the resource or an indication of its security status.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_access_rights
+     */
+    "dcterms:accessRights"?: IJsonLdNodeObject | string;
+    /**
+     * A legal document under which the resource is made available.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_license
+     */
+    "dcterms:license"?: IJsonLdNodeObject | string;
+    /**
+     * Information about rights held in and over the resource.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_rights
+     */
+    "dcterms:rights"?: IJsonLdNodeObject | string;
+    /**
+     * An established standard to which the resource conforms.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_conforms_to
+     */
+    "dcterms:conformsTo"?: ObjectOrArray<string>;
+    /**
+     * The nature or genre of the resource.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_type
+     */
+    "dcterms:type"?: string;
+    /**
+     * Relevant contact information for the catalogued resource.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_contact_point
+     */
+    "dcat:contactPoint"?: IJsonLdNodeObject | string;
+    /**
+     * A keyword or tag describing the resource.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_keyword
+     */
+    "dcat:keyword"?: LiteralType;
+    /**
+     * A main category of the resource. A resource can have multiple themes.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_theme
+     */
+    "dcat:theme"?: ObjectOrArray<string>;
+    /**
+     * A Web page that can be navigated to gain access to the resource.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_landing_page
+     */
+    "dcat:landingPage"?: ObjectOrArray<string>;
+    /**
+     * Link to a description of a relationship with another resource.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_qualified_relation
+     */
+    "dcat:qualifiedRelation"?: IRelationship | string;
+    /**
+     * An ODRL conformant policy expressing the rights associated with the resource.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_has_policy
+     */
+    "odrl:hasPolicy"?: IOdrlPolicy;
+}

package/dist/types/models/IRole.d.ts

@@ -0,0 +1,25 @@
+import type { IJsonLdNodeObject } from "@twin.org/data-json-ld";
+import type { DcatClasses } from "./dcatClasses.js";
+import type { DcatContextType } from "./dcatContextType.js";
+import type { LiteralType } from "./types/dcatPropertyTypes.js";
+/**
+ * Interface for DCAT Role.
+ * A role is the function of a resource or agent with respect to another resource,
+ * in the context of resource attribution or resource relationships.
+ * @see https://www.w3.org/TR/vocab-dcat-3/#Class:Role
+ */
+export interface IRole extends IJsonLdNodeObject {
+    /**
+     * The JSON-LD context for the resource.
+     */
+    "@context"?: DcatContextType;
+    /**
+     * The type identifier, typically "Role".
+     */
+    "@type": typeof DcatClasses.Role;
+    /**
+     * A name given to the distribution.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Property:distribution_title
+     */
+    "dcterms:title"?: LiteralType;
+}

package/dist/types/models/dcatClasses.d.ts

@@ -0,0 +1,56 @@
+/**
+ * DCAT core classes representing the main entities in the Data Catalog Vocabulary.
+ * @see https://www.w3.org/TR/vocab-dcat-3/#classes
+ */
+export declare const DcatClasses: {
+    /**
+     * A curated collection of metadata about resources (e.g., datasets and data services in the context of a data catalog).
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Class:Catalog
+     */
+    readonly Catalog: "Catalog";
+    /**
+     * Resource published or curated by a single agent.
+     * This is an abstract class and should not be used directly.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Class:Resource
+     */
+    readonly Resource: "Resource";
+    /**
+     * A collection of data, published or curated by a single agent, and available for access or download in one or more representations.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Class:Dataset
+     */
+    readonly Dataset: "Dataset";
+    /**
+     * A specific representation of a dataset. A dataset might be available in multiple serializations that may differ in various ways.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Class:Distribution
+     */
+    readonly Distribution: "Distribution";
+    /**
+     * A collection of operations that provides access to one or more datasets or data processing functions.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Class:Data_Service
+     */
+    readonly DataService: "DataService";
+    /**
+     * A collection of datasets that are published separately, but share some common characteristics.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Class:Dataset_Series
+     */
+    readonly DatasetSeries: "DatasetSeries";
+    /**
+     * A record in a data catalog, describing the registration of a single dataset or data service.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Class:Catalog_Record
+     */
+    readonly CatalogRecord: "CatalogRecord";
+    /**
+     * An association class for attaching additional information to a relationship between DCAT Resources.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Class:Relationship
+     */
+    readonly Relationship: "Relationship";
+    /**
+     * A role is the function of a resource or agent with respect to another resource, in the context of resource attribution or resource relationships..
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Class:Role
+     */
+    readonly Role: "Role";
+};
+/**
+ * The classes for DCAT.
+ */
+export type DcatClasses = (typeof DcatClasses)[keyof typeof DcatClasses];

package/dist/types/models/dcatContextType.d.ts

@@ -0,0 +1,11 @@
+import type { IJsonLdContextDefinition } from "@twin.org/data-json-ld";
+import type { DublinCoreContexts } from "@twin.org/standards-dublin-core";
+import type { DcatContexts } from "./dcatContexts.js";
+/**
+ * The DCAT JSON-LD context type.
+ * Supports the DCAT context URL or arrays with additional context definitions.
+ */
+export type DcatContextType = {
+    dcat: typeof DcatContexts.ContextRoot;
+    dcterms: typeof DublinCoreContexts.ContextTerms;
+} & IJsonLdContextDefinition;

package/dist/types/models/dcatContexts.d.ts

@@ -0,0 +1,38 @@
+/**
+ * DCAT (Data Catalog Vocabulary) namespace contexts.
+ * @see https://www.w3.org/TR/vocab-dcat-3/
+ */
+export declare const DcatContexts: {
+    /**
+     * The context root for DCAT vocabulary.
+     */
+    readonly ContextRoot: "http://www.w3.org/ns/dcat#";
+    /**
+     * The redirect URL for the DCAT context, used for JSON-LD processing.
+     */
+    readonly ContextRedirect: "https://www.w3.org/ns/dcat.jsonld";
+    /**
+     * The context for RDF vocabulary.
+     * @see https://www.w3.org/TR/rdf-schema/
+     */
+    readonly ContextRdf: "http://www.w3.org/2000/01/rdf-schema#";
+    /**
+     * The context for RDF vocabulary Json-LD.
+     * @see https://www.w3.org/TR/rdf-schema/
+     */
+    readonly ContextRdfRedirect: "https://schema.twindev.org/w3c-rdf/types.jsonld";
+    /**
+     * The context for SPDX (Software Package Data Exchange) vocabulary.
+     * @see https://spdx.org/rdf/terms
+     */
+    readonly ContextSpdx: "http://spdx.org/rdf/terms#";
+    /**
+     * The context for PROV (Provenance) vocabulary.
+     * @see https://www.w3.org/ns/prov
+     */
+    readonly ContextProv: "http://www.w3.org/ns/prov#";
+};
+/**
+ * The contexts for DCAT.
+ */
+export type DcatContexts = (typeof DcatContexts)[keyof typeof DcatContexts];

package/dist/types/models/dcatRelationshipTypes.d.ts

@@ -0,0 +1,57 @@
+/**
+ * DCAT relationship types for describing qualified relationships between resources.
+ * These are used with the dcat:qualifiedRelation property.
+ * @see https://www.w3.org/TR/vocab-dcat-3/#qualified-forms
+ */
+export declare const DcatRelationshipType: {
+    /**
+     * The function of an entity with respect to another resource.
+     * Used in qualified relationships to specify the role.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Property:relationship_had_role
+     */
+    readonly HadRole: "hadRole";
+    /**
+     * A related resource that is supplanted, displaced, or superseded by the described resource.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_replaces
+     */
+    readonly Replaces: "replaces";
+    /**
+     * A related resource that supplants, displaces, or supersedes the described resource.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_is_replaced_by
+     */
+    readonly IsReplacedBy: "isReplacedBy";
+    /**
+     * A related resource that is a version, edition, or adaptation of the described resource.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_has_version
+     */
+    readonly HasVersion: "hasVersion";
+    /**
+     * A related resource of which the described resource is a version, edition, or adaptation.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_is_version_of
+     */
+    readonly IsVersionOf: "isVersionOf";
+    /**
+     * A related resource that references, cites, or otherwise points to the described resource.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_is_referenced_by
+     */
+    readonly IsReferencedBy: "isReferencedBy";
+    /**
+     * A related resource that is referenced, cited, or otherwise pointed to by the described resource.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_references
+     */
+    readonly References: "references";
+    /**
+     * A related resource that requires the described resource to support its function, delivery, or coherence.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_requires
+     */
+    readonly Requires: "requires";
+    /**
+     * A related resource that is required by the described resource to support its function, delivery, or coherence.
+     * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_is_required_by
+     */
+    readonly IsRequiredBy: "isRequiredBy";
+};
+/**
+ * The relationship types for DCAT.
+ */
+export type DcatRelationshipType = (typeof DcatRelationshipType)[keyof typeof DcatRelationshipType];

package/dist/types/models/types/dcatPropertyTypes.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Common type aliases for DCAT properties.
+ * These provide type safety while maintaining flexibility for JSON-LD data.
+ */
+/**
+ * Literal values can be strings or arrays of strings (for multi-valued properties).
+ */
+export type LiteralType = string | string[];
+/**
+ * IRI references - can be a single IRI or array of IRIs.
+ */
+export type IriType = string | string[];
+/**
+ * Date/time values in ISO 8601 format.
+ * Can be xsd:date, xsd:dateTime, or xsd:gYear.
+ */
+export type DateTimeType = string;
+/**
+ * Duration values in ISO 8601 duration format (xsd:duration).
+ */
+export type DurationType = string;
+/**
+ * Decimal number values (xsd:decimal).
+ */
+export type DecimalType = number;
+/**
+ * Non-negative integer values (xsd:nonNegativeInteger).
+ */
+export type NonNegativeIntegerType = number;

package/docs/changelog.md

@@ -0,0 +1,22 @@
+# @twin.org/standards-w3c-dcat - Changelog
+
+## [0.0.3-next.3](https://github.com/twinfoundation/standards/compare/standards-w3c-dcat-v0.0.3-next.2...standards-w3c-dcat-v0.0.3-next.3) (2025-11-18)
+
+
+### Features
+
+* add w3c dcat standards package ([#68](https://github.com/twinfoundation/standards/issues/68)) ([85746c6](https://github.com/twinfoundation/standards/commit/85746c673464498a52e9c30ce498fd88b81a7434))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/standards-dublin-core bumped from 0.0.3-next.2 to 0.0.3-next.3
+    * @twin.org/standards-foaf bumped from 0.0.3-next.2 to 0.0.3-next.3
+    * @twin.org/standards-w3c-odrl bumped from 0.0.3-next.2 to 0.0.3-next.3
+    * @twin.org/standards-w3c-vcard bumped from 0.0.3-next.2 to 0.0.3-next.3
+
+## v0.0.3-next.1
+
+- Initial Release

package/docs/examples.md

@@ -0,0 +1 @@
+# @twin.org/standards-w3c-dcat - Examples

package/docs/reference/classes/DcatDataTypes.md

@@ -0,0 +1,38 @@
+# Class: DcatDataTypes
+
+Class providing DCAT data type utilities and JSON-LD redirect registration.
+
+## Constructors
+
+### Constructor
+
+> **new DcatDataTypes**(): `DcatDataTypes`
+
+#### Returns
+
+`DcatDataTypes`
+
+## Methods
+
+### registerRedirects()
+
+> `static` **registerRedirects**(): `void`
+
+Register redirects for DCAT namespace to enable offline JSON-LD processing.
+This maps the W3C DCAT namespace to a local redirect URL for faster resolution.
+
+#### Returns
+
+`void`
+
+***
+
+### registerTypes()
+
+> `static` **registerTypes**(): `void`
+
+Register all the DCAT data types with their JSON schemas.
+
+#### Returns
+
+`void`

package/docs/reference/index.md

@@ -0,0 +1,36 @@
+# @twin.org/standards-w3c-dcat
+
+## Classes
+
+- [DcatDataTypes](classes/DcatDataTypes.md)
+
+## Interfaces
+
+- [ICatalog](interfaces/ICatalog.md)
+- [ICatalogRecord](interfaces/ICatalogRecord.md)
+- [IDataService](interfaces/IDataService.md)
+- [IDataset](interfaces/IDataset.md)
+- [IDatasetSeries](interfaces/IDatasetSeries.md)
+- [IDistribution](interfaces/IDistribution.md)
+- [IRelationship](interfaces/IRelationship.md)
+- [IResource](interfaces/IResource.md)
+- [IRole](interfaces/IRole.md)
+
+## Type Aliases
+
+- [DcatClasses](type-aliases/DcatClasses.md)
+- [DcatContextType](type-aliases/DcatContextType.md)
+- [DcatContexts](type-aliases/DcatContexts.md)
+- [DcatRelationshipType](type-aliases/DcatRelationshipType.md)
+- [LiteralType](type-aliases/LiteralType.md)
+- [IriType](type-aliases/IriType.md)
+- [DateTimeType](type-aliases/DateTimeType.md)
+- [DurationType](type-aliases/DurationType.md)
+- [DecimalType](type-aliases/DecimalType.md)
+- [NonNegativeIntegerType](type-aliases/NonNegativeIntegerType.md)
+
+## Variables
+
+- [DcatClasses](variables/DcatClasses.md)
+- [DcatContexts](variables/DcatContexts.md)
+- [DcatRelationshipType](variables/DcatRelationshipType.md)