sanity-plugin-taxonomy-manager 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,44 @@
+# Changelog
+All notable changes to this project will be documented in this file.
+
+The format of this document is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [TODO] 
+- Initial development release.
+
+## [0.1.0] - 2022-03-17
+### Added
+- Update README with installation, basic use instructions, and development warning
+- Add changelog
+- Migrate SKOS Taxonomy Management schemas from local development branch to (this) plugin repository
+
+<!---
+## Change Log Principles
+- Changelogs are for humans, not machines.
+- There should be an entry for every single version.
+- The same types of changes should be grouped.
+- Versions and sections should be linkable.
+- The latest version comes first.
+- The release date of each version is displayed.
+- Mention whether you follow Semantic Versioning.
+
+## Tags
+### Added
+- for new features.
+### Changed
+- for changes in existing functionality.
+### Deprecated
+- for soon-to-be removed features.
+### Removed
+- for now removed features.
+### Fixed
+- for any bug fixes.
+### Security
+- in case of vulnerabilities.
+
+### Unreleased 
+- Keep at the top to track upcoming changes.
+- People can see what changes they might expect in upcoming releases
+- At release time, you can move the Unreleased section changes into a new release version section.
+--->

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Andy Fitzgerald
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,91 @@
+# Sanity Plugin Taxonomy Manager
+
+#### WARNING: This plugin is still in development. Please do not use it in production until this warning is removed.
+
+Create and manage [SKOS](https://www.w3.org/TR/skos-primer/) compliant taxonomies, thesauri, and classification schemes in Sanity Studio.
+
+![sanity-taxonomy-manager-poc-demo](https://user-images.githubusercontent.com/3710835/158623598-04a473b4-a720-4c37-adca-6d39cd0c688c.gif)
+
+## Features
+
+- Adds three document types to your Sanity schema which are used to generate SKOS compliant concepts and concept schemes: `skosConcept`, `skosConceptScheme`, and `skosTaxonomySettings`
+- Pre-populates [base URI](https://www.w3.org/TR/skos-primer/#secconcept) and [concept scheme](https://www.w3.org/TR/skos-primer/#secscheme) values for new concepts
+- Validates [disjunction between Broader and Related relationships](https://www.w3.org/TR/skos-reference/#L2422)
+- Validates [disjunction between Preferred and Alternate/Hidden labels](https://www.w3.org/TR/skos-reference/#L1567)
+
+## Installation
+
+Install using the [Sanity CLI](https://www.sanity.io/docs/cli).
+
+#### NOTE: This plugin is still in development. Please do not use it in production until this warning is removed.
+
+```bash
+$ sanity install taxonomy-manager
+```
+
+## Usage
+
+1. Create the Taxonomy Settings doc and set your taxonomy bases IRI. 
+2. Create a [Concept Scheme](https://www.w3.org/TR/skos-reference/#schemes) to group related concepts (optional)
+3. Create and describe Concepts. 
+    - All fields *except* PrefLabel are optional, and are to be used as best fits the needs of your information modeling task. 
+    - All Concept fields map to elements of the machine readable data model described in the [W3C SKOS Recommendation](https://www.w3.org/TR/skos-reference/). 
+4. Tag resources with concepts and then integrate into search indexing, navigation, and semantic web services.
+    - 👉  Examples to come!
+
+## Configuration
+
+You can use [Structure Builder](https://www.sanity.io/docs/structure-builder-reference) to create a separate area for your taxonomy tools.
+
+```js
+import {RiNodeTree} from 'react-icons/ri'
+import {AiFillTags,AiOutlineTags} from 'react-icons/ai'
+
+const hiddenDocTypes = (listItem) =>
+!['skosTaxonomySettings', 'skosConcept', 'skosConceptScheme'].includes(
+  listItem.getId()
+)
+
+export default () =>
+  // ... other structure builder items
+  S.divider(),
+  S.listItem()
+    .title('Concepts')
+    .icon(AiFillTags)
+    .child(
+      S.documentList()
+        .title('Concepts')
+        .filter('_type == "skosConcept"')
+    ),
+  S.listItem()
+  .title('Taxonomy Schemes')
+  .icon(RiNodeTree)
+  .child(
+    S.documentList()
+      .title('Taxonomy Schemes')
+      .filter('_type == "skosConceptScheme"')
+  ),
+  S.listItem()
+  .title('Taxonomy Settings')
+  .icon(RiSettings4Line)
+  .child(
+    S.document()
+    .schemaType('skosTaxonomySettings')
+    .documentId('skosTaxonomySettings')
+    ),
+    S.divider(),
+  // ... other structure builder items
+```
+
+## [SKOS Overview](https://www.w3.org/TR/skos-reference/)
+
+> The Simple Knowledge Organization System (SKOS) is a common data model for sharing and linking knowledge organization systems via the Web.
+>
+>Many knowledge organization systems, such as thesauri, taxonomies, classification schemes and subject heading systems, share a similar structure, and are used in similar applications. SKOS captures much of this similarity and makes it explicit, to enable data and technology sharing across diverse applications.
+>
+>The SKOS data model provides a standard, low-cost migration path for porting existing knowledge organization systems to the Semantic Web. SKOS also provides a lightweight, intuitive language for developing and sharing new knowledge organization systems. It may be used on its own, or in combination with formal knowledge representation languages such as the Web Ontology language (OWL).
+
+## License
+
+MIT © Andy Fitzgerald
+See LICENSE

package/_local/POC images/README.md

@@ -0,0 +1,7 @@
+## Config File
+
+`config.dist.json` is where the plugin config object lives. 
+- It is installed in the Sanity /config folder when the plugin is installed. 
+- This is where use accessible plugin config options should go. 
+- If/when I want to use this, move it back into the plugin root directory. 
+- Be sure to add config instructions to the README file.

package/_local/POC images/config.dist.json

@@ -0,0 +1,3 @@
+{
+  "add-config": "here"
+}

package/lib/components/prefLabel.js

@@ -0,0 +1,89 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _react = _interopRequireDefault(require("react"));
+
+var _components = require("@sanity/base/components");
+
+var _ui = require("@sanity/ui");
+
+var _PatchEvent = _interopRequireWildcard(require("@sanity/form-builder/PatchEvent"));
+
+var _autoId = require("@reach/auto-id");
+
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+/**
+ * PrefLabel input component for SKOS Concept
+ * This component creates a Concept IRI preview to help taxonomy managers avoid errors in minting URIs.
+ */
+// hook to generate unique IDs
+var PrefLabel = /*#__PURE__*/_react.default.forwardRef((props, ref) => {
+  var type = props.type,
+      value = props.value,
+      readOnly = props.readOnly,
+      placeholder = props.placeholder,
+      markers = props.markers,
+      presence = props.presence,
+      compareValue = props.compareValue,
+      onFocus = props.onFocus,
+      onBlur = props.onBlur,
+      onChange = props.onChange,
+      parent = props.parent; // Creates a unique ID for input
+
+  var inputId = (0, _autoId.useId)(); // Creates a change handler for patching data
+
+  var handleChange = _react.default.useCallback( // useCallback will help with performance
+  event => {
+    var inputValue = event.currentTarget.value; // get current value
+    // if the value exists, set the data, if not, unset the data
+
+    onChange(_PatchEvent.default.from(inputValue ? (0, _PatchEvent.set)(inputValue) : (0, _PatchEvent.unset)()));
+  }, [onChange]);
+
+  return /*#__PURE__*/_react.default.createElement(_ui.Stack, {
+    space: 1
+  }, /*#__PURE__*/_react.default.createElement(_components.FormField, {
+    description: type.description,
+    title: type.title,
+    __unstable_markers: markers // Handles all markers including validation
+    ,
+    __unstable_presence: presence // Handles presence avatars
+    ,
+    compareValue: compareValue // Handles "edited" status
+    ,
+    inputId: inputId // Allows the label to connect to the input field
+
+  }, /*#__PURE__*/_react.default.createElement(_ui.TextInput, {
+    id: inputId // A unique ID for this input
+    ,
+    onChange: handleChange // A function to call when the input value changes
+    ,
+    value: value // Current field value
+    ,
+    readOnly: readOnly // If "readOnly" is defined make this field read only
+    ,
+    placeholder: placeholder // If placeholder is defined, display placeholder text
+    ,
+    onFocus: onFocus // Handles focus events
+    ,
+    onBlur: onBlur // Handles blur events
+    ,
+    ref: ref
+  })), /*#__PURE__*/_react.default.createElement(_ui.Text, {
+    muted: true,
+    size: 1
+  }, /*#__PURE__*/_react.default.createElement("strong", null, "Concept IRI: "), parent.conceptIriBase ? parent.conceptIriBase.iriValue : '[base URI not defined] ', value === null || value === void 0 ? void 0 : value.replaceAll(' ', '')));
+});
+
+var _default = PrefLabel;
+exports.default = _default;
+//# sourceMappingURL=prefLabel.js.map

package/lib/components/prefLabel.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/components/prefLabel.js"],"names":["PrefLabel","React","forwardRef","props","ref","type","value","readOnly","placeholder","markers","presence","compareValue","onFocus","onBlur","onChange","parent","inputId","handleChange","useCallback","event","inputValue","currentTarget","PatchEvent","from","description","title","conceptIriBase","iriValue","replaceAll"],"mappings":";;;;;;;AAIA;;AACA;;AACA;;AACA;;AACA;;;;;;;;AARA;AACA;AACA;AACA;AAKqC;AAErC,IAAMA,SAAS,gBAAGC,eAAMC,UAAN,CAAiB,CAACC,KAAD,EAAQC,GAAR,KAAgB;AACjD,MACEC,IADF,GAYIF,KAZJ,CACEE,IADF;AAAA,MAEEC,KAFF,GAYIH,KAZJ,CAEEG,KAFF;AAAA,MAGEC,QAHF,GAYIJ,KAZJ,CAGEI,QAHF;AAAA,MAIEC,WAJF,GAYIL,KAZJ,CAIEK,WAJF;AAAA,MAKEC,OALF,GAYIN,KAZJ,CAKEM,OALF;AAAA,MAMEC,QANF,GAYIP,KAZJ,CAMEO,QANF;AAAA,MAOEC,YAPF,GAYIR,KAZJ,CAOEQ,YAPF;AAAA,MAQEC,OARF,GAYIT,KAZJ,CAQES,OARF;AAAA,MASEC,MATF,GAYIV,KAZJ,CASEU,MATF;AAAA,MAUEC,QAVF,GAYIX,KAZJ,CAUEW,QAVF;AAAA,MAWEC,MAXF,GAYIZ,KAZJ,CAWEY,MAXF,CADiD,CAejD;;AACA,MAAMC,OAAO,GAAG,oBAAhB,CAhBiD,CAkBjD;;AACA,MAAMC,YAAY,GAAGhB,eAAMiB,WAAN,EACnB;AACCC,EAAAA,KAAD,IAAW;AACT,QAAMC,UAAU,GAAGD,KAAK,CAACE,aAAN,CAAoBf,KAAvC,CADS,CACoC;AAC7C;;AACAQ,IAAAA,QAAQ,CAACQ,oBAAWC,IAAX,CAAgBH,UAAU,GAAG,qBAAIA,UAAJ,CAAH,GAAqB,wBAA/C,CAAD,CAAR;AACD,GANkB,EAOnB,CAACN,QAAD,CAPmB,CAArB;;AAUA,sBACE,6BAAC,SAAD;AAAO,IAAA,KAAK,EAAE;AAAd,kBACE,6BAAC,qBAAD;AACE,IAAA,WAAW,EAAET,IAAI,CAACmB,WADpB;AAEE,IAAA,KAAK,EAAEnB,IAAI,CAACoB,KAFd;AAGE,IAAA,kBAAkB,EAAEhB,OAHtB,CAG+B;AAH/B;AAIE,IAAA,mBAAmB,EAAEC,QAJvB,CAIiC;AAJjC;AAKE,IAAA,YAAY,EAAEC,YALhB,CAK8B;AAL9B;AAME,IAAA,OAAO,EAAEK,OANX,CAMoB;;AANpB,kBAQE,6BAAC,aAAD;AACE,IAAA,EAAE,EAAEA,OADN,CACe;AADf;AAEE,IAAA,QAAQ,EAAEC,YAFZ,CAE0B;AAF1B;AAGE,IAAA,KAAK,EAAEX,KAHT,CAGgB;AAHhB;AAIE,IAAA,QAAQ,EAAEC,QAJZ,CAIsB;AAJtB;AAKE,IAAA,WAAW,EAAEC,WALf,CAK4B;AAL5B;AAME,IAAA,OAAO,EAAEI,OANX,CAMoB;AANpB;AAOE,IAAA,MAAM,EAAEC,MAPV,CAOkB;AAPlB;AAQE,IAAA,GAAG,EAAET;AARP,IARF,CADF,eAoBE,6BAAC,QAAD;AAAM,IAAA,KAAK,MAAX;AAAY,IAAA,IAAI,EAAE;AAAlB,kBACE,6DADF,EAEGW,MAAM,CAACW,cAAP,GAAwBX,MAAM,CAACW,cAAP,CAAsBC,QAA9C,GAAyD,yBAF5D,EAGGrB,KAHH,aAGGA,KAHH,uBAGGA,KAAK,CAAEsB,UAAP,CAAkB,GAAlB,EAAuB,EAAvB,CAHH,CApBF,CADF;AA4BD,CAzDiB,CAAlB;;eA2De5B,S","sourcesContent":["/**\n * PrefLabel input component for SKOS Concept\n * This component creates a Concept IRI preview to help taxonomy managers avoid errors in minting URIs.\n */\nimport React from 'react'\nimport {FormField} from '@sanity/base/components'\nimport {TextInput, Stack, Text} from '@sanity/ui'\nimport PatchEvent, {set, unset} from '@sanity/form-builder/PatchEvent'\nimport {useId} from '@reach/auto-id' // hook to generate unique IDs\n\nconst PrefLabel = React.forwardRef((props, ref) => {\n  const {\n    type, // Schema information\n    value, // Current field value\n    readOnly, // Boolean if field is not editable\n    placeholder, // Placeholder text from the schema\n    markers, // Markers including validation rules\n    presence, // Presence information for collaborative avatars\n    compareValue, // Value to check for \"edited\" functionality\n    onFocus, // Method to handle focus state\n    onBlur, // Method to handle blur state\n    onChange, // Method to handle patch events\n    parent,\n  } = props\n\n  // Creates a unique ID for input\n  const inputId = useId()\n\n  // Creates a change handler for patching data\n  const handleChange = React.useCallback(\n    // useCallback will help with performance\n    (event) => {\n      const inputValue = event.currentTarget.value // get current value\n      // if the value exists, set the data, if not, unset the data\n      onChange(PatchEvent.from(inputValue ? set(inputValue) : unset()))\n    },\n    [onChange]\n  )\n\n  return (\n    <Stack space={1}>\n      <FormField\n        description={type.description}\n        title={type.title}\n        __unstable_markers={markers} // Handles all markers including validation\n        __unstable_presence={presence} // Handles presence avatars\n        compareValue={compareValue} // Handles \"edited\" status\n        inputId={inputId} // Allows the label to connect to the input field\n      >\n        <TextInput\n          id={inputId} // A unique ID for this input\n          onChange={handleChange} // A function to call when the input value changes\n          value={value} // Current field value\n          readOnly={readOnly} // If \"readOnly\" is defined make this field read only\n          placeholder={placeholder} // If placeholder is defined, display placeholder text\n          onFocus={onFocus} // Handles focus events\n          onBlur={onBlur} // Handles blur events\n          ref={ref}\n        />\n      </FormField>\n      <Text muted size={1}>\n        <strong>Concept IRI: </strong>\n        {parent.conceptIriBase ? parent.conceptIriBase.iriValue : '[base URI not defined] '}\n        {value?.replaceAll(' ', '')}\n      </Text>\n    </Stack>\n  )\n})\n\nexport default PrefLabel\n"],"file":"prefLabel.js"}

package/lib/objects/baseIri.js

@@ -0,0 +1,28 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+/**
+ * Base Internationalized Resource Identifier object for Sanity Taxonomy Manager
+ * This field is created as an object in order to present it as collapsed in the Sanity Studio UI.
+ */
+var _default = {
+  name: 'baseIri',
+  title: 'Base IRI',
+  type: 'object',
+  fields: [{
+    name: 'iriValue',
+    title: 'IRI Value',
+    type: 'url',
+    description: 'The W3C encourages the use of HTTP URIs when minting concept URIs since they are resolvable to representations that can be accessed using standard Web technologies.'
+  }],
+  options: {
+    collapsible: true,
+    collapsed: true
+  }
+};
+exports.default = _default;
+//# sourceMappingURL=baseIri.js.map

package/lib/objects/baseIri.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/objects/baseIri.js"],"names":["name","title","type","fields","description","options","collapsible","collapsed"],"mappings":";;;;;;;AAAA;AACA;AACA;AACA;eACe;AACbA,EAAAA,IAAI,EAAE,SADO;AAEbC,EAAAA,KAAK,EAAE,UAFM;AAGbC,EAAAA,IAAI,EAAE,QAHO;AAIbC,EAAAA,MAAM,EAAE,CACN;AACEH,IAAAA,IAAI,EAAE,UADR;AAEEC,IAAAA,KAAK,EAAE,WAFT;AAGEC,IAAAA,IAAI,EAAE,KAHR;AAIEE,IAAAA,WAAW,EACT;AALJ,GADM,CAJK;AAabC,EAAAA,OAAO,EAAE;AACPC,IAAAA,WAAW,EAAE,IADN;AAEPC,IAAAA,SAAS,EAAE;AAFJ;AAbI,C","sourcesContent":["/**\n * Base Internationalized Resource Identifier object for Sanity Taxonomy Manager\n * This field is created as an object in order to present it as collapsed in the Sanity Studio UI.\n */\nexport default {\n  name: 'baseIri',\n  title: 'Base IRI',\n  type: 'object',\n  fields: [\n    {\n      name: 'iriValue',\n      title: 'IRI Value',\n      type: 'url',\n      description:\n        'The W3C encourages the use of HTTP URIs when minting concept URIs since they are resolvable to representations that can be accessed using standard Web technologies.',\n    },\n  ],\n  options: {\n    collapsible: true,\n    collapsed: true,\n  },\n}\n"],"file":"baseIri.js"}

package/lib/skosConcept.js

@@ -0,0 +1,251 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _client = _interopRequireDefault(require("part:@sanity/base/client"));
+
+var _ai = require("react-icons/ai");
+
+var _prefLabel = _interopRequireDefault(require("./components/prefLabel"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
+
+function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
+
+var client = _client.default.withConfig({
+  apiVersion: '2021-03-25'
+});
+
+var _default = {
+  name: 'skosConcept',
+  title: 'Concepts',
+  type: 'document',
+  icon: _ai.AiFillTags,
+  initialValue: function () {
+    var _initialValue = _asyncToGenerator(function* () {
+      var _yield$client$fetch;
+
+      var iriBase = yield client.fetch("\n      *[_id == 'skosTaxonomySettings']{\n        'iriValue': baseIri,\n      }[0]\n    ");
+      var conceptIriBase = iriBase !== null && iriBase !== void 0 && iriBase.iriValue ? iriBase : undefined;
+      var scheme = (_yield$client$fetch = yield client.fetch("\n      *[_type == 'skosConceptScheme']{\n        '_type': 'reference',\n        '_ref': _id\n      }[0]\n    ")) !== null && _yield$client$fetch !== void 0 ? _yield$client$fetch : undefined;
+      return {
+        conceptIriBase: conceptIriBase,
+        scheme: scheme,
+        topConcept: false
+      };
+    });
+
+    function initialValue() {
+      return _initialValue.apply(this, arguments);
+    }
+
+    return initialValue;
+  }(),
+  validation: Rule => Rule.custom(fields => {
+    if (fields.altLabel && fields.hiddenLabel && fields.altLabel.filter(label => fields.hiddenLabel.includes(label)).length > 0 || fields.altLabel && fields.altLabel.includes(fields.prefLabel) || fields.hiddenLabel && fields.hiddenLabel.includes(fields.prefLabel)) return 'Preferred Label, Alternate Labels, and Hidden Labels must all be unique. Please remove any labels duplicated across label types.';
+    return true;
+  }),
+  groups: [{
+    name: 'relationship',
+    title: 'Relationships'
+  }, {
+    name: 'label',
+    title: 'Labels'
+  }, {
+    name: 'note',
+    title: 'Documentation'
+  }],
+  fields: [{
+    name: 'prefLabel',
+    title: 'Preferred Label',
+    group: ['label', 'relationship'],
+    type: 'string',
+    description: 'The preferred lexical label for this concept. This label is also used to unambiguously represent this concept via the concept IRI.',
+    validation: Rule => Rule.required().error('Concepts must have a preferred label'),
+    inputComponent: _prefLabel.default
+  }, {
+    name: 'conceptIriBase',
+    title: 'Edit the base IRI',
+    type: 'baseIri'
+  }, {
+    name: 'altLabel',
+    title: 'Alternate Label(s)',
+    group: 'label',
+    type: 'array',
+    description: 'Alternative labels can be used to assign synonyms, near-synonyms, abbreviations, and acronyms to a concept. Preferred, alternative, and hidden label sets must not overlap.',
+    of: [{
+      type: 'string'
+    }],
+    validation: Rule => Rule.unique()
+  }, {
+    name: 'hiddenLabel',
+    title: 'Hidden Label(s)',
+    group: 'label',
+    type: 'array',
+    description: 'Hidden labels are for character strings that need to be accessible to applications performing text-based indexing and search operations, but not visible otherwise. Hidden labels may for instance be used to include misspelled variants of other lexical labels. Preferred, alternative, and hidden label sets must not overlap.',
+    of: [{
+      type: 'string'
+    }],
+    validation: Rule => Rule.unique()
+  }, {
+    name: 'topConcept',
+    title: 'Top Concept',
+    group: 'relationship',
+    type: 'boolean',
+    description: 'Top concepts provide an efficient entry point to broader/narrower concept hierarchies and/or top level facets. By convention, resources can be a Top Concept, or have Broader relationships, but not both.',
+    hidden: _ref2 => {
+      var document = _ref2.document;
+      return document.broader ? document.broader.length > 0 : false;
+    }
+  }, {
+    name: 'broader',
+    title: 'Broader Concept(s)',
+    hidden: _ref3 => {
+      var document = _ref3.document;
+      return document.topConcept;
+    },
+    description: 'Broader relationships create a hierarchy between concepts, for example to create category/subcategory, part/whole, or class/instance relationships.',
+    group: 'relationship',
+    type: 'array',
+    of: [{
+      type: 'reference',
+      to: {
+        type: 'skosConcept'
+      },
+      options: {
+        filter: _ref4 => {
+          var document = _ref4.document;
+          return {
+            filter: '!(_id in $broader || _id in $related || _id in path("drafts.**") || _id == $self)',
+            params: {
+              self: document._id.replace('drafts.', ''),
+              broader: document.broader ? document.broader.map(_ref5 => {
+                var _ref = _ref5._ref;
+                return _ref;
+              }) : [],
+              related: document.related ? document.related.map(_ref6 => {
+                var _ref = _ref6._ref;
+                return _ref;
+              }) : []
+            }
+          };
+        }
+      }
+    }]
+  }, {
+    name: 'related',
+    title: 'Related Concept(s)',
+    description: 'Associative links between concepts indicate that the two are inherently "related", but that one is not in any way more general than the other. Broader and Associated relationships are mutually exclusive.',
+    group: 'relationship',
+    type: 'array',
+    of: [{
+      type: 'reference',
+      to: [{
+        type: 'skosConcept'
+      }],
+      options: {
+        filter: _ref7 => {
+          var document = _ref7.document;
+          return {
+            filter: '!(_id in $broader || _id in $related || _id in path("drafts.**") || _id == $self)',
+            params: {
+              self: document._id.replace('drafts.', ''),
+              broader: document.broader ? document.broader.map(_ref8 => {
+                var _ref = _ref8._ref;
+                return _ref;
+              }) : [],
+              related: document.related ? document.related.map(_ref9 => {
+                var _ref = _ref9._ref;
+                return _ref;
+              }) : []
+            }
+          };
+        }
+      }
+    }]
+  }, {
+    name: 'scheme',
+    title: 'Concept Scheme(s)',
+    group: 'relationship',
+    type: 'reference',
+    description: 'Concept schemes are used to group concepts into defined sets, such as thesauri, classification schemes, or facets.',
+    to: [{
+      type: 'skosConceptScheme'
+    }],
+    options: {
+      disableNew: true
+    }
+  }, {
+    name: 'scopeNote',
+    title: 'Scope Note',
+    type: 'text',
+    description: 'A brief statement on the intended meaning of this concept, especially as an indication of how the use of the concept is limited in indexing practice',
+    rows: 3,
+    group: 'note'
+  }, {
+    name: 'definition',
+    title: 'Definition',
+    type: 'text',
+    description: 'A complete explanation of the intended meaning of the concept',
+    rows: 3,
+    group: 'note'
+  }, {
+    name: 'example',
+    title: 'Examples',
+    type: 'text',
+    description: 'An example of the use of the concept.',
+    rows: 3,
+    group: 'note'
+  }],
+  orderings: [{
+    title: 'Top Concepts',
+    name: 'topConcept',
+    by: [{
+      field: 'topConcept',
+      direction: 'desc'
+    }, {
+      field: 'prefLabel',
+      direction: 'asc'
+    }]
+  }, {
+    title: 'Preferred Label',
+    name: 'prefLabel',
+    by: [{
+      field: 'prefLabel',
+      direction: 'asc'
+    }]
+  }],
+  preview: {
+    select: {
+      title: 'prefLabel',
+      topConcept: 'topConcept',
+      broader: 'broader.0.prefLabel',
+      broaderPlusOne: 'broader.0.broader.0.prefLabel',
+      broaderPlusTwo: 'broader.0.broader.0.broader.0.prefLabel'
+    },
+
+    prepare(_ref10) {
+      var title = _ref10.title,
+          topConcept = _ref10.topConcept,
+          broader = _ref10.broader,
+          broaderPlusOne = _ref10.broaderPlusOne,
+          broaderPlusTwo = _ref10.broaderPlusTwo;
+      var conceptBroader = [broaderPlusOne, broader].filter(Boolean);
+      var broaderPath = conceptBroader.length > 0 ? "".concat(conceptBroader.join(' ▷ '), " \u25B6\uFE0E ").concat(title) : '';
+      var hierarchy = broaderPlusTwo ? "... ".concat(broaderPath) : broaderPath;
+      return {
+        title: title,
+        subtitle: topConcept ? 'Top Concept' : hierarchy,
+        media: topConcept ? _ai.AiOutlineTag : _ai.AiFillTag
+      };
+    }
+
+  }
+};
+exports.default = _default;
+//# sourceMappingURL=skosConcept.js.map

package/lib/skosConcept.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/skosConcept.js"],"names":["client","sanityClient","withConfig","apiVersion","name","title","type","icon","AiFillTags","initialValue","iriBase","fetch","conceptIriBase","iriValue","undefined","scheme","topConcept","validation","Rule","custom","fields","altLabel","hiddenLabel","filter","label","includes","length","prefLabel","groups","group","description","required","error","inputComponent","PrefLabel","of","unique","hidden","document","broader","to","options","params","self","_id","replace","map","_ref","related","disableNew","rows","orderings","by","field","direction","preview","select","broaderPlusOne","broaderPlusTwo","prepare","conceptBroader","Boolean","broaderPath","join","hierarchy","subtitle","media","AiOutlineTag","AiFillTag"],"mappings":"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","sourcesContent":["/**\n * Sanity document scheme for SKOS Taxonomy Concepts\n * @todo PrefLabel: add document level validation that prevents the creation of two concepts with the same PrefLabel\n * @todo Hierarchy, Broader, & Associated: enforce disjointedness between Associated and BroaderTransitive (integrity constraint); prohibit cycles in hierarchical relations (best practice)\n * @todo Lexical labels: add child level validation so that offending labels are shown directly when a duplicate is entered. Then consider removing document level validation. cf. https://www.sanity.io/docs/validation#9e69d5db6f72\n * @todo Scheme initial value: Configure \"default\" option in Concept Scheme; configure initialValue to default to that selection.\n * @todo Abstract broader and related concept filter into reusable function. Need more clarity on what syntax \"filter:\" needs\n */\nimport sanityClient from 'part:@sanity/base/client'\nconst client = sanityClient.withConfig({apiVersion: '2021-03-25'})\nimport {AiFillTag, AiOutlineTag, AiFillTags} from 'react-icons/ai'\nimport PrefLabel from './components/prefLabel'\n\nexport default {\n  name: 'skosConcept',\n  title: 'Concepts',\n  type: 'document',\n  icon: AiFillTags,\n  initialValue: async () => {\n    const iriBase = await client.fetch(`\n      *[_id == 'skosTaxonomySettings']{\n        'iriValue': baseIri,\n      }[0]\n    `)\n    const conceptIriBase = iriBase?.iriValue ? iriBase : undefined\n    const scheme =\n      (await client.fetch(`\n      *[_type == 'skosConceptScheme']{\n        '_type': 'reference',\n        '_ref': _id\n      }[0]\n    `)) ?? undefined\n    return {\n      conceptIriBase: conceptIriBase,\n      scheme: scheme,\n      topConcept: false,\n    }\n  },\n  validation: (Rule) =>\n    Rule.custom((fields) => {\n      if (\n        (fields.altLabel &&\n          fields.hiddenLabel &&\n          fields.altLabel.filter((label) => fields.hiddenLabel.includes(label)).length > 0) ||\n        (fields.altLabel && fields.altLabel.includes(fields.prefLabel)) ||\n        (fields.hiddenLabel && fields.hiddenLabel.includes(fields.prefLabel))\n      )\n        return 'Preferred Label, Alternate Labels, and Hidden Labels must all be unique. Please remove any labels duplicated across label types.'\n      return true\n    }),\n  groups: [\n    {\n      name: 'relationship',\n      title: 'Relationships',\n    },\n    {\n      name: 'label',\n      title: 'Labels',\n    },\n    {\n      name: 'note',\n      title: 'Documentation',\n    },\n  ],\n  fields: [\n    {\n      name: 'prefLabel',\n      title: 'Preferred Label',\n      group: ['label', 'relationship'],\n      type: 'string',\n      description:\n        'The preferred lexical label for this concept. This label is also used to unambiguously represent this concept via the concept IRI.',\n      validation: (Rule) => Rule.required().error('Concepts must have a preferred label'),\n      inputComponent: PrefLabel,\n    },\n    {\n      name: 'conceptIriBase',\n      title: 'Edit the base IRI',\n      type: 'baseIri',\n    },\n    {\n      name: 'altLabel',\n      title: 'Alternate Label(s)',\n      group: 'label',\n      type: 'array',\n      description:\n        'Alternative labels can be used to assign synonyms, near-synonyms, abbreviations, and acronyms to a concept. Preferred, alternative, and hidden label sets must not overlap.',\n      of: [{type: 'string'}],\n      validation: (Rule) => Rule.unique(),\n    },\n    {\n      name: 'hiddenLabel',\n      title: 'Hidden Label(s)',\n      group: 'label',\n      type: 'array',\n      description:\n        'Hidden labels are for character strings that need to be accessible to applications performing text-based indexing and search operations, but not visible otherwise. Hidden labels may for instance be used to include misspelled variants of other lexical labels. Preferred, alternative, and hidden label sets must not overlap.',\n      of: [{type: 'string'}],\n      validation: (Rule) => Rule.unique(),\n    },\n    {\n      name: 'topConcept',\n      title: 'Top Concept',\n      group: 'relationship',\n      type: 'boolean',\n      description:\n        'Top concepts provide an efficient entry point to broader/narrower concept hierarchies and/or top level facets. By convention, resources can be a Top Concept, or have Broader relationships, but not both.',\n      hidden: ({document}) => (document.broader ? document.broader.length > 0 : false),\n    },\n    {\n      name: 'broader',\n      title: 'Broader Concept(s)',\n      hidden: ({document}) => document.topConcept,\n      description:\n        'Broader relationships create a hierarchy between concepts, for example to create category/subcategory, part/whole, or class/instance relationships.',\n      group: 'relationship',\n      type: 'array',\n      of: [\n        {\n          type: 'reference',\n          to: {type: 'skosConcept'},\n          options: {\n            filter: ({document}) => {\n              return {\n                filter:\n                  '!(_id in $broader || _id in $related || _id in path(\"drafts.**\") || _id == $self)',\n                params: {\n                  self: document._id.replace('drafts.', ''),\n                  broader: document.broader ? document.broader.map(({_ref}) => _ref) : [],\n                  related: document.related ? document.related.map(({_ref}) => _ref) : [],\n                },\n              }\n            },\n          },\n        },\n      ],\n    },\n    {\n      name: 'related',\n      title: 'Related Concept(s)',\n      description:\n        'Associative links between concepts indicate that the two are inherently \"related\", but that one is not in any way more general than the other. Broader and Associated relationships are mutually exclusive.',\n      group: 'relationship',\n      type: 'array',\n      of: [\n        {\n          type: 'reference',\n          to: [{type: 'skosConcept'}],\n          options: {\n            filter: ({document}) => {\n              return {\n                filter:\n                  '!(_id in $broader || _id in $related || _id in path(\"drafts.**\") || _id == $self)',\n                params: {\n                  self: document._id.replace('drafts.', ''),\n                  broader: document.broader ? document.broader.map(({_ref}) => _ref) : [],\n                  related: document.related ? document.related.map(({_ref}) => _ref) : [],\n                },\n              }\n            },\n          },\n        },\n      ],\n    },\n    {\n      name: 'scheme',\n      title: 'Concept Scheme(s)',\n      group: 'relationship',\n      type: 'reference',\n      description:\n        'Concept schemes are used to group concepts into defined sets, such as thesauri, classification schemes, or facets.',\n      to: [\n        {\n          type: 'skosConceptScheme',\n        },\n      ],\n      options: {\n        disableNew: true,\n      },\n    },\n    {\n      name: 'scopeNote',\n      title: 'Scope Note',\n      type: 'text',\n      description:\n        'A brief statement on the intended meaning of this concept, especially as an indication of how the use of the concept is limited in indexing practice',\n      rows: 3,\n      group: 'note',\n    },\n    {\n      name: 'definition',\n      title: 'Definition',\n      type: 'text',\n      description: 'A complete explanation of the intended meaning of the concept',\n      rows: 3,\n      group: 'note',\n    },\n    {\n      name: 'example',\n      title: 'Examples',\n      type: 'text',\n      description: 'An example of the use of the concept.',\n      rows: 3,\n      group: 'note',\n    },\n  ],\n  orderings: [\n    {\n      title: 'Top Concepts',\n      name: 'topConcept',\n      by: [\n        {field: 'topConcept', direction: 'desc'},\n        {field: 'prefLabel', direction: 'asc'},\n      ],\n    },\n    {\n      title: 'Preferred Label',\n      name: 'prefLabel',\n      by: [{field: 'prefLabel', direction: 'asc'}],\n    },\n  ],\n  preview: {\n    select: {\n      title: 'prefLabel',\n      topConcept: 'topConcept',\n      broader: 'broader.0.prefLabel',\n      broaderPlusOne: 'broader.0.broader.0.prefLabel',\n      broaderPlusTwo: 'broader.0.broader.0.broader.0.prefLabel',\n    },\n    prepare({title, topConcept, broader, broaderPlusOne, broaderPlusTwo}) {\n      const conceptBroader = [broaderPlusOne, broader].filter(Boolean)\n      const broaderPath =\n        conceptBroader.length > 0 ? `${conceptBroader.join(' ▷ ')} ▶︎ ${title}` : ''\n      const hierarchy = broaderPlusTwo ? `... ${broaderPath}` : broaderPath\n      return {\n        title: title,\n        subtitle: topConcept ? 'Top Concept' : hierarchy,\n        media: topConcept ? AiOutlineTag : AiFillTag,\n      }\n    },\n  },\n}\n"],"file":"skosConcept.js"}

package/lib/skosConceptScheme.js

@@ -0,0 +1,49 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _ri = require("react-icons/ri");
+
+/**
+ * Sanity document scheme for SKOS Concept Schemes
+ * @todo Afford setting a "default" scheme which is used as an initial value for new concepts. When no default is set, concepts are created without any scheme.
+ * @todo Add administrative metadata: author, date, last revised, etc.
+ * @todo Consider adding informational lists to this view (via custom input component): number of terms, list of terms, links. Perhaps eventually a navigable tree view.
+ */
+var _default = {
+  name: 'skosConceptScheme',
+  title: 'Taxonomy Schemes',
+  type: 'document',
+  icon: _ri.RiNodeTree,
+  fields: [{
+    name: 'title',
+    title: 'Taxonomy Identifier',
+    type: 'string',
+    description: 'Concept schemes are used to group concepts into defined sets, such as thesauri, classification schemes, or facets. Concepts may belong on many (or no) concept schemes, and you may create as many (or few) concept schemes as you like.'
+  }, {
+    name: 'description',
+    title: 'Description',
+    type: 'text',
+    rows: 3,
+    description: 'Describe the intended use of this scheme.'
+  }],
+  preview: {
+    select: {
+      title: 'title'
+    },
+
+    prepare(_ref) {
+      var title = _ref.title;
+      return {
+        title: title,
+        media: _ri.RiNodeTree
+      };
+    }
+
+  }
+};
+exports.default = _default;
+//# sourceMappingURL=skosConceptScheme.js.map

package/lib/skosConceptScheme.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/skosConceptScheme.js"],"names":["name","title","type","icon","RiNodeTree","fields","description","rows","preview","select","prepare","media"],"mappings":";;;;;;;AAMA;;AANA;AACA;AACA;AACA;AACA;AACA;eAGe;AACbA,EAAAA,IAAI,EAAE,mBADO;AAEbC,EAAAA,KAAK,EAAE,kBAFM;AAGbC,EAAAA,IAAI,EAAE,UAHO;AAIbC,EAAAA,IAAI,EAAEC,cAJO;AAKbC,EAAAA,MAAM,EAAE,CACN;AACEL,IAAAA,IAAI,EAAE,OADR;AAEEC,IAAAA,KAAK,EAAE,qBAFT;AAGEC,IAAAA,IAAI,EAAE,QAHR;AAIEI,IAAAA,WAAW,EACT;AALJ,GADM,EAQN;AACEN,IAAAA,IAAI,EAAE,aADR;AAEEC,IAAAA,KAAK,EAAE,aAFT;AAGEC,IAAAA,IAAI,EAAE,MAHR;AAIEK,IAAAA,IAAI,EAAE,CAJR;AAKED,IAAAA,WAAW,EAAE;AALf,GARM,CALK;AAqBbE,EAAAA,OAAO,EAAE;AACPC,IAAAA,MAAM,EAAE;AACNR,MAAAA,KAAK,EAAE;AADD,KADD;;AAIPS,IAAAA,OAAO,OAAU;AAAA,UAART,KAAQ,QAARA,KAAQ;AACf,aAAO;AACLA,QAAAA,KAAK,EAAEA,KADF;AAELU,QAAAA,KAAK,EAAEP;AAFF,OAAP;AAID;;AATM;AArBI,C","sourcesContent":["/**\n * Sanity document scheme for SKOS Concept Schemes\n * @todo Afford setting a \"default\" scheme which is used as an initial value for new concepts. When no default is set, concepts are created without any scheme.\n * @todo Add administrative metadata: author, date, last revised, etc.\n * @todo Consider adding informational lists to this view (via custom input component): number of terms, list of terms, links. Perhaps eventually a navigable tree view.\n */\nimport {RiNodeTree} from 'react-icons/ri'\n\nexport default {\n  name: 'skosConceptScheme',\n  title: 'Taxonomy Schemes',\n  type: 'document',\n  icon: RiNodeTree,\n  fields: [\n    {\n      name: 'title',\n      title: 'Taxonomy Identifier',\n      type: 'string',\n      description:\n        'Concept schemes are used to group concepts into defined sets, such as thesauri, classification schemes, or facets. Concepts may belong on many (or no) concept schemes, and you may create as many (or few) concept schemes as you like.',\n    },\n    {\n      name: 'description',\n      title: 'Description',\n      type: 'text',\n      rows: 3,\n      description: 'Describe the intended use of this scheme.',\n    },\n  ],\n  preview: {\n    select: {\n      title: 'title',\n    },\n    prepare({title}) {\n      return {\n        title: title,\n        media: RiNodeTree,\n      }\n    },\n  },\n}\n"],"file":"skosConceptScheme.js"}

package/lib/skosTaxonomySettings.js

@@ -0,0 +1,40 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+
+var _ri = require("react-icons/ri");
+
+/**
+ * Global SKOS taxonomy settings
+ * @todo BaseIri validation: figure out why the validation warning message shows up twice when there's no value.
+ * @todo Deal with Settings values when the Settings doc may not have been created from structure builder (with a 'skosTaxonomySettings' ID)
+ * @todo Add IRI pattern selector (or instructions): hash or slash; default to slash
+ * @todo Add IRI format selector: PrefLabel or UUID (perhaps from Sanity _id); default to PrefLabel
+ * @todo Consider adding an array (or list) here of Concept Schemes. These were originally envisioned as being accessed here, but are in their own top level grouping for now to support editing. They do need to be distinct, addressable entities, so they need to remain documents. 
+ */
+var _default = {
+  name: 'skosTaxonomySettings',
+  title: 'Taxonomy Settings',
+  type: 'document',
+  icon: _ri.RiSettings4Line,
+  // Once you've created your settings doc, uncomment this line to disable the creation of additional copies:
+  // __experimental_actions: [/*'create',*/ 'update', /*'delete',*/ 'publish'],
+  fields: [{
+    name: 'title',
+    title: 'Taxonomy Name',
+    type: 'string',
+    hidden: true,
+    initialValue: 'Taxonomy Settings'
+  }, {
+    name: 'baseIri',
+    title: 'Base IRI',
+    type: 'url',
+    description: 'The base IRI (Internationalised Resource Identifier) is used to specify the fully qualified name of taxonomy elements. The W3C encourages the use of HTTP URIs when minting concept URIs since they are resolvable to representations that can be accessed using standard Web technologies. The "base IRI" entered here is used as the default base for new concepts.',
+    validation: Rule => Rule.required().warning('Entering a Base IRI is highly recommended in order to ensure taxonomy integrity and interoperability.')
+  }]
+};
+exports.default = _default;
+//# sourceMappingURL=skosTaxonomySettings.js.map

package/lib/skosTaxonomySettings.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/skosTaxonomySettings.js"],"names":["name","title","type","icon","RiSettings4Line","fields","hidden","initialValue","description","validation","Rule","required","warning"],"mappings":";;;;;;;AAQA;;AARA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;eAGe;AACbA,EAAAA,IAAI,EAAE,sBADO;AAEbC,EAAAA,KAAK,EAAE,mBAFM;AAGbC,EAAAA,IAAI,EAAE,UAHO;AAIbC,EAAAA,IAAI,EAAEC,mBAJO;AAKb;AACA;AACAC,EAAAA,MAAM,EAAE,CACN;AACEL,IAAAA,IAAI,EAAE,OADR;AAEEC,IAAAA,KAAK,EAAE,eAFT;AAGEC,IAAAA,IAAI,EAAE,QAHR;AAIEI,IAAAA,MAAM,EAAE,IAJV;AAKEC,IAAAA,YAAY,EAAE;AALhB,GADM,EAQN;AACEP,IAAAA,IAAI,EAAE,SADR;AAEEC,IAAAA,KAAK,EAAE,UAFT;AAGEC,IAAAA,IAAI,EAAE,KAHR;AAIEM,IAAAA,WAAW,EACT,uWALJ;AAMEC,IAAAA,UAAU,EAAGC,IAAD,IACVA,IAAI,CAACC,QAAL,GAAgBC,OAAhB,CACE,uGADF;AAPJ,GARM;AAPK,C","sourcesContent":["/**\n * Global SKOS taxonomy settings\n * @todo BaseIri validation: figure out why the validation warning message shows up twice when there's no value.\n * @todo Deal with Settings values when the Settings doc may not have been created from structure builder (with a 'skosTaxonomySettings' ID)\n * @todo Add IRI pattern selector (or instructions): hash or slash; default to slash\n * @todo Add IRI format selector: PrefLabel or UUID (perhaps from Sanity _id); default to PrefLabel\n * @todo Consider adding an array (or list) here of Concept Schemes. These were originally envisioned as being accessed here, but are in their own top level grouping for now to support editing. They do need to be distinct, addressable entities, so they need to remain documents. \n */\nimport {RiSettings4Line} from 'react-icons/ri'\n\nexport default {\n  name: 'skosTaxonomySettings',\n  title: 'Taxonomy Settings',\n  type: 'document',\n  icon: RiSettings4Line,\n  // Once you've created your settings doc, uncomment this line to disable the creation of additional copies:\n  // __experimental_actions: [/*'create',*/ 'update', /*'delete',*/ 'publish'],\n  fields: [\n    {\n      name: 'title',\n      title: 'Taxonomy Name',\n      type: 'string',\n      hidden: true,\n      initialValue: 'Taxonomy Settings',\n    },\n    {\n      name: 'baseIri',\n      title: 'Base IRI',\n      type: 'url',\n      description:\n        'The base IRI (Internationalised Resource Identifier) is used to specify the fully qualified name of taxonomy elements. The W3C encourages the use of HTTP URIs when minting concept URIs since they are resolvable to representations that can be accessed using standard Web technologies. The \"base IRI\" entered here is used as the default base for new concepts.',\n      validation: (Rule) =>\n        Rule.required().warning(\n          'Entering a Base IRI is highly recommended in order to ensure taxonomy integrity and interoperability.'\n        ),\n    },\n  ],\n}\n"],"file":"skosTaxonomySettings.js"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "sanity-plugin-taxonomy-manager",
+  "version": "0.1.0",
+  "description": "Create and manage SKOS compliant taxonomies, thesauri, and classification schemes in Sanity Studio.",
+  "scripts": {
+    "lint": "eslint .",
+    "build": "sanipack build",
+    "watch": "sanipack build --watch",
+    "prepublishOnly": "sanipack build && sanipack verify"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/andybywire/sanity-plugin-taxonomy-manager.git"
+  },
+  "keywords": [
+    "sanity",
+    "sanity-plugin"
+  ],
+  "author": "Andy Fitzgerald",
+  "license": "MIT",
+  "dependencies": {
+    "@reach/auto-id": "^0.16.0",
+    "@sanity/base": "^2.28.2",
+    "@sanity/form-builder": "^2.29.1",
+    "@sanity/ui": "^0.37.5",
+    "react-icons": "^4.3.1"
+  },
+  "devDependencies": {
+    "eslint": "^7.32.0",
+    "eslint-config-prettier": "^8.5.0",
+    "eslint-config-sanity": "^5.1.0",
+    "eslint-plugin-react": "^7.29.4",
+    "prettier": "^2.5.1",
+    "sanipack": "^2.1.0"
+  },
+  "peerDependencies": {
+    "react": "^17.0.0"
+  },
+  "bugs": {
+    "url": "https://github.com/andybywire/sanity-plugin-taxonomy-manager/issues"
+  },
+  "homepage": "https://github.com/andybywire/sanity-plugin-taxonomy-manager#readme",
+  "prettier": {
+    "semi": false,
+    "printWidth": 100,
+    "bracketSpacing": false,
+    "singleQuote": true
+  },
+  "eslintConfig": {
+    "parser": "sanipack/babel/eslint-parser",
+    "extends": [
+      "sanity",
+      "sanity/react",
+      "prettier"
+    ],
+    "ignorePatterns": [
+      "lib/**/"
+    ]
+  }
+}

package/sanity.json

@@ -0,0 +1,24 @@
+{
+  "paths": {
+    "source": "./src",
+    "compiled": "./lib"
+  },
+  "parts": [
+    {
+      "implements": "part:@sanity/base/schema-type",
+      "path": "skosTaxonomySettings.js"
+    },
+    {
+      "implements": "part:@sanity/base/schema-type",
+      "path": "skosConceptScheme.js"
+    },
+    {
+      "implements": "part:@sanity/base/schema-type",
+      "path": "skosConcept.js"
+    },
+    {
+      "implements": "part:@sanity/base/schema-type",
+      "path": "objects/baseIri.js"
+    }
+  ]
+}

package/src/components/prefLabel.js

@@ -0,0 +1,70 @@
+/**
+ * PrefLabel input component for SKOS Concept
+ * This component creates a Concept IRI preview to help taxonomy managers avoid errors in minting URIs.
+ */
+import React from 'react'
+import {FormField} from '@sanity/base/components'
+import {TextInput, Stack, Text} from '@sanity/ui'
+import PatchEvent, {set, unset} from '@sanity/form-builder/PatchEvent'
+import {useId} from '@reach/auto-id' // hook to generate unique IDs
+
+const PrefLabel = React.forwardRef((props, ref) => {
+  const {
+    type, // Schema information
+    value, // Current field value
+    readOnly, // Boolean if field is not editable
+    placeholder, // Placeholder text from the schema
+    markers, // Markers including validation rules
+    presence, // Presence information for collaborative avatars
+    compareValue, // Value to check for "edited" functionality
+    onFocus, // Method to handle focus state
+    onBlur, // Method to handle blur state
+    onChange, // Method to handle patch events
+    parent,
+  } = props
+
+  // Creates a unique ID for input
+  const inputId = useId()
+
+  // Creates a change handler for patching data
+  const handleChange = React.useCallback(
+    // useCallback will help with performance
+    (event) => {
+      const inputValue = event.currentTarget.value // get current value
+      // if the value exists, set the data, if not, unset the data
+      onChange(PatchEvent.from(inputValue ? set(inputValue) : unset()))
+    },
+    [onChange]
+  )
+
+  return (
+    <Stack space={1}>
+      <FormField
+        description={type.description}
+        title={type.title}
+        __unstable_markers={markers} // Handles all markers including validation
+        __unstable_presence={presence} // Handles presence avatars
+        compareValue={compareValue} // Handles "edited" status
+        inputId={inputId} // Allows the label to connect to the input field
+      >
+        <TextInput
+          id={inputId} // A unique ID for this input
+          onChange={handleChange} // A function to call when the input value changes
+          value={value} // Current field value
+          readOnly={readOnly} // If "readOnly" is defined make this field read only
+          placeholder={placeholder} // If placeholder is defined, display placeholder text
+          onFocus={onFocus} // Handles focus events
+          onBlur={onBlur} // Handles blur events
+          ref={ref}
+        />
+      </FormField>
+      <Text muted size={1}>
+        <strong>Concept IRI: </strong>
+        {parent.conceptIriBase ? parent.conceptIriBase.iriValue : '[base URI not defined] '}
+        {value?.replaceAll(' ', '')}
+      </Text>
+    </Stack>
+  )
+})
+
+export default PrefLabel

package/src/objects/baseIri.js

@@ -0,0 +1,22 @@
+/**
+ * Base Internationalized Resource Identifier object for Sanity Taxonomy Manager
+ * This field is created as an object in order to present it as collapsed in the Sanity Studio UI.
+ */
+export default {
+  name: 'baseIri',
+  title: 'Base IRI',
+  type: 'object',
+  fields: [
+    {
+      name: 'iriValue',
+      title: 'IRI Value',
+      type: 'url',
+      description:
+        'The W3C encourages the use of HTTP URIs when minting concept URIs since they are resolvable to representations that can be accessed using standard Web technologies.',
+    },
+  ],
+  options: {
+    collapsible: true,
+    collapsed: true,
+  },
+}

package/src/skosConcept.js

@@ -0,0 +1,242 @@
+/**
+ * Sanity document scheme for SKOS Taxonomy Concepts
+ * @todo PrefLabel: add document level validation that prevents the creation of two concepts with the same PrefLabel
+ * @todo Hierarchy, Broader, & Associated: enforce disjointedness between Associated and BroaderTransitive (integrity constraint); prohibit cycles in hierarchical relations (best practice)
+ * @todo Lexical labels: add child level validation so that offending labels are shown directly when a duplicate is entered. Then consider removing document level validation. cf. https://www.sanity.io/docs/validation#9e69d5db6f72
+ * @todo Scheme initial value: Configure "default" option in Concept Scheme; configure initialValue to default to that selection.
+ * @todo Abstract broader and related concept filter into reusable function. Need more clarity on what syntax "filter:" needs
+ */
+import sanityClient from 'part:@sanity/base/client'
+const client = sanityClient.withConfig({apiVersion: '2021-03-25'})
+import {AiFillTag, AiOutlineTag, AiFillTags} from 'react-icons/ai'
+import PrefLabel from './components/prefLabel'
+
+export default {
+  name: 'skosConcept',
+  title: 'Concepts',
+  type: 'document',
+  icon: AiFillTags,
+  initialValue: async () => {
+    const iriBase = await client.fetch(`
+      *[_id == 'skosTaxonomySettings']{
+        'iriValue': baseIri,
+      }[0]
+    `)
+    const conceptIriBase = iriBase?.iriValue ? iriBase : undefined
+    const scheme =
+      (await client.fetch(`
+      *[_type == 'skosConceptScheme']{
+        '_type': 'reference',
+        '_ref': _id
+      }[0]
+    `)) ?? undefined
+    return {
+      conceptIriBase: conceptIriBase,
+      scheme: scheme,
+      topConcept: false,
+    }
+  },
+  validation: (Rule) =>
+    Rule.custom((fields) => {
+      if (
+        (fields.altLabel &&
+          fields.hiddenLabel &&
+          fields.altLabel.filter((label) => fields.hiddenLabel.includes(label)).length > 0) ||
+        (fields.altLabel && fields.altLabel.includes(fields.prefLabel)) ||
+        (fields.hiddenLabel && fields.hiddenLabel.includes(fields.prefLabel))
+      )
+        return 'Preferred Label, Alternate Labels, and Hidden Labels must all be unique. Please remove any labels duplicated across label types.'
+      return true
+    }),
+  groups: [
+    {
+      name: 'relationship',
+      title: 'Relationships',
+    },
+    {
+      name: 'label',
+      title: 'Labels',
+    },
+    {
+      name: 'note',
+      title: 'Documentation',
+    },
+  ],
+  fields: [
+    {
+      name: 'prefLabel',
+      title: 'Preferred Label',
+      group: ['label', 'relationship'],
+      type: 'string',
+      description:
+        'The preferred lexical label for this concept. This label is also used to unambiguously represent this concept via the concept IRI.',
+      validation: (Rule) => Rule.required().error('Concepts must have a preferred label'),
+      inputComponent: PrefLabel,
+    },
+    {
+      name: 'conceptIriBase',
+      title: 'Edit the base IRI',
+      type: 'baseIri',
+    },
+    {
+      name: 'altLabel',
+      title: 'Alternate Label(s)',
+      group: 'label',
+      type: 'array',
+      description:
+        'Alternative labels can be used to assign synonyms, near-synonyms, abbreviations, and acronyms to a concept. Preferred, alternative, and hidden label sets must not overlap.',
+      of: [{type: 'string'}],
+      validation: (Rule) => Rule.unique(),
+    },
+    {
+      name: 'hiddenLabel',
+      title: 'Hidden Label(s)',
+      group: 'label',
+      type: 'array',
+      description:
+        'Hidden labels are for character strings that need to be accessible to applications performing text-based indexing and search operations, but not visible otherwise. Hidden labels may for instance be used to include misspelled variants of other lexical labels. Preferred, alternative, and hidden label sets must not overlap.',
+      of: [{type: 'string'}],
+      validation: (Rule) => Rule.unique(),
+    },
+    {
+      name: 'topConcept',
+      title: 'Top Concept',
+      group: 'relationship',
+      type: 'boolean',
+      description:
+        'Top concepts provide an efficient entry point to broader/narrower concept hierarchies and/or top level facets. By convention, resources can be a Top Concept, or have Broader relationships, but not both.',
+      hidden: ({document}) => (document.broader ? document.broader.length > 0 : false),
+    },
+    {
+      name: 'broader',
+      title: 'Broader Concept(s)',
+      hidden: ({document}) => document.topConcept,
+      description:
+        'Broader relationships create a hierarchy between concepts, for example to create category/subcategory, part/whole, or class/instance relationships.',
+      group: 'relationship',
+      type: 'array',
+      of: [
+        {
+          type: 'reference',
+          to: {type: 'skosConcept'},
+          options: {
+            filter: ({document}) => {
+              return {
+                filter:
+                  '!(_id in $broader || _id in $related || _id in path("drafts.**") || _id == $self)',
+                params: {
+                  self: document._id.replace('drafts.', ''),
+                  broader: document.broader ? document.broader.map(({_ref}) => _ref) : [],
+                  related: document.related ? document.related.map(({_ref}) => _ref) : [],
+                },
+              }
+            },
+          },
+        },
+      ],
+    },
+    {
+      name: 'related',
+      title: 'Related Concept(s)',
+      description:
+        'Associative links between concepts indicate that the two are inherently "related", but that one is not in any way more general than the other. Broader and Associated relationships are mutually exclusive.',
+      group: 'relationship',
+      type: 'array',
+      of: [
+        {
+          type: 'reference',
+          to: [{type: 'skosConcept'}],
+          options: {
+            filter: ({document}) => {
+              return {
+                filter:
+                  '!(_id in $broader || _id in $related || _id in path("drafts.**") || _id == $self)',
+                params: {
+                  self: document._id.replace('drafts.', ''),
+                  broader: document.broader ? document.broader.map(({_ref}) => _ref) : [],
+                  related: document.related ? document.related.map(({_ref}) => _ref) : [],
+                },
+              }
+            },
+          },
+        },
+      ],
+    },
+    {
+      name: 'scheme',
+      title: 'Concept Scheme(s)',
+      group: 'relationship',
+      type: 'reference',
+      description:
+        'Concept schemes are used to group concepts into defined sets, such as thesauri, classification schemes, or facets.',
+      to: [
+        {
+          type: 'skosConceptScheme',
+        },
+      ],
+      options: {
+        disableNew: true,
+      },
+    },
+    {
+      name: 'scopeNote',
+      title: 'Scope Note',
+      type: 'text',
+      description:
+        'A brief statement on the intended meaning of this concept, especially as an indication of how the use of the concept is limited in indexing practice',
+      rows: 3,
+      group: 'note',
+    },
+    {
+      name: 'definition',
+      title: 'Definition',
+      type: 'text',
+      description: 'A complete explanation of the intended meaning of the concept',
+      rows: 3,
+      group: 'note',
+    },
+    {
+      name: 'example',
+      title: 'Examples',
+      type: 'text',
+      description: 'An example of the use of the concept.',
+      rows: 3,
+      group: 'note',
+    },
+  ],
+  orderings: [
+    {
+      title: 'Top Concepts',
+      name: 'topConcept',
+      by: [
+        {field: 'topConcept', direction: 'desc'},
+        {field: 'prefLabel', direction: 'asc'},
+      ],
+    },
+    {
+      title: 'Preferred Label',
+      name: 'prefLabel',
+      by: [{field: 'prefLabel', direction: 'asc'}],
+    },
+  ],
+  preview: {
+    select: {
+      title: 'prefLabel',
+      topConcept: 'topConcept',
+      broader: 'broader.0.prefLabel',
+      broaderPlusOne: 'broader.0.broader.0.prefLabel',
+      broaderPlusTwo: 'broader.0.broader.0.broader.0.prefLabel',
+    },
+    prepare({title, topConcept, broader, broaderPlusOne, broaderPlusTwo}) {
+      const conceptBroader = [broaderPlusOne, broader].filter(Boolean)
+      const broaderPath =
+        conceptBroader.length > 0 ? `${conceptBroader.join(' ▷ ')} ▶︎ ${title}` : ''
+      const hierarchy = broaderPlusTwo ? `... ${broaderPath}` : broaderPath
+      return {
+        title: title,
+        subtitle: topConcept ? 'Top Concept' : hierarchy,
+        media: topConcept ? AiOutlineTag : AiFillTag,
+      }
+    },
+  },
+}

package/src/skosConceptScheme.js

@@ -0,0 +1,41 @@
+/**
+ * Sanity document scheme for SKOS Concept Schemes
+ * @todo Afford setting a "default" scheme which is used as an initial value for new concepts. When no default is set, concepts are created without any scheme.
+ * @todo Add administrative metadata: author, date, last revised, etc.
+ * @todo Consider adding informational lists to this view (via custom input component): number of terms, list of terms, links. Perhaps eventually a navigable tree view.
+ */
+import {RiNodeTree} from 'react-icons/ri'
+
+export default {
+  name: 'skosConceptScheme',
+  title: 'Taxonomy Schemes',
+  type: 'document',
+  icon: RiNodeTree,
+  fields: [
+    {
+      name: 'title',
+      title: 'Taxonomy Identifier',
+      type: 'string',
+      description:
+        'Concept schemes are used to group concepts into defined sets, such as thesauri, classification schemes, or facets. Concepts may belong on many (or no) concept schemes, and you may create as many (or few) concept schemes as you like.',
+    },
+    {
+      name: 'description',
+      title: 'Description',
+      type: 'text',
+      rows: 3,
+      description: 'Describe the intended use of this scheme.',
+    },
+  ],
+  preview: {
+    select: {
+      title: 'title',
+    },
+    prepare({title}) {
+      return {
+        title: title,
+        media: RiNodeTree,
+      }
+    },
+  },
+}

package/src/skosTaxonomySettings.js

@@ -0,0 +1,38 @@
+/**
+ * Global SKOS taxonomy settings
+ * @todo BaseIri validation: figure out why the validation warning message shows up twice when there's no value.
+ * @todo Deal with Settings values when the Settings doc may not have been created from structure builder (with a 'skosTaxonomySettings' ID)
+ * @todo Add IRI pattern selector (or instructions): hash or slash; default to slash
+ * @todo Add IRI format selector: PrefLabel or UUID (perhaps from Sanity _id); default to PrefLabel
+ * @todo Consider adding an array (or list) here of Concept Schemes. These were originally envisioned as being accessed here, but are in their own top level grouping for now to support editing. They do need to be distinct, addressable entities, so they need to remain documents. 
+ */
+import {RiSettings4Line} from 'react-icons/ri'
+
+export default {
+  name: 'skosTaxonomySettings',
+  title: 'Taxonomy Settings',
+  type: 'document',
+  icon: RiSettings4Line,
+  // Once you've created your settings doc, uncomment this line to disable the creation of additional copies:
+  // __experimental_actions: [/*'create',*/ 'update', /*'delete',*/ 'publish'],
+  fields: [
+    {
+      name: 'title',
+      title: 'Taxonomy Name',
+      type: 'string',
+      hidden: true,
+      initialValue: 'Taxonomy Settings',
+    },
+    {
+      name: 'baseIri',
+      title: 'Base IRI',
+      type: 'url',
+      description:
+        'The base IRI (Internationalised Resource Identifier) is used to specify the fully qualified name of taxonomy elements. The W3C encourages the use of HTTP URIs when minting concept URIs since they are resolvable to representations that can be accessed using standard Web technologies. The "base IRI" entered here is used as the default base for new concepts.',
+      validation: (Rule) =>
+        Rule.required().warning(
+          'Entering a Base IRI is highly recommended in order to ensure taxonomy integrity and interoperability.'
+        ),
+    },
+  ],
+}