@twin.org/data-framework 0.0.3-next.2 → 0.0.3-next.20

package/README.md

@@ -1,6 +1,6 @@
 # TWIN Framework Data
 
-Models which define the structure of framework types.
+This package provides framework data models that define common structures consumed by other packages in the repository. It centralises shared domain shapes so integrations can rely on clearer contracts and maintain semantic consistency as the ecosystem evolves.
 
 ## Installation
 

package/dist/es/dataTypes/frameworkDataTypes.js

@@ -15,22 +15,25 @@ export class FrameworkDataTypes {
      * Register all the data types.
      */
     static registerTypes() {
-        DataTypeHandlerFactory.register(`${FrameworkContexts.ContextRoot}${FrameworkTypes.Urn}`, () => ({
-            context: FrameworkContexts.ContextRoot,
+        DataTypeHandlerFactory.register(`${FrameworkContexts.Namespace}${FrameworkTypes.Urn}`, () => ({
+            namespace: FrameworkContexts.Namespace,
+            jsonLdContext: FrameworkContexts.JsonLdContext,
             type: FrameworkTypes.Urn,
             defaultValue: "",
             jsonSchema: async () => URNSchema,
             validate: async (propertyName, value, failures, container) => Urn.validate(propertyName, value, failures)
         }));
-        DataTypeHandlerFactory.register(`${FrameworkContexts.ContextRoot}${FrameworkTypes.TimestampMilliseconds}`, () => ({
-            context: FrameworkContexts.ContextRoot,
+        DataTypeHandlerFactory.register(`${FrameworkContexts.Namespace}${FrameworkTypes.TimestampMilliseconds}`, () => ({
+            namespace: FrameworkContexts.Namespace,
+            jsonLdContext: FrameworkContexts.JsonLdContext,
             type: FrameworkTypes.TimestampMilliseconds,
             defaultValue: Date.now(),
             jsonSchema: async () => TimestampMillisecondsSchema,
             validate: async (propertyName, value, failures, container) => Validation.timestampMilliseconds(propertyName, value, failures)
         }));
-        DataTypeHandlerFactory.register(`${FrameworkContexts.ContextRoot}${FrameworkTypes.TimestampSeconds}`, () => ({
-            context: FrameworkContexts.ContextRoot,
+        DataTypeHandlerFactory.register(`${FrameworkContexts.Namespace}${FrameworkTypes.TimestampSeconds}`, () => ({
+            namespace: FrameworkContexts.Namespace,
+            jsonLdContext: FrameworkContexts.JsonLdContext,
             type: FrameworkTypes.TimestampSeconds,
             defaultValue: Math.floor(Date.now() / 1000),
             jsonSchema: async () => TimestampSecondsSchema,

package/dist/es/dataTypes/frameworkDataTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"frameworkDataTypes.js","sourceRoot":"","sources":["../../../src/dataTypes/frameworkDataTypes.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAoB,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,2BAA2B,MAAM,uCAAuC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACtG,OAAO,sBAAsB,MAAM,kCAAkC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC5F,OAAO,SAAS,MAAM,qBAAqB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAElE;;GAEG;AACH,MAAM,OAAO,kBAAkB;IAC9B;;OAEG;IACI,MAAM,CAAC,aAAa;QAC1B,sBAAsB,CAAC,QAAQ,CAC9B,GAAG,iBAAiB,CAAC,WAAW,GAAG,cAAc,CAAC,GAAG,EAAE,EACvD,GAAG,EAAE,CAAC,CAAC;YACN,OAAO,EAAE,iBAAiB,CAAC,WAAW;YACtC,IAAI,EAAE,cAAc,CAAC,GAAG;YACxB,YAAY,EAAE,EAAE;YAChB,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,SAAwB;YAChD,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,CAC5D,GAAG,CAAC,QAAQ,CAAC,YAAY,EAAE,KAAK,EAAE,QAAQ,CAAC;SAC5C,CAAC,CACF,CAAC;QAEF,sBAAsB,CAAC,QAAQ,CAC9B,GAAG,iBAAiB,CAAC,WAAW,GAAG,cAAc,CAAC,qBAAqB,EAAE,EACzE,GAAG,EAAE,CAAC,CAAC;YACN,OAAO,EAAE,iBAAiB,CAAC,WAAW;YACtC,IAAI,EAAE,cAAc,CAAC,qBAAqB;YAC1C,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE;YACxB,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,2BAA0C;YAClE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,CAC5D,UAAU,CAAC,qBAAqB,CAAC,YAAY,EAAE,KAAK,EAAE,QAAQ,CAAC;SAChE,CAAC,CACF,CAAC;QAEF,sBAAsB,CAAC,QAAQ,CAC9B,GAAG,iBAAiB,CAAC,WAAW,GAAG,cAAc,CAAC,gBAAgB,EAAE,EACpE,GAAG,EAAE,CAAC,CAAC;YACN,OAAO,EAAE,iBAAiB,CAAC,WAAW;YACtC,IAAI,EAAE,cAAc,CAAC,gBAAgB;YACrC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;YAC3C,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,sBAAqC;YAC7D,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,CAC5D,UAAU,CAAC,gBAAgB,CAAC,YAAY,EAAE,KAAK,EAAE,QAAQ,CAAC;SAC3D,CAAC,CACF,CAAC;IACH,CAAC;CACD","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { Urn, Validation } from \"@twin.org/core\";\nimport { DataTypeHandlerFactory, type IJsonSchema } from \"@twin.org/data-core\";\nimport { FrameworkContexts } from \"../models/frameworkContexts.js\";\nimport { FrameworkTypes } from \"../models/frameworkTypes.js\";\nimport TimestampMillisecondsSchema from \"../schemas/TimestampMilliseconds.json\" with { type: \"json\" };\nimport TimestampSecondsSchema from \"../schemas/TimestampSeconds.json\" with { type: \"json\" };\nimport URNSchema from \"../schemas/URN.json\" with { type: \"json\" };\n\n/**\n * Handle all the framework data types.\n */\nexport class FrameworkDataTypes {\n\t/**\n\t * Register all the data types.\n\t */\n\tpublic static registerTypes(): void {\n\t\tDataTypeHandlerFactory.register(\n\t\t\t`${FrameworkContexts.ContextRoot}${FrameworkTypes.Urn}`,\n\t\t\t() => ({\n\t\t\t\tcontext: FrameworkContexts.ContextRoot,\n\t\t\t\ttype: FrameworkTypes.Urn,\n\t\t\t\tdefaultValue: \"\",\n\t\t\t\tjsonSchema: async () => URNSchema as IJsonSchema,\n\t\t\t\tvalidate: async (propertyName, value, failures, container) =>\n\t\t\t\t\tUrn.validate(propertyName, value, failures)\n\t\t\t})\n\t\t);\n\n\t\tDataTypeHandlerFactory.register(\n\t\t\t`${FrameworkContexts.ContextRoot}${FrameworkTypes.TimestampMilliseconds}`,\n\t\t\t() => ({\n\t\t\t\tcontext: FrameworkContexts.ContextRoot,\n\t\t\t\ttype: FrameworkTypes.TimestampMilliseconds,\n\t\t\t\tdefaultValue: Date.now(),\n\t\t\t\tjsonSchema: async () => TimestampMillisecondsSchema as IJsonSchema,\n\t\t\t\tvalidate: async (propertyName, value, failures, container) =>\n\t\t\t\t\tValidation.timestampMilliseconds(propertyName, value, failures)\n\t\t\t})\n\t\t);\n\n\t\tDataTypeHandlerFactory.register(\n\t\t\t`${FrameworkContexts.ContextRoot}${FrameworkTypes.TimestampSeconds}`,\n\t\t\t() => ({\n\t\t\t\tcontext: FrameworkContexts.ContextRoot,\n\t\t\t\ttype: FrameworkTypes.TimestampSeconds,\n\t\t\t\tdefaultValue: Math.floor(Date.now() / 1000),\n\t\t\t\tjsonSchema: async () => TimestampSecondsSchema as IJsonSchema,\n\t\t\t\tvalidate: async (propertyName, value, failures, container) =>\n\t\t\t\t\tValidation.timestampSeconds(propertyName, value, failures)\n\t\t\t})\n\t\t);\n\t}\n}\n"]}
+{"version":3,"file":"frameworkDataTypes.js","sourceRoot":"","sources":["../../../src/dataTypes/frameworkDataTypes.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AACvC,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAoB,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,2BAA2B,MAAM,uCAAuC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACtG,OAAO,sBAAsB,MAAM,kCAAkC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC5F,OAAO,SAAS,MAAM,qBAAqB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAElE;;GAEG;AACH,MAAM,OAAO,kBAAkB;IAC9B;;OAEG;IACI,MAAM,CAAC,aAAa;QAC1B,sBAAsB,CAAC,QAAQ,CAAC,GAAG,iBAAiB,CAAC,SAAS,GAAG,cAAc,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;YAC7F,SAAS,EAAE,iBAAiB,CAAC,SAAS;YACtC,aAAa,EAAE,iBAAiB,CAAC,aAAa;YAC9C,IAAI,EAAE,cAAc,CAAC,GAAG;YACxB,YAAY,EAAE,EAAE;YAChB,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,SAAwB;YAChD,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,CAC5D,GAAG,CAAC,QAAQ,CAAC,YAAY,EAAE,KAAK,EAAE,QAAQ,CAAC;SAC5C,CAAC,CAAC,CAAC;QAEJ,sBAAsB,CAAC,QAAQ,CAC9B,GAAG,iBAAiB,CAAC,SAAS,GAAG,cAAc,CAAC,qBAAqB,EAAE,EACvE,GAAG,EAAE,CAAC,CAAC;YACN,SAAS,EAAE,iBAAiB,CAAC,SAAS;YACtC,aAAa,EAAE,iBAAiB,CAAC,aAAa;YAC9C,IAAI,EAAE,cAAc,CAAC,qBAAqB;YAC1C,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE;YACxB,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,2BAA0C;YAClE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,CAC5D,UAAU,CAAC,qBAAqB,CAAC,YAAY,EAAE,KAAK,EAAE,QAAQ,CAAC;SAChE,CAAC,CACF,CAAC;QAEF,sBAAsB,CAAC,QAAQ,CAC9B,GAAG,iBAAiB,CAAC,SAAS,GAAG,cAAc,CAAC,gBAAgB,EAAE,EAClE,GAAG,EAAE,CAAC,CAAC;YACN,SAAS,EAAE,iBAAiB,CAAC,SAAS;YACtC,aAAa,EAAE,iBAAiB,CAAC,aAAa;YAC9C,IAAI,EAAE,cAAc,CAAC,gBAAgB;YACrC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;YAC3C,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,sBAAqC;YAC7D,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,CAC5D,UAAU,CAAC,gBAAgB,CAAC,YAAY,EAAE,KAAK,EAAE,QAAQ,CAAC;SAC3D,CAAC,CACF,CAAC;IACH,CAAC;CACD","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\nimport { Urn, Validation } from \"@twin.org/core\";\nimport { DataTypeHandlerFactory, type IJsonSchema } from \"@twin.org/data-core\";\nimport { FrameworkContexts } from \"../models/frameworkContexts.js\";\nimport { FrameworkTypes } from \"../models/frameworkTypes.js\";\nimport TimestampMillisecondsSchema from \"../schemas/TimestampMilliseconds.json\" with { type: \"json\" };\nimport TimestampSecondsSchema from \"../schemas/TimestampSeconds.json\" with { type: \"json\" };\nimport URNSchema from \"../schemas/URN.json\" with { type: \"json\" };\n\n/**\n * Handle all the framework data types.\n */\nexport class FrameworkDataTypes {\n\t/**\n\t * Register all the data types.\n\t */\n\tpublic static registerTypes(): void {\n\t\tDataTypeHandlerFactory.register(`${FrameworkContexts.Namespace}${FrameworkTypes.Urn}`, () => ({\n\t\t\tnamespace: FrameworkContexts.Namespace,\n\t\t\tjsonLdContext: FrameworkContexts.JsonLdContext,\n\t\t\ttype: FrameworkTypes.Urn,\n\t\t\tdefaultValue: \"\",\n\t\t\tjsonSchema: async () => URNSchema as IJsonSchema,\n\t\t\tvalidate: async (propertyName, value, failures, container) =>\n\t\t\t\tUrn.validate(propertyName, value, failures)\n\t\t}));\n\n\t\tDataTypeHandlerFactory.register(\n\t\t\t`${FrameworkContexts.Namespace}${FrameworkTypes.TimestampMilliseconds}`,\n\t\t\t() => ({\n\t\t\t\tnamespace: FrameworkContexts.Namespace,\n\t\t\t\tjsonLdContext: FrameworkContexts.JsonLdContext,\n\t\t\t\ttype: FrameworkTypes.TimestampMilliseconds,\n\t\t\t\tdefaultValue: Date.now(),\n\t\t\t\tjsonSchema: async () => TimestampMillisecondsSchema as IJsonSchema,\n\t\t\t\tvalidate: async (propertyName, value, failures, container) =>\n\t\t\t\t\tValidation.timestampMilliseconds(propertyName, value, failures)\n\t\t\t})\n\t\t);\n\n\t\tDataTypeHandlerFactory.register(\n\t\t\t`${FrameworkContexts.Namespace}${FrameworkTypes.TimestampSeconds}`,\n\t\t\t() => ({\n\t\t\t\tnamespace: FrameworkContexts.Namespace,\n\t\t\t\tjsonLdContext: FrameworkContexts.JsonLdContext,\n\t\t\t\ttype: FrameworkTypes.TimestampSeconds,\n\t\t\t\tdefaultValue: Math.floor(Date.now() / 1000),\n\t\t\t\tjsonSchema: async () => TimestampSecondsSchema as IJsonSchema,\n\t\t\t\tvalidate: async (propertyName, value, failures, container) =>\n\t\t\t\t\tValidation.timestampSeconds(propertyName, value, failures)\n\t\t\t})\n\t\t);\n\t}\n}\n"]}

package/dist/es/models/frameworkContexts.js

@@ -6,8 +6,16 @@
 // eslint-disable-next-line @typescript-eslint/naming-convention
 export const FrameworkContexts = {
     /**
-     * Context Root.
+     * The canonical RDF namespace URI for Framework.
      */
-    ContextRoot: "https://schema.twindev.org/framework/"
+    Namespace: "https://schema.twindev.org/framework/",
+    /**
+     * The value to use in JSON-LD context for Framework.
+     */
+    Context: "https://schema.twindev.org/framework/",
+    /**
+     * The JSON-LD Context URL for Framework.
+     */
+    JsonLdContext: "https://schema.twindev.org/framework/types.jsonld"
 };
 //# sourceMappingURL=frameworkContexts.js.map

package/dist/es/models/frameworkContexts.js.map

@@ -1 +1 @@
-{"version":3,"file":"frameworkContexts.js","sourceRoot":"","sources":["../../../src/models/frameworkContexts.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AAEvC;;GAEG;AACH,gEAAgE;AAChE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAChC;;OAEG;IACH,WAAW,EAAE,uCAAuC;CAC3C,CAAC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\n\n/**\n * The contexts of framework data.\n */\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport const FrameworkContexts = {\n\t/**\n\t * Context Root.\n\t */\n\tContextRoot: \"https://schema.twindev.org/framework/\"\n} as const;\n\n/**\n * The contexts of framework data.\n */\nexport type FrameworkContexts = (typeof FrameworkContexts)[keyof typeof FrameworkContexts];\n"]}
+{"version":3,"file":"frameworkContexts.js","sourceRoot":"","sources":["../../../src/models/frameworkContexts.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AAEvC;;GAEG;AACH,gEAAgE;AAChE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAChC;;OAEG;IACH,SAAS,EAAE,uCAAuC;IAElD;;OAEG;IACH,OAAO,EAAE,uCAAuC;IAEhD;;OAEG;IACH,aAAa,EAAE,mDAAmD;CACzD,CAAC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\n\n/**\n * The contexts of framework data.\n */\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport const FrameworkContexts = {\n\t/**\n\t * The canonical RDF namespace URI for Framework.\n\t */\n\tNamespace: \"https://schema.twindev.org/framework/\",\n\n\t/**\n\t * The value to use in JSON-LD context for Framework.\n\t */\n\tContext: \"https://schema.twindev.org/framework/\",\n\n\t/**\n\t * The JSON-LD Context URL for Framework.\n\t */\n\tJsonLdContext: \"https://schema.twindev.org/framework/types.jsonld\"\n} as const;\n\n/**\n * The contexts of framework data.\n */\nexport type FrameworkContexts = (typeof FrameworkContexts)[keyof typeof FrameworkContexts];\n"]}

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

@@ -3,9 +3,17 @@
  */
 export declare const FrameworkContexts: {
     /**
-     * Context Root.
+     * The canonical RDF namespace URI for Framework.
      */
-    readonly ContextRoot: "https://schema.twindev.org/framework/";
+    readonly Namespace: "https://schema.twindev.org/framework/";
+    /**
+     * The value to use in JSON-LD context for Framework.
+     */
+    readonly Context: "https://schema.twindev.org/framework/";
+    /**
+     * The JSON-LD Context URL for Framework.
+     */
+    readonly JsonLdContext: "https://schema.twindev.org/framework/types.jsonld";
 };
 /**
  * The contexts of framework data.

package/docs/changelog.md

@@ -1,4 +1,274 @@
-# @twin.org/data-framework - Changelog
+# Changelog
+
+## [0.0.3-next.20](https://github.com/twinfoundation/data/compare/data-framework-v0.0.3-next.19...data-framework-v0.0.3-next.20) (2026-03-24)
+
+
+### Miscellaneous Chores
+
+* **data-framework:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/data-core bumped from 0.0.3-next.19 to 0.0.3-next.20
+    * @twin.org/data-json-ld bumped from 0.0.3-next.19 to 0.0.3-next.20
+
+## [0.0.3-next.19](https://github.com/twinfoundation/data/compare/data-framework-v0.0.3-next.18...data-framework-v0.0.3-next.19) (2026-03-20)
+
+
+### Miscellaneous Chores
+
+* **data-framework:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/data-core bumped from 0.0.3-next.18 to 0.0.3-next.19
+    * @twin.org/data-json-ld bumped from 0.0.3-next.18 to 0.0.3-next.19
+
+## [0.0.3-next.18](https://github.com/twinfoundation/data/compare/data-framework-v0.0.3-next.17...data-framework-v0.0.3-next.18) (2026-03-16)
+
+
+### Miscellaneous Chores
+
+* **data-framework:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/data-core bumped from 0.0.3-next.17 to 0.0.3-next.18
+    * @twin.org/data-json-ld bumped from 0.0.3-next.17 to 0.0.3-next.18
+
+## [0.0.3-next.17](https://github.com/twinfoundation/data/compare/data-framework-v0.0.3-next.16...data-framework-v0.0.3-next.17) (2026-03-12)
+
+
+### Miscellaneous Chores
+
+* **data-framework:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/data-core bumped from 0.0.3-next.16 to 0.0.3-next.17
+    * @twin.org/data-json-ld bumped from 0.0.3-next.16 to 0.0.3-next.17
+
+## [0.0.3-next.16](https://github.com/twinfoundation/data/compare/data-framework-v0.0.3-next.15...data-framework-v0.0.3-next.16) (2026-03-06)
+
+
+### Miscellaneous Chores
+
+* **data-framework:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/data-core bumped from 0.0.3-next.15 to 0.0.3-next.16
+    * @twin.org/data-json-ld bumped from 0.0.3-next.15 to 0.0.3-next.16
+
+## [0.0.3-next.15](https://github.com/twinfoundation/data/compare/data-framework-v0.0.3-next.14...data-framework-v0.0.3-next.15) (2026-02-27)
+
+
+### Miscellaneous Chores
+
+* **data-framework:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/data-core bumped from 0.0.3-next.14 to 0.0.3-next.15
+    * @twin.org/data-json-ld bumped from 0.0.3-next.14 to 0.0.3-next.15
+
+## [0.0.3-next.14](https://github.com/twinfoundation/data/compare/data-framework-v0.0.3-next.13...data-framework-v0.0.3-next.14) (2026-02-25)
+
+
+### Miscellaneous Chores
+
+* **data-framework:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/data-core bumped from 0.0.3-next.13 to 0.0.3-next.14
+    * @twin.org/data-json-ld bumped from 0.0.3-next.13 to 0.0.3-next.14
+
+## [0.0.3-next.13](https://github.com/twinfoundation/data/compare/data-framework-v0.0.3-next.12...data-framework-v0.0.3-next.13) (2026-02-25)
+
+
+### Miscellaneous Chores
+
+* **data-framework:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/data-core bumped from 0.0.3-next.12 to 0.0.3-next.13
+    * @twin.org/data-json-ld bumped from 0.0.3-next.12 to 0.0.3-next.13
+
+## [0.0.3-next.12](https://github.com/twinfoundation/data/compare/data-framework-v0.0.3-next.11...data-framework-v0.0.3-next.12) (2026-02-25)
+
+
+### Miscellaneous Chores
+
+* **data-framework:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/data-core bumped from 0.0.3-next.11 to 0.0.3-next.12
+    * @twin.org/data-json-ld bumped from 0.0.3-next.11 to 0.0.3-next.12
+
+## [0.0.3-next.11](https://github.com/twinfoundation/data/compare/data-framework-v0.0.3-next.10...data-framework-v0.0.3-next.11) (2026-02-25)
+
+
+### Miscellaneous Chores
+
+* **data-framework:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/data-core bumped from 0.0.3-next.10 to 0.0.3-next.11
+    * @twin.org/data-json-ld bumped from 0.0.3-next.10 to 0.0.3-next.11
+
+## [0.0.3-next.10](https://github.com/twinfoundation/data/compare/data-framework-v0.0.3-next.9...data-framework-v0.0.3-next.10) (2026-02-24)
+
+
+### Miscellaneous Chores
+
+* **data-framework:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/data-core bumped from 0.0.3-next.9 to 0.0.3-next.10
+    * @twin.org/data-json-ld bumped from 0.0.3-next.9 to 0.0.3-next.10
+
+## [0.0.3-next.9](https://github.com/twinfoundation/data/compare/data-framework-v0.0.3-next.8...data-framework-v0.0.3-next.9) (2026-02-23)
+
+
+### Miscellaneous Chores
+
+* **data-framework:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/data-core bumped from 0.0.3-next.8 to 0.0.3-next.9
+    * @twin.org/data-json-ld bumped from 0.0.3-next.8 to 0.0.3-next.9
+
+## [0.0.3-next.8](https://github.com/twinfoundation/data/compare/data-framework-v0.0.3-next.7...data-framework-v0.0.3-next.8) (2026-02-02)
+
+
+### Miscellaneous Chores
+
+* **data-framework:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/data-core bumped from 0.0.3-next.7 to 0.0.3-next.8
+    * @twin.org/data-json-ld bumped from 0.0.3-next.7 to 0.0.3-next.8
+
+## [0.0.3-next.7](https://github.com/twinfoundation/data/compare/data-framework-v0.0.3-next.6...data-framework-v0.0.3-next.7) (2026-01-21)
+
+
+### Features
+
+* update context naming ([#37](https://github.com/twinfoundation/data/issues/37)) ([9d99360](https://github.com/twinfoundation/data/commit/9d993605aa51f27a09722729057c6ee921617c2d))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/data-core bumped from 0.0.3-next.6 to 0.0.3-next.7
+    * @twin.org/data-json-ld bumped from 0.0.3-next.6 to 0.0.3-next.7
+
+## [0.0.3-next.6](https://github.com/twinfoundation/data/compare/data-framework-v0.0.3-next.5...data-framework-v0.0.3-next.6) (2026-01-14)
+
+
+### Miscellaneous Chores
+
+* **data-framework:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/data-core bumped from 0.0.3-next.5 to 0.0.3-next.6
+    * @twin.org/data-json-ld bumped from 0.0.3-next.5 to 0.0.3-next.6
+
+## [0.0.3-next.5](https://github.com/twinfoundation/data/compare/data-framework-v0.0.3-next.4...data-framework-v0.0.3-next.5) (2026-01-14)
+
+
+### Features
+
+* improve data type registration ([#34](https://github.com/twinfoundation/data/issues/34)) ([855d110](https://github.com/twinfoundation/data/commit/855d11046a4d85317b77a5c4e0f4a7b1b6d1a767))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/data-core bumped from 0.0.3-next.4 to 0.0.3-next.5
+    * @twin.org/data-json-ld bumped from 0.0.3-next.4 to 0.0.3-next.5
+
+## [0.0.3-next.4](https://github.com/twinfoundation/data/compare/data-framework-v0.0.3-next.3...data-framework-v0.0.3-next.4) (2026-01-06)
+
+
+### Miscellaneous Chores
+
+* **data-framework:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/data-core bumped from 0.0.3-next.3 to 0.0.3-next.4
+    * @twin.org/data-json-ld bumped from 0.0.3-next.3 to 0.0.3-next.4
+
+## [0.0.3-next.3](https://github.com/twinfoundation/data/compare/data-framework-v0.0.3-next.2...data-framework-v0.0.3-next.3) (2026-01-05)
+
+
+### Miscellaneous Chores
+
+* **data-framework:** Synchronize repo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @twin.org/data-core bumped from 0.0.3-next.2 to 0.0.3-next.3
+    * @twin.org/data-json-ld bumped from 0.0.3-next.2 to 0.0.3-next.3
 
 ## [0.0.3-next.2](https://github.com/twinfoundation/data/compare/data-framework-v0.0.3-next.1...data-framework-v0.0.3-next.2) (2025-11-24)
 

package/docs/examples.md

@@ -1 +1,30 @@
-# @twin.org/data-framework - Examples
+# Data Framework Examples
+
+These examples show how to register framework data types and validate values against the registered handlers.
+
+## FrameworkDataTypes
+
+```typescript
+import { type IValidationFailure } from '@twin.org/core';
+import { DataTypeHelper, ValidationMode } from '@twin.org/data-core';
+import { FrameworkContexts, FrameworkDataTypes, FrameworkTypes } from '@twin.org/data-framework';
+
+FrameworkDataTypes.registerTypes();
+
+const failures: IValidationFailure[] = [];
+const urnType = `${FrameworkContexts.Namespace}${FrameworkTypes.Urn}`;
+
+const isValidUrn = await DataTypeHelper.validate(
+  'resourceId',
+  urnType,
+  'urn:example:12345',
+  failures,
+  {
+    validationMode: ValidationMode.Both,
+    failOnMissingType: true
+  }
+);
+
+console.log('URN validation result:', isValidUrn);
+console.log('Failure count:', failures.length);
+```

package/docs/reference/classes/FrameworkDataTypes.md

@@ -14,7 +14,7 @@ Handle all the framework data types.
 
 ## Methods
 
-### registerTypes()
+### registerTypes() {#registertypes}
 
 > `static` **registerTypes**(): `void`
 

package/docs/reference/variables/FrameworkContexts.md

@@ -6,8 +6,20 @@ The contexts of framework data.
 
 ## Type Declaration
 
-### ContextRoot
+### Namespace {#namespace}
 
-> `readonly` **ContextRoot**: `"https://schema.twindev.org/framework/"` = `"https://schema.twindev.org/framework/"`
+> `readonly` **Namespace**: `"https://schema.twindev.org/framework/"` = `"https://schema.twindev.org/framework/"`
 
-Context Root.
+The canonical RDF namespace URI for Framework.
+
+### Context {#context}
+
+> `readonly` **Context**: `"https://schema.twindev.org/framework/"` = `"https://schema.twindev.org/framework/"`
+
+The value to use in JSON-LD context for Framework.
+
+### JsonLdContext {#jsonldcontext}
+
+> `readonly` **JsonLdContext**: `"https://schema.twindev.org/framework/types.jsonld"` = `"https://schema.twindev.org/framework/types.jsonld"`
+
+The JSON-LD Context URL for Framework.

package/docs/reference/variables/FrameworkTypes.md

@@ -6,19 +6,19 @@ The types of framework data.
 
 ## Type Declaration
 
-### Urn
+### Urn {#urn}
 
 > `readonly` **Urn**: `"URN"` = `"URN"`
 
 Represents a urn.
 
-### TimestampMilliseconds
+### TimestampMilliseconds {#timestampmilliseconds}
 
 > `readonly` **TimestampMilliseconds**: `"TimestampMilliseconds"` = `"TimestampMilliseconds"`
 
 Represents a timestamp as an integer, milliseconds since 1 Jan 1970.
 
-### TimestampSeconds
+### TimestampSeconds {#timestampseconds}
 
 > `readonly` **TimestampSeconds**: `"TimestampSeconds"` = `"TimestampSeconds"`
 

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@twin.org/data-framework",
-	"version": "0.0.3-next.2",
-	"description": "Models which define the structure of framework types",
+	"version": "0.0.3-next.20",
+	"description": "Framework data models that define common structures used by other packages.",
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/twinfoundation/data.git",
@@ -15,8 +15,8 @@
 	},
 	"dependencies": {
 		"@twin.org/core": "next",
-		"@twin.org/data-core": "0.0.3-next.2",
-		"@twin.org/data-json-ld": "0.0.3-next.2",
+		"@twin.org/data-core": "0.0.3-next.20",
+		"@twin.org/data-json-ld": "0.0.3-next.20",
 		"@twin.org/entity": "next",
 		"@twin.org/nameof": "next"
 	},