@speclynx/apidom-datamodel 1.12.2

package/dist/apidom-datamodel.browser.min.js

@@ -0,0 +1 @@
+!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define([],t):"object"==typeof exports?exports.apidomDatamodel=t():e.apidomDatamodel=t()}(self,()=>(()=>{"use strict";var e={d:(t,n)=>{for(var r in n)e.o(n,r)&&!e.o(t,r)&&Object.defineProperty(t,r,{enumerable:!0,get:n[r]})},o:(e,t)=>Object.prototype.hasOwnProperty.call(e,t),r:e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})}},t={};e.r(t),e.d(t,{ArrayElement:()=>C,BooleanElement:()=>S,CollectionElement:()=>x,Element:()=>A,JSONSerialiser:()=>n,KeyValuePair:()=>k,LinkElement:()=>F,MemberElement:()=>D,Namespace:()=>L,NullElement:()=>M,NumberElement:()=>P,ObjectElement:()=>K,ObjectSlice:()=>j,RefElement:()=>N,StringElement:()=>V,refract:()=>$});const n=class{namespace;constructor(e){this.namespace=e||new this.Namespace}serialise(e){if(!(e instanceof this.namespace.elements.Element))throw new TypeError(`Given element \`${e}\` is not an Element instance`);const t={element:e.element};e._meta&&e._meta.length>0&&(t.meta=this.serialiseObject(e.meta)),e._attributes&&e._attributes.length>0&&(t.attributes=this.serialiseObject(e.attributes));const n=this.serialiseContent(e.content);return void 0!==n&&(t.content=n),t}deserialise(e){if(!e.element)throw new Error("Given value is not an object containing an element name");const t=new(this.namespace.getElementClass(e.element));t.element!==e.element&&(t.element=e.element),e.meta&&this.deserialiseObject(e.meta,t.meta),e.attributes&&this.deserialiseObject(e.attributes,t.attributes);const n=this.deserialiseContent(e.content);return void 0===n&&null!==t.content||(t.content=n),t}serialiseContent(e){if(e instanceof this.namespace.elements.Element)return this.serialise(e);if(e instanceof this.namespace.KeyValuePair){const t=e,n={key:this.serialise(t.key)};return t.value&&(n.value=this.serialise(t.value)),n}if(e&&Array.isArray(e)){if(0===e.length)return;return e.map(e=>this.serialise(e))}return e}deserialiseContent(e){if(e){if(e.element)return this.deserialise(e);if(e.key){const t=new this.namespace.KeyValuePair(this.deserialise(e.key));return e.value&&(t.value=this.deserialise(e.value)),t}if(Array.isArray(e))return e.map(e=>this.deserialise(e))}return e}serialiseObject(e){const t={};if(e.forEach((e,n)=>{e&&(t[n.toValue()]=this.serialise(e))}),0!==Object.keys(t).length)return t}deserialiseObject(e,t){Object.keys(e).forEach(n=>{t.set(n,this.deserialise(e[n]))})}};function r(e){return null!=e&&"object"==typeof e&&!0===e["@@functional/placeholder"]}function s(e){return function t(n){return 0===arguments.length||r(n)?t:e.apply(this,arguments)}}function i(e){return function t(n,i){switch(arguments.length){case 0:return t;case 1:return r(n)?t:s(function(t){return e(n,t)});default:return r(n)&&r(i)?t:r(n)?s(function(t){return e(t,i)}):r(i)?s(function(t){return e(n,t)}):e(n,i)}}}function o(e){for(var t,n=[];!(t=e.next()).done;)n.push(t.value);return n}function a(e,t,n){for(var r=0,s=n.length;r<s;){if(e(t,n[r]))return!0;r+=1}return!1}function c(e,t){return Object.prototype.hasOwnProperty.call(t,e)}const l="function"==typeof Object.is?Object.is:function(e,t){return e===t?0!==e||1/e==1/t:e!=e&&t!=t};var u=Object.prototype.toString;const h=function(){return"[object Arguments]"===u.call(arguments)?function(e){return"[object Arguments]"===u.call(e)}:function(e){return c("callee",e)}}();var f=!{toString:null}.propertyIsEnumerable("toString"),m=["constructor","valueOf","isPrototypeOf","toString","propertyIsEnumerable","hasOwnProperty","toLocaleString"],p=function(){return arguments.propertyIsEnumerable("length")}(),y=function(e,t){for(var n=0;n<e.length;){if(e[n]===t)return!0;n+=1}return!1};const d="function"!=typeof Object.keys||p?s(function(e){if(Object(e)!==e)return[];var t,n,r=[],s=p&&h(e);for(t in e)!c(t,e)||s&&"length"===t||(r[r.length]=t);if(f)for(n=m.length-1;n>=0;)c(t=m[n],e)&&!y(r,t)&&(r[r.length]=t),n-=1;return r}):s(function(e){return Object(e)!==e?[]:Object.keys(e)});const b=s(function(e){return null===e?"Null":void 0===e?"Undefined":Object.prototype.toString.call(e).slice(8,-1)});function g(e,t,n,r){var s=o(e);function i(e,t){return v(e,t,n.slice(),r.slice())}return!a(function(e,t){return!a(i,t,e)},o(t),s)}function v(e,t,n,r){if(l(e,t))return!0;var s,i,o=b(e);if(o!==b(t))return!1;if("function"==typeof e["fantasy-land/equals"]||"function"==typeof t["fantasy-land/equals"])return"function"==typeof e["fantasy-land/equals"]&&e["fantasy-land/equals"](t)&&"function"==typeof t["fantasy-land/equals"]&&t["fantasy-land/equals"](e);if("function"==typeof e.equals||"function"==typeof t.equals)return"function"==typeof e.equals&&e.equals(t)&&"function"==typeof t.equals&&t.equals(e);switch(o){case"Arguments":case"Array":case"Object":if("function"==typeof e.constructor&&"Promise"===(s=e.constructor,null==(i=String(s).match(/^function (\w*)/))?"":i[1]))return e===t;break;case"Boolean":case"Number":case"String":if(typeof e!=typeof t||!l(e.valueOf(),t.valueOf()))return!1;break;case"Date":if(!l(e.valueOf(),t.valueOf()))return!1;break;case"Error":return e.name===t.name&&e.message===t.message;case"RegExp":if(e.source!==t.source||e.global!==t.global||e.ignoreCase!==t.ignoreCase||e.multiline!==t.multiline||e.sticky!==t.sticky||e.unicode!==t.unicode)return!1}for(var a=n.length-1;a>=0;){if(n[a]===e)return r[a]===t;a-=1}switch(o){case"Map":return e.size===t.size&&g(e.entries(),t.entries(),n.concat([e]),r.concat([t]));case"Set":return e.size===t.size&&g(e.values(),t.values(),n.concat([e]),r.concat([t]));case"Arguments":case"Array":case"Object":case"Boolean":case"Number":case"String":case"Date":case"Error":case"RegExp":case"Int8Array":case"Uint8Array":case"Uint8ClampedArray":case"Int16Array":case"Uint16Array":case"Int32Array":case"Uint32Array":case"Float32Array":case"Float64Array":case"ArrayBuffer":break;default:return!1}var u=d(e);if(u.length!==d(t).length)return!1;var h=n.concat([e]),f=r.concat([t]);for(a=u.length-1;a>=0;){var m=u[a];if(!c(m,t)||!v(t[m],e[m],h,f))return!1;a-=1}return!0}const _=i(function(e,t){return v(e,t,[],[])});class E{key;value;constructor(e,t){this.key=e,this.value=t}clone(){return new E(this.key?.clone(),this.value?.clone())}toValue(){return{key:this.key?.toValue(),value:this.value?.toValue()}}}const k=E;class w{elements;constructor(e){this.elements=e??[]}toValue(){return this.elements.map(e=>({key:e.key?.toValue(),value:e.value?.toValue()}))}map(e,t){return this.elements.map(n=>{const r=n.value,s=n.key;if(void 0===r||void 0===s)throw new Error("MemberElement must have both key and value");return void 0!==t?e.call(t,r,s,n):e(r,s,n)})}filter(e,t){const n=this.elements.filter(n=>{const r=n.value,s=n.key;return void 0!==r&&void 0!==s&&(void 0!==t?e.call(t,r,s,n):e(r,s,n))});return new w(n)}reject(e,t){const n=[];for(const r of this.elements){const s=r.value,i=r.key;void 0!==s&&void 0!==i&&(e.call(t,s,i,r)||n.push(r))}return new w(n)}forEach(e,t){this.elements.forEach((n,r)=>{const s=n.value,i=n.key;void 0!==s&&void 0!==i&&(void 0!==t?e.call(t,s,i,n,r):e(s,i,n,r))})}find(e,t){return this.elements.find(n=>{const r=n.value,s=n.key;return void 0!==r&&void 0!==s&&(void 0!==t?e.call(t,r,s,n):e(r,s,n))})}keys(){return this.elements.map(e=>e.key?.toValue()).filter(e=>void 0!==e)}values(){return this.elements.map(e=>e.value?.toValue()).filter(e=>void 0!==e)}get length(){return this.elements.length}get isEmpty(){return 0===this.length}get first(){return this.elements[0]}get(e){return this.elements[e]}push(e){return this.elements.push(e),this}clone(){return new w(this.elements.map(e=>e.clone()))}includesKey(e){return this.elements.some(t=>t.key?.equals(e))}[Symbol.iterator](){return this.elements[Symbol.iterator]()}}const j=w;class O{_storedElement="element";_content;_meta;_attributes;parent;constructor(e,t,n){void 0!==t&&(this.meta=t),void 0!==n&&(this.attributes=n),void 0!==e&&(this.content=e)}get element(){return this._storedElement}set element(e){this._storedElement=e}get content(){return this._content}set content(e){if(e instanceof O)this._content=e;else if(null!=e&&"string"!=typeof e&&"number"!=typeof e&&"boolean"!=typeof e&&"bigint"!=typeof e&&"symbol"!=typeof e)if(e instanceof k)this._content=e;else if(e instanceof j)this._content=e.elements;else if(Array.isArray(e))this._content=e.map(e=>this.refract(e));else{if("object"!=typeof e)throw new Error("Cannot set content to value of type "+typeof e);this._content=Object.entries(e).map(([e,t])=>new this.MemberElement(e,t))}else this._content=e}get meta(){if(!this._meta){if(this.isFrozen){const e=new this.ObjectElement;return e.freeze(),e}this._meta=new this.ObjectElement}return this._meta}set meta(e){e instanceof O?this._meta=e:this.meta.set(e??{})}get attributes(){if(!this._attributes){if(this.isFrozen){const e=new this.ObjectElement;return e.freeze(),e}this._attributes=new this.ObjectElement}return this._attributes}set attributes(e){e instanceof O?this._attributes=e:this.attributes.set(e??{})}get id(){return this.getMetaProperty("id","")}set id(e){this.setMetaProperty("id",e)}get classes(){return this.getMetaProperty("classes",[])}set classes(e){this.setMetaProperty("classes",e)}get title(){return this.getMetaProperty("title","")}set title(e){this.setMetaProperty("title",e)}get description(){return this.getMetaProperty("description","")}set description(e){this.setMetaProperty("description",e)}get links(){return this.getMetaProperty("links",[])}set links(e){this.setMetaProperty("links",e)}get children(){const{_content:e}=this;if(Array.isArray(e))return e;if(e instanceof k){const t=[];return e.key&&t.push(e.key),e.value&&t.push(e.value),t}return e instanceof O?[e]:[]}get isFrozen(){return Object.isFrozen(this)}freeze(){if(!this.isFrozen){this._meta&&(this._meta.parent=this,this._meta.freeze()),this._attributes&&(this._attributes.parent=this,this._attributes.freeze());for(const e of this.children)e.parent=this,e.freeze();Array.isArray(this._content)&&Object.freeze(this._content),Object.freeze(this)}}clone(){const e=new(0,this.constructor);e.element=this.element,this._meta&&(e._meta=this._meta.clone()),this._attributes&&(e._attributes=this._attributes.clone());const{_content:t}=this;return t instanceof O||t instanceof k?e._content=t.clone():Array.isArray(t)?e._content=t.map(e=>e.clone()):e._content=t,e}toValue(){const{_content:e}=this;return e instanceof O||e instanceof k?e.toValue():Array.isArray(e)?e.map(e=>e.toValue()):e}equals(e){return _(this.toValue(),e)}primitive(){}set(e){return this.content=e,this}toRef(e){const t=this.id.toValue();if(""===t)throw new Error("Cannot create reference to an element without an ID");const n=new this.RefElement(t);return"string"==typeof e&&(n.path=this.refract(e)),n}getMetaProperty(e,t){if(!this.meta.hasKey(e)){if(this.isFrozen){const e=this.refract(t);return e.freeze(),e}this.meta.set(e,t)}return this.meta.get(e)}setMetaProperty(e,t){this.meta.set(e,t)}}const A=O;const M=class extends A{constructor(e,t,n){super(e??null,t,n),this.element="null"}primitive(){return"null"}set(e){throw new Error("Cannot set the value of null")}};const V=class extends A{constructor(e,t,n){super(e,t,n),this.element="string"}primitive(){return"string"}get length(){return this.content?.length??0}};const P=class extends A{constructor(e,t,n){super(e,t,n),this.element="number"}primitive(){return"number"}};const S=class extends A{constructor(e,t,n){super(e,t,n),this.element="boolean"}primitive(){return"boolean"}};class z extends A{constructor(e,t,n){super(e||[],t,n)}get length(){return this._content.length}get isEmpty(){return 0===this.length}get first(){return this._content[0]}get second(){return this._content[1]}get last(){return this._content.at(-1)}push(e){return this._content.push(this.refract(e)),this}add(e){this.push(e)}shift(){return this._content.shift()}unshift(e){this._content.unshift(this.refract(e))}includes(e){return this._content.some(t=>t.equals(e))}findElements(e,t){const n=t||{},r=!!n.recursive,s=void 0===n.results?[]:n.results;for(let t=0;t<this._content.length;t+=1){const n=this._content[t],i=n;r&&"function"==typeof i.findElements&&i.findElements(e,{results:s,recursive:r}),e(n,t,void 0)&&s.push(n)}return s}find(e){const t=this.findElements(e,{recursive:!0});return new this.ArrayElement(t)}findByElement(e){return this.find(t=>t.element===e)}findByClass(e){return this.find(t=>{const n=t.classes;return"function"==typeof n.includes&&n.includes(e)})}getById(e){return this.find(t=>t.id.toValue()===e).first}"fantasy-land/empty"(){return this.empty()}concat(e){return new(0,this.constructor)(this._content.concat(e._content))}"fantasy-land/concat"(e){return this.concat(e)}[Symbol.iterator](){return this._content[Symbol.iterator]()}}const x=z;class q extends x{static empty(){return new this}static"fantasy-land/empty"(){return q.empty()}constructor(e,t,n){super(e||[],t,n),this.element="array"}primitive(){return"array"}get(e){return this._content[e]}getValue(e){const t=this.get(e);if(t)return t.toValue()}set(e,t){return"number"==typeof e&&void 0!==t?this._content[e]=this.refract(t):this.content=e,this}remove(e){return this._content.splice(e,1)[0]??null}map(e,t){return this._content.map(e,t)}flatMap(e,t){return this._content.flatMap(e,t)}compactMap(e,t){const n=[];for(const r of this._content){const s=e.call(t,r);s&&n.push(s)}return n}filter(e,t){const n=this._content.filter(e,t);return new this.constructor(n)}reject(e,t){const n=[];for(const r of this._content)e.call(t,r)||n.push(r);return new this.constructor(n)}reduce(e,t){let n,r;void 0!==t?(n=0,r=this.refract(t)):(n=1,r=this.first);for(let t=n;t<this.length;t+=1){const n=e(r,this._content[t],t,this);r=void 0===n?n:this.refract(n)}return r}forEach(e,t){this._content.forEach((n,r)=>{e.call(t,n,r)})}empty(){return new this.constructor([])}"fantasy-land/map"(e){return new this.constructor(this.map(e))}"fantasy-land/chain"(e){return this.map(t=>e(t)).reduce((e,t)=>e.concat(t),this.empty())}"fantasy-land/filter"(e){return new this.constructor(this._content.filter(e))}"fantasy-land/reduce"(e,t){return this._content.reduce(e,t)}}const C=q;const D=class extends A{constructor(e,t,n,r){super(new k,n,r),this.element="member",void 0!==e&&(this.key=e),void 0!==t&&(this.value=t)}primitive(){return"member"}get key(){return this._content.key}set key(e){this._content.key=this.refract(e)}get value(){return this._content.value}set value(e){this._content.value=this.refract(e)}};const K=class extends x{constructor(e,t,n){super(e||[],t,n),this.element="object"}primitive(){return"object"}toValue(){return this._content.reduce((e,t)=>(e[t.key.toValue()]=t.value?t.value.toValue():void 0,e),{})}get(e){const t=this.getMember(e);if(t)return t.value}getValue(e){const t=this.get(e);if(t)return t.toValue()}getMember(e){if(void 0!==e)return this._content.find(t=>t.key.toValue()===e)}remove(e){let t=null;return this.content=this._content.filter(n=>n.key.toValue()!==e||(t=n,!1)),t}getKey(e){const t=this.getMember(e);if(t)return t.key}set(e,t){if("string"==typeof e){const n=this.getMember(e);n?n.value=t:this._content.push(new D(e,t))}else if("object"==typeof e&&!Array.isArray(e))for(const t of Object.keys(e))this.set(t,e[t]);return this}keys(){return this._content.map(e=>e.key.toValue())}values(){return this._content.map(e=>e.value.toValue())}hasKey(e){return this._content.some(t=>t.key.equals(e))}items(){return this._content.map(e=>[e.key.toValue(),e.value.toValue()])}map(e,t){return this._content.map(n=>e.call(t,n.value,n.key,n))}compactMap(e,t){const n=[];return this.forEach((r,s,i)=>{const o=e.call(t,r,s,i);o&&n.push(o)}),n}filter(e,t){return new j(this._content).filter(e,t)}reject(e,t){const n=[];for(const r of this._content)e.call(t,r.value,r.key,r)||n.push(r);return new j(n)}forEach(e,t){this._content.forEach(n=>e.call(t,n.value,n.key,n))}reduce(e,t){let n,r;void 0!==t?(n=0,r=this.refract(t)):(n=1,r=this._content[0]?.value);for(let t=n;t<this._content.length;t+=1){const n=this._content[t],s=e(r,n.value,n.key,n,this);r=void 0===s?s:this.refract(s)}return r}empty(){return new this.constructor([])}};const N=class extends A{constructor(e,t,n){super(e||[],t,n),this.element="ref",this.path||(this.path="element")}get path(){return this.attributes.get("path")}set path(e){this.attributes.set("path",e)}};const F=class extends A{constructor(e,t,n){super(e||[],t,n),this.element="link"}get relation(){return this.attributes.get("relation")}set relation(e){this.attributes.set("relation",e)}get href(){return this.attributes.get("href")}set href(e){this.attributes.set("href",e)}},I=e=>null===e,R=e=>"string"==typeof e,B=e=>"number"==typeof e,U=e=>"boolean"==typeof e,T=e=>null!==e&&"object"==typeof e;class G{elementMap={};elementDetection=[];Element;KeyValuePair;_elements;_attributeElementKeys=[];_attributeElementArrayKeys=[];constructor(e){this.Element=A,this.KeyValuePair=k,e&&e.noDefault||this.useDefault()}use(e){return e.namespace&&e.namespace({base:this}),e.load&&e.load({base:this}),this}useDefault(){return this.register("null",M).register("string",V).register("number",P).register("boolean",S).register("array",C).register("object",K).register("member",D).register("ref",N).register("link",F),this.detect(I,M,!1).detect(R,V,!1).detect(B,P,!1).detect(U,S,!1).detect(Array.isArray,C,!1).detect(T,K,!1),this}register(e,t){return this._elements=void 0,this.elementMap[e]=t,this}unregister(e){return this._elements=void 0,delete this.elementMap[e],this}detect(e,t,n){return void 0===n||n?this.elementDetection.unshift([e,t]):this.elementDetection.push([e,t]),this}toElement(e){if(e instanceof this.Element)return e;let t;for(const[n,r]of this.elementDetection)if(n(e)){t=new r(e);break}return t}getElementClass(e){const t=this.elementMap[e];return void 0===t?this.Element:t}fromRefract(e){return this.serialiser.deserialise(e)}toRefract(e){return this.serialiser.serialise(e)}get elements(){return void 0===this._elements&&(this._elements={Element:this.Element},Object.keys(this.elementMap).forEach(e=>{const t=e[0].toUpperCase()+e.substring(1);this._elements[t]=this.elementMap[e]})),this._elements}get serialiser(){return new n(this)}}n.prototype.Namespace=G;const L=G;function J(e){return void 0===e?new M:$(e)}function $(e){if(e instanceof A)return e;if("string"==typeof e)return new V(e);if("number"==typeof e)return new P(e);if("boolean"==typeof e)return new S(e);if(null===e)return new M;if(Array.isArray(e))return new C(e.map(J));if("object"==typeof e)return new K(e);throw new Error("Cannot refract value of type "+typeof e)}return A.prototype.ObjectElement=K,A.prototype.ArrayElement=C,A.prototype.RefElement=N,A.prototype.MemberElement=D,A.prototype.refract=$,t})());

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@speclynx/apidom-datamodel",
+  "version": "1.12.2",
+  "description": "Data model primitives for ApiDOM.",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "unpkg": "./dist/apidom-datamodel.browser.min.js",
+  "main": "./src/index.cjs",
+  "exports": {
+    "types": "./types/apidom-datamodel.d.ts",
+    "import": "./src/index.mjs",
+    "require": "./src/index.cjs"
+  },
+  "types": "./types/apidom-datamodel.d.ts",
+  "scripts": {
+    "build": "npm run clean && run-p --max-parallel ${CPU_CORES:-2} typescript:declaration build:es build:cjs build:umd:browser",
+    "build:es": "cross-env BABEL_ENV=es babel src --out-dir src --extensions '.ts' --out-file-extension '.mjs' --root-mode 'upward'",
+    "build:cjs": "cross-env BABEL_ENV=cjs babel src --out-dir src --extensions '.ts' --out-file-extension '.cjs' --root-mode 'upward'",
+    "build:umd:browser": "cross-env BABEL_ENV=browser webpack --config config/webpack/browser.config.js --progress",
+    "lint": "eslint ./",
+    "lint:fix": "eslint ./ --fix",
+    "clean": "rimraf --glob 'src/**/*.mjs' 'src/**/*.cjs' 'test/**/*.mjs' ./dist ./types",
+    "typescript:check-types": "tsc --noEmit",
+    "typescript:declaration": "tsc -p tsconfig.declaration.json && api-extractor run -l -c ./config/api-extractor/api-extractor.json",
+    "test": "npm run build:es && cross-env BABEL_ENV=es babel test --out-dir test --extensions '.ts' --out-file-extension '.mjs' --root-mode 'upward' && cross-env NODE_ENV=test mocha",
+    "prepack": "copyfiles -u 3 ../../LICENSES/* LICENSES && copyfiles -u 2 ../../NOTICE .",
+    "postpack": "rimraf NOTICE LICENSES"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/speclynx/apidom.git"
+  },
+  "author": "Vladimir Gorej",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@babel/runtime-corejs3": "^7.28.4",
+    "ramda": "~0.32.0"
+  },
+  "files": [
+    "src/**/*.mjs",
+    "src/**/*.cjs",
+    "dist/",
+    "types/apidom-datamodel.d.ts",
+    "LICENSES",
+    "NOTICE",
+    "README.md",
+    "CHANGELOG.md"
+  ]
+}

package/src/KeyValuePair.cjs

@@ -0,0 +1,38 @@
+"use strict";
+
+exports.__esModule = true;
+exports.default = void 0;
+/**
+ * Represents a key-value pair used in MemberElement content.
+ * This is used internally to store object member data.
+ *
+ * @typeParam K - Key element type
+ * @typeParam V - Value element type
+ * @public
+ */
+class KeyValuePair {
+  key;
+  value;
+  constructor(key, value) {
+    this.key = key;
+    this.value = value;
+  }
+
+  /**
+   * Creates a deep clone of the KeyValuePair.
+   */
+  clone() {
+    return new KeyValuePair(this.key?.clone(), this.value?.clone());
+  }
+
+  /**
+   * Converts to a plain JavaScript object representation.
+   */
+  toValue() {
+    return {
+      key: this.key?.toValue(),
+      value: this.value?.toValue()
+    };
+  }
+}
+var _default = exports.default = KeyValuePair;

package/src/KeyValuePair.mjs

@@ -0,0 +1,34 @@
+/**
+ * Represents a key-value pair used in MemberElement content.
+ * This is used internally to store object member data.
+ *
+ * @typeParam K - Key element type
+ * @typeParam V - Value element type
+ * @public
+ */
+class KeyValuePair {
+  key;
+  value;
+  constructor(key, value) {
+    this.key = key;
+    this.value = value;
+  }
+
+  /**
+   * Creates a deep clone of the KeyValuePair.
+   */
+  clone() {
+    return new KeyValuePair(this.key?.clone(), this.value?.clone());
+  }
+
+  /**
+   * Converts to a plain JavaScript object representation.
+   */
+  toValue() {
+    return {
+      key: this.key?.toValue(),
+      value: this.value?.toValue()
+    };
+  }
+}
+export default KeyValuePair;

package/src/Namespace.cjs

@@ -0,0 +1,212 @@
+"use strict";
+
+var _interopRequireWildcard = require("@babel/runtime-corejs3/helpers/interopRequireWildcard").default;
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.default = void 0;
+var _JSONSerialiser = _interopRequireDefault(require("./serialisers/JSONSerialiser.cjs"));
+var elements = _interopRequireWildcard(require("./registration.cjs"));
+const isNull = value => value === null;
+const isString = value => typeof value === 'string';
+const isNumber = value => typeof value === 'number';
+const isBoolean = value => typeof value === 'boolean';
+const isObject = value => value !== null && typeof value === 'object';
+
+/**
+ * Constructor type for Element classes.
+ * @public
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+
+/**
+ * Function to test if a value should be converted to a specific element type.
+ * @public
+ */
+
+/**
+ * Tuple of detection test and element class.
+ * @public
+ */
+
+/**
+ * Options for Namespace constructor.
+ * @public
+ */
+
+/**
+ * Plugin interface for extending Namespace.
+ * @public
+ */
+
+/**
+ * Map of registered element classes.
+ * @public
+ */
+
+/**
+ * A refract element implementation with an extensible namespace, able to
+ * load other namespaces into it.
+ *
+ * The namespace allows you to register your own classes to be instantiated
+ * when a particular refract element is encountered, and allows you to specify
+ * which elements get instantiated for existing JavaScript objects.
+ *
+ * @public
+ */
+class Namespace {
+  elementMap = {};
+  elementDetection = [];
+  Element;
+  KeyValuePair;
+  _elements;
+  _attributeElementKeys = [];
+  _attributeElementArrayKeys = [];
+  constructor(options) {
+    this.Element = elements.Element;
+    this.KeyValuePair = elements.KeyValuePair;
+    if (!options || !options.noDefault) {
+      this.useDefault();
+    }
+  }
+
+  /**
+   * Use a namespace plugin or load a generic plugin.
+   */
+  use(plugin) {
+    if (plugin.namespace) {
+      plugin.namespace({
+        base: this
+      });
+    }
+    if (plugin.load) {
+      plugin.load({
+        base: this
+      });
+    }
+    return this;
+  }
+
+  /**
+   * Use the default namespace. This preloads all the default elements
+   * into this registry instance.
+   */
+  useDefault() {
+    // Set up classes for default elements
+    this.register('null', elements.NullElement).register('string', elements.StringElement).register('number', elements.NumberElement).register('boolean', elements.BooleanElement).register('array', elements.ArrayElement).register('object', elements.ObjectElement).register('member', elements.MemberElement).register('ref', elements.RefElement).register('link', elements.LinkElement);
+
+    // Add instance detection functions to convert existing objects into
+    // the corresponding refract elements.
+    this.detect(isNull, elements.NullElement, false).detect(isString, elements.StringElement, false).detect(isNumber, elements.NumberElement, false).detect(isBoolean, elements.BooleanElement, false).detect(Array.isArray, elements.ArrayElement, false).detect(isObject, elements.ObjectElement, false);
+    return this;
+  }
+
+  /**
+   * Register a new element class for an element.
+   */
+  register(name, ElementClass) {
+    this._elements = undefined;
+    this.elementMap[name] = ElementClass;
+    return this;
+  }
+
+  /**
+   * Unregister a previously registered class for an element.
+   */
+  unregister(name) {
+    this._elements = undefined;
+    delete this.elementMap[name];
+    return this;
+  }
+
+  /**
+   * Add a new detection function to determine which element
+   * class to use when converting existing JS instances into
+   * refract elements.
+   */
+  detect(test, ElementClass, givenPrepend) {
+    const prepend = givenPrepend === undefined ? true : givenPrepend;
+    if (prepend) {
+      this.elementDetection.unshift([test, ElementClass]);
+    } else {
+      this.elementDetection.push([test, ElementClass]);
+    }
+    return this;
+  }
+
+  /**
+   * Convert an existing JavaScript object into refract element instances.
+   * If the item passed in is already refracted, then it is returned unmodified.
+   */
+  toElement(value) {
+    if (value instanceof this.Element) {
+      return value;
+    }
+    let element;
+    for (const [test, ElementClass] of this.elementDetection) {
+      if (test(value)) {
+        element = new ElementClass(value);
+        break;
+      }
+    }
+    return element;
+  }
+
+  /**
+   * Get an element class given an element name.
+   */
+  getElementClass(element) {
+    const ElementClass = this.elementMap[element];
+    if (ElementClass === undefined) {
+      // Fall back to the base element. We may not know what
+      // to do with the `content`, but downstream software
+      // may know.
+      return this.Element;
+    }
+    return ElementClass;
+  }
+
+  /**
+   * Convert a refract document into refract element instances.
+   */
+  fromRefract(doc) {
+    return this.serialiser.deserialise(doc);
+  }
+
+  /**
+   * Convert an element to a Refracted JSON object.
+   */
+  toRefract(element) {
+    return this.serialiser.serialise(element);
+  }
+
+  /**
+   * Get an object that contains all registered element classes, where
+   * the key is the PascalCased element name and the value is the class.
+   */
+  get elements() {
+    if (this._elements === undefined) {
+      this._elements = {
+        Element: this.Element
+      };
+      Object.keys(this.elementMap).forEach(name => {
+        // Currently, all registered element types use a camelCaseName.
+        // Converting to PascalCase is as simple as upper-casing the first letter.
+        const pascal = name[0].toUpperCase() + name.substring(1);
+        this._elements[pascal] = this.elementMap[name];
+      });
+    }
+    return this._elements;
+  }
+
+  /**
+   * Convenience method for getting a JSON Serialiser configured with the
+   * current namespace.
+   */
+  get serialiser() {
+    return new _JSONSerialiser.default(this);
+  }
+}
+
+// Set up the circular reference for JSONSerialiser
+_JSONSerialiser.default.prototype.Namespace = Namespace;
+var _default = exports.default = Namespace;

package/src/Namespace.mjs

@@ -0,0 +1,206 @@
+import JSONSerialiser from "./serialisers/JSONSerialiser.mjs";
+import * as elements from "./registration.mjs";
+const isNull = value => value === null;
+const isString = value => typeof value === 'string';
+const isNumber = value => typeof value === 'number';
+const isBoolean = value => typeof value === 'boolean';
+const isObject = value => value !== null && typeof value === 'object';
+
+/**
+ * Constructor type for Element classes.
+ * @public
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+
+/**
+ * Function to test if a value should be converted to a specific element type.
+ * @public
+ */
+
+/**
+ * Tuple of detection test and element class.
+ * @public
+ */
+
+/**
+ * Options for Namespace constructor.
+ * @public
+ */
+
+/**
+ * Plugin interface for extending Namespace.
+ * @public
+ */
+
+/**
+ * Map of registered element classes.
+ * @public
+ */
+
+/**
+ * A refract element implementation with an extensible namespace, able to
+ * load other namespaces into it.
+ *
+ * The namespace allows you to register your own classes to be instantiated
+ * when a particular refract element is encountered, and allows you to specify
+ * which elements get instantiated for existing JavaScript objects.
+ *
+ * @public
+ */
+class Namespace {
+  elementMap = {};
+  elementDetection = [];
+  Element;
+  KeyValuePair;
+  _elements;
+  _attributeElementKeys = [];
+  _attributeElementArrayKeys = [];
+  constructor(options) {
+    this.Element = elements.Element;
+    this.KeyValuePair = elements.KeyValuePair;
+    if (!options || !options.noDefault) {
+      this.useDefault();
+    }
+  }
+
+  /**
+   * Use a namespace plugin or load a generic plugin.
+   */
+  use(plugin) {
+    if (plugin.namespace) {
+      plugin.namespace({
+        base: this
+      });
+    }
+    if (plugin.load) {
+      plugin.load({
+        base: this
+      });
+    }
+    return this;
+  }
+
+  /**
+   * Use the default namespace. This preloads all the default elements
+   * into this registry instance.
+   */
+  useDefault() {
+    // Set up classes for default elements
+    this.register('null', elements.NullElement).register('string', elements.StringElement).register('number', elements.NumberElement).register('boolean', elements.BooleanElement).register('array', elements.ArrayElement).register('object', elements.ObjectElement).register('member', elements.MemberElement).register('ref', elements.RefElement).register('link', elements.LinkElement);
+
+    // Add instance detection functions to convert existing objects into
+    // the corresponding refract elements.
+    this.detect(isNull, elements.NullElement, false).detect(isString, elements.StringElement, false).detect(isNumber, elements.NumberElement, false).detect(isBoolean, elements.BooleanElement, false).detect(Array.isArray, elements.ArrayElement, false).detect(isObject, elements.ObjectElement, false);
+    return this;
+  }
+
+  /**
+   * Register a new element class for an element.
+   */
+  register(name, ElementClass) {
+    this._elements = undefined;
+    this.elementMap[name] = ElementClass;
+    return this;
+  }
+
+  /**
+   * Unregister a previously registered class for an element.
+   */
+  unregister(name) {
+    this._elements = undefined;
+    delete this.elementMap[name];
+    return this;
+  }
+
+  /**
+   * Add a new detection function to determine which element
+   * class to use when converting existing JS instances into
+   * refract elements.
+   */
+  detect(test, ElementClass, givenPrepend) {
+    const prepend = givenPrepend === undefined ? true : givenPrepend;
+    if (prepend) {
+      this.elementDetection.unshift([test, ElementClass]);
+    } else {
+      this.elementDetection.push([test, ElementClass]);
+    }
+    return this;
+  }
+
+  /**
+   * Convert an existing JavaScript object into refract element instances.
+   * If the item passed in is already refracted, then it is returned unmodified.
+   */
+  toElement(value) {
+    if (value instanceof this.Element) {
+      return value;
+    }
+    let element;
+    for (const [test, ElementClass] of this.elementDetection) {
+      if (test(value)) {
+        element = new ElementClass(value);
+        break;
+      }
+    }
+    return element;
+  }
+
+  /**
+   * Get an element class given an element name.
+   */
+  getElementClass(element) {
+    const ElementClass = this.elementMap[element];
+    if (ElementClass === undefined) {
+      // Fall back to the base element. We may not know what
+      // to do with the `content`, but downstream software
+      // may know.
+      return this.Element;
+    }
+    return ElementClass;
+  }
+
+  /**
+   * Convert a refract document into refract element instances.
+   */
+  fromRefract(doc) {
+    return this.serialiser.deserialise(doc);
+  }
+
+  /**
+   * Convert an element to a Refracted JSON object.
+   */
+  toRefract(element) {
+    return this.serialiser.serialise(element);
+  }
+
+  /**
+   * Get an object that contains all registered element classes, where
+   * the key is the PascalCased element name and the value is the class.
+   */
+  get elements() {
+    if (this._elements === undefined) {
+      this._elements = {
+        Element: this.Element
+      };
+      Object.keys(this.elementMap).forEach(name => {
+        // Currently, all registered element types use a camelCaseName.
+        // Converting to PascalCase is as simple as upper-casing the first letter.
+        const pascal = name[0].toUpperCase() + name.substring(1);
+        this._elements[pascal] = this.elementMap[name];
+      });
+    }
+    return this._elements;
+  }
+
+  /**
+   * Convenience method for getting a JSON Serialiser configured with the
+   * current namespace.
+   */
+  get serialiser() {
+    return new JSONSerialiser(this);
+  }
+}
+
+// Set up the circular reference for JSONSerialiser
+JSONSerialiser.prototype.Namespace = Namespace;
+export default Namespace;