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

package/dist/types/models/{IDistribution.d.ts → IDcatDistribution.d.ts}

@@ -3,18 +3,18 @@ import type { IJsonLdNodeObject } from "@twin.org/data-json-ld";
 import type { IOdrlPolicy } from "@twin.org/standards-w3c-odrl";
 import type { DcatClasses } from "./dcatClasses.js";
 import type { DcatContextType } from "./dcatContextType.js";
-import type { DateTimeType, DecimalType, DurationType, LiteralType, NonNegativeIntegerType } from "./types/dcatPropertyTypes.js";
+import type { DcatDateTimeType, DcatDecimalType, DcatDurationType, DcatLiteralType, DcatNonNegativeIntegerType } from "./types/dcatPropertyTypes.js";
 /**
  * Interface for DCAT Distribution.
  * 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
  */
-export interface IDistribution extends IJsonLdNodeObject {
+export interface IDcatDistribution extends IJsonLdNodeObject {
     /**
      * The JSON-LD context for the resource.
      */
-    "@context"?: DcatContextType;
+    "@context": DcatContextType;
     /**
      * The type identifier, typically "Distribution".
      */
@@ -23,22 +23,22 @@ export interface IDistribution extends IJsonLdNodeObject {
      * A name given to the distribution.
      * @see https://www.w3.org/TR/vocab-dcat-3/#Property:distribution_title
      */
-    "dcterms:title"?: LiteralType;
+    "dcterms:title"?: DcatLiteralType;
     /**
      * A free-text account of the distribution.
      * @see https://www.w3.org/TR/vocab-dcat-3/#Property:distribution_description
      */
-    "dcterms:description"?: LiteralType;
+    "dcterms:description"?: DcatLiteralType;
     /**
      * Date of formal issuance of the distribution.
      * @see https://www.w3.org/TR/vocab-dcat-3/#Property:distribution_release_date
      */
-    "dcterms:issued"?: DateTimeType;
+    "dcterms:issued"?: DcatDateTimeType;
     /**
      * Most recent date on which the distribution was changed, updated or modified.
      * @see https://www.w3.org/TR/vocab-dcat-3/#Property:distribution_update_date
      */
-    "dcterms:modified"?: DateTimeType;
+    "dcterms:modified"?: DcatDateTimeType;
     /**
      * A legal document under which the distribution is made available.
      * @see https://www.w3.org/TR/vocab-dcat-3/#Property:distribution_license
@@ -73,17 +73,17 @@ export interface IDistribution extends IJsonLdNodeObject {
      * The size of the distribution in bytes.
      * @see https://www.w3.org/TR/vocab-dcat-3/#Property:distribution_byte_size
      */
-    "dcat:byteSize"?: NonNegativeIntegerType;
+    "dcat:byteSize"?: DcatNonNegativeIntegerType;
     /**
      * The minimum spatial separation resolvable in a distribution, measured in meters.
      * @see https://www.w3.org/TR/vocab-dcat-3/#Property:distribution_spatial_resolution
      */
-    "dcat:spatialResolutionInMeters"?: DecimalType;
+    "dcat:spatialResolutionInMeters"?: DcatDecimalType;
     /**
      * Minimum time period resolvable in the distribution.
      * @see https://www.w3.org/TR/vocab-dcat-3/#Property:distribution_temporal_resolution
      */
-    "dcat:temporalResolution"?: DurationType;
+    "dcat:temporalResolution"?: DcatDurationType;
     /**
      * An established standard to which the distribution conforms.
      * @see https://www.w3.org/TR/vocab-dcat-3/#Property:distribution_conforms_to

package/dist/types/models/{IRelationship.d.ts → IDcatRelationship.d.ts}

@@ -1,14 +1,14 @@
 import type { IJsonLdNodeObject } from "@twin.org/data-json-ld";
 import type { DcatClasses } from "./dcatClasses.js";
 import type { DcatContextType } from "./dcatContextType.js";
-import type { IRole } from "./IRole.js";
+import type { IDcatRole } from "./IDcatRole.js";
 /**
  * Interface for DCAT Relationship.
  * An association class for attaching additional information to a relationship
  * between DCAT Resources.
  * @see https://www.w3.org/TR/vocab-dcat-3/#Class:Relationship
  */
-export interface IRelationship extends IJsonLdNodeObject {
+export interface IDcatRelationship extends IJsonLdNodeObject {
     /**
      * The JSON-LD context for the resource.
      */
@@ -26,5 +26,5 @@ export interface IRelationship extends IJsonLdNodeObject {
      * The function of an entity or agent with respect to another resource.
      * @see https://www.w3.org/TR/vocab-dcat-3/#Property:relationship_hadRole
      */
-    "dcat:hadRole"?: IRole;
+    "dcat:hadRole"?: IDcatRole;
 }

package/dist/types/models/{IResource.d.ts → IDcatResource.d.ts}

@@ -1,21 +1,21 @@
 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 { IFoafAgent } 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";
+import type { IDcatRelationship } from "./IDcatRelationship.js";
+import type { DcatDateTimeType, DcatLiteralType } 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 {
+export interface IDcatResource extends IJsonLdNodeObject {
     /**
      * The JSON-LD context for the resource.
      */
-    "@context"?: DcatContextType;
+    "@context": DcatContextType;
     /**
      * The type of the resource.
      * Typically "Catalog", "Dataset", "DataService", "DatasetSeries", or the base "Resource".
@@ -25,27 +25,27 @@ export interface IResource extends IJsonLdNodeObject {
      * A name given to the resource.
      * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_title
      */
-    "dcterms:title"?: LiteralType;
+    "dcterms:title"?: DcatLiteralType;
     /**
      * A free-text account of the resource.
      * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_description
      */
-    "dcterms:description"?: LiteralType;
+    "dcterms:description"?: DcatLiteralType;
     /**
      * A unique identifier of the resource.
      * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_identifier
      */
-    "dcterms:identifier"?: LiteralType;
+    "dcterms:identifier"?: DcatLiteralType;
     /**
      * Date of formal issuance (publication) of the resource.
      * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_release_date
      */
-    "dcterms:issued"?: DateTimeType;
+    "dcterms:issued"?: DcatDateTimeType;
     /**
      * 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;
+    "dcterms:modified"?: DcatDateTimeType;
     /**
      * A language of the resource.
      * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_language
@@ -55,12 +55,12 @@ export interface IResource extends IJsonLdNodeObject {
      * An entity responsible for making the resource available.
      * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_publisher
      */
-    "dcterms:publisher"?: IAgent | string;
+    "dcterms:publisher"?: IFoafAgent | string;
     /**
      * An entity responsible for producing the resource.
      * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_creator
      */
-    "dcterms:creator"?: IAgent;
+    "dcterms:creator"?: IFoafAgent;
     /**
      * 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
@@ -95,7 +95,7 @@ export interface IResource extends IJsonLdNodeObject {
      * A keyword or tag describing the resource.
      * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_keyword
      */
-    "dcat:keyword"?: LiteralType;
+    "dcat:keyword"?: DcatLiteralType;
     /**
      * A main category of the resource. A resource can have multiple themes.
      * @see https://www.w3.org/TR/vocab-dcat-3/#Property:resource_theme
@@ -110,7 +110,7 @@ export interface IResource extends IJsonLdNodeObject {
      * 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;
+    "dcat:qualifiedRelation"?: IDcatRelationship | 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

package/dist/types/models/{IRole.d.ts → IDcatRole.d.ts}

@@ -1,18 +1,18 @@
 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";
+import type { DcatLiteralType } 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 {
+export interface IDcatRole extends IJsonLdNodeObject {
     /**
      * The JSON-LD context for the resource.
      */
-    "@context"?: DcatContextType;
+    "@context": DcatContextType;
     /**
      * The type identifier, typically "Role".
      */
@@ -21,5 +21,5 @@ export interface IRole extends IJsonLdNodeObject {
      * A name given to the distribution.
      * @see https://www.w3.org/TR/vocab-dcat-3/#Property:distribution_title
      */
-    "dcterms:title"?: LiteralType;
+    "dcterms:title"?: DcatLiteralType;
 }

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

@@ -7,48 +7,48 @@ 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";
+    readonly Catalog: "dcat: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";
+    readonly Resource: "dcat: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";
+    readonly Dataset: "dcat: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";
+    readonly Distribution: "dcat: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";
+    readonly DataService: "dcat: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";
+    readonly DatasetSeries: "dcat: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";
+    readonly CatalogRecord: "dcat: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";
+    readonly Relationship: "dcat: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";
+    readonly Role: "dcat:Role";
 };
 /**
  * The classes for DCAT.

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

@@ -1,11 +1,15 @@
 import type { IJsonLdContextDefinition } from "@twin.org/data-json-ld";
 import type { DublinCoreContexts } from "@twin.org/standards-dublin-core";
+import type { FoafContexts } from "@twin.org/standards-foaf";
+import type { OdrlContexts } from "@twin.org/standards-w3c-odrl";
 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;
+    dcat: typeof DcatContexts.Namespace;
+    dcterms: typeof DublinCoreContexts.NamespaceTerms;
+    odrl?: typeof OdrlContexts.Namespace;
+    foaf?: typeof FoafContexts.Namespace;
 } & IJsonLdContextDefinition;

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

@@ -4,33 +4,33 @@
  */
 export declare const DcatContexts: {
     /**
-     * The context root for DCAT vocabulary.
+     * The canonical RDF namespace URI.
      */
-    readonly ContextRoot: "http://www.w3.org/ns/dcat#";
+    readonly Namespace: "http://www.w3.org/ns/dcat#";
     /**
-     * The redirect URL for the DCAT context, used for JSON-LD processing.
+     * The value to use in @context.
+     * Note: Context matches Namespace (both include trailing hash) as per DCAT 3.0 specification.
+     * The DCAT JSON-LD context URL format includes a trailing hash.
      */
-    readonly ContextRedirect: "https://www.w3.org/ns/dcat.jsonld";
+    readonly Context: "http://www.w3.org/ns/dcat#";
     /**
-     * The context for RDF vocabulary.
-     * @see https://www.w3.org/TR/rdf-schema/
+     * The JSON-LD Context URL.
      */
-    readonly ContextRdf: "http://www.w3.org/2000/01/rdf-schema#";
+    readonly JsonLdContext: "https://www.w3.org/ns/dcat.jsonld";
     /**
-     * The context for RDF vocabulary Json-LD.
-     * @see https://www.w3.org/TR/rdf-schema/
+     * The namespace location of the hosted version of the JSON Schema.
      */
-    readonly ContextRdfRedirect: "https://schema.twindev.org/w3c-rdf/types.jsonld";
+    readonly JsonSchemaNamespace: "https://schema.twindev.org/w3c-dcat/";
     /**
-     * The context for SPDX (Software Package Data Exchange) vocabulary.
-     * @see https://spdx.org/rdf/terms
+     * The namespace for RDF vocabulary.
+     * @see https://www.w3.org/TR/rdf-schema/
      */
-    readonly ContextSpdx: "http://spdx.org/rdf/terms#";
+    readonly NamespaceRdf: "http://www.w3.org/2000/01/rdf-schema#";
     /**
-     * The context for PROV (Provenance) vocabulary.
-     * @see https://www.w3.org/ns/prov
+     * The context for RDF vocabulary Json-LD.
+     * @see https://www.w3.org/TR/rdf-schema/
      */
-    readonly ContextProv: "http://www.w3.org/ns/prov#";
+    readonly JsonLdContextRdf: "https://schema.twindev.org/w3c-rdf/types.jsonld";
 };
 /**
  * The contexts for DCAT.

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

@@ -0,0 +1,40 @@
+import type { DcatContextType } from "../dcatContextType.js";
+import type { IDcatCatalog } from "../IDcatCatalog.js";
+import type { IDcatCatalogRecord } from "../IDcatCatalogRecord.js";
+import type { IDcatDataService } from "../IDcatDataService.js";
+import type { IDcatDataset } from "../IDcatDataset.js";
+import type { IDcatDistribution } from "../IDcatDistribution.js";
+/**
+ * Type aliases for DCAT entities when LD Context is omitted
+ * These provide type safety while maintaining flexibility for JSON-LD data.
+ */
+/**
+ * Dataset omitting LD Context
+ */
+export type DatasetOptionalContext = Omit<IDcatDataset, "@context"> & {
+    "@context"?: DcatContextType;
+};
+/**
+ * DataService omitting LD Context
+ */
+export type DataServiceOptionalContext = Omit<IDcatDataService, "@context"> & {
+    "@context"?: DcatContextType;
+};
+/**
+ * Catalog omitting LD Context
+ */
+export type CatalogOptionalContext = Omit<IDcatCatalog, "@context"> & {
+    "@context"?: DcatContextType;
+};
+/**
+ * Record omitting LD Context
+ */
+export type CatalogRecordOptionalContext = Omit<IDcatCatalogRecord, "@context"> & {
+    "@context"?: DcatContextType;
+};
+/**
+ * Distribution omitting LD Context
+ */
+export type DistributionOptionalContext = Omit<IDcatDistribution, "@context"> & {
+    "@context"?: DcatContextType;
+};

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

@@ -5,25 +5,25 @@
 /**
  * Literal values can be strings or arrays of strings (for multi-valued properties).
  */
-export type LiteralType = string | string[];
+export type DcatLiteralType = string | string[];
 /**
  * IRI references - can be a single IRI or array of IRIs.
  */
-export type IriType = string | string[];
+export type DcatIriType = string | string[];
 /**
  * Date/time values in ISO 8601 format.
  * Can be xsd:date, xsd:dateTime, or xsd:gYear.
  */
-export type DateTimeType = string;
+export type DcatDateTimeType = string;
 /**
  * Duration values in ISO 8601 duration format (xsd:duration).
  */
-export type DurationType = string;
+export type DcatDurationType = string;
 /**
  * Decimal number values (xsd:decimal).
  */
-export type DecimalType = number;
+export type DcatDecimalType = number;
 /**
  * Non-negative integer values (xsd:nonNegativeInteger).
  */
-export type NonNegativeIntegerType = number;
+export type DcatNonNegativeIntegerType = number;