@lblod/ember-rdfa-editor-lblod-plugins 0.3.0 → 0.4.0

package/.release-it.json

@@ -0,0 +1,14 @@
+{
+  "github": {
+    "release": true
+  },
+  "plugins": {
+    "@release-it-plugins/lerna-changelog": {
+      "infile": "CHANGELOG.md",
+      "launchEditor": true
+    }
+  },
+  "npm": {
+    "publish": false
+  }
+}

package/.woodpecker/.release.yml

@@ -0,0 +1,15 @@
+pipeline:
+  install:
+    image: danlynn/ember-cli:4.4.0
+    commands:
+      - npm ci
+  release:
+    image: plugins/npm
+    settings:
+      token:
+        from_secret: npm_access_token
+    # Pipeline level conditions aren't supported yet:
+    # https://github.com/woodpecker-ci/woodpecker/issues/283
+when:
+  event: tag
+  tag: v*

package/.woodpecker/.test.yml

@@ -0,0 +1,23 @@
+
+pipeline:
+  install:
+    image: danlynn/ember-cli:4.4.0
+    commands:
+      - npm ci
+  lint-js:
+    image: danlynn/ember-cli:4.4.0
+    group: lint
+    commands:
+      - npm run lint:js
+  lint-hbs:
+    image: danlynn/ember-cli:4.4.0
+    group: lint
+    commands:
+      - npm run lint:hbs
+  test:
+    image: danlynn/ember-cli:4.4.0
+    commands:
+      - npm run test:ember || exit 0
+when:
+  event:
+    - pull_request

package/CHANGELOG.md

@@ -0,0 +1,84 @@
+
+
+
+
+
+
+
+
+## 0.4.0 (2022-12-01)
+
+#### :house: Internal
+* [#23](https://github.com/lblod/ember-rdfa-editor-lblod-plugins/pull/23) Add typescript support ([@elpoelma](https://github.com/elpoelma))
+* [#22](https://github.com/lblod/ember-rdfa-editor-lblod-plugins/pull/22) Move to classic ember addon ([@elpoelma](https://github.com/elpoelma))
+
+#### Committers: 1
+- Elena Poelman ([@elpoelma](https://github.com/elpoelma))
+
+## v0.3.1 (2022-11-24)
+
+#### :memo: Documentation
+* [#15](https://github.com/lblod/ember-rdfa-editor-lblod-plugins/pull/15) Add documentation to readme ([@elpoelma](https://github.com/elpoelma))
+
+#### Committers: 1
+- Elena Poelman ([@elpoelma](https://github.com/elpoelma))
+
+## v0.3.0 (2022-11-23)
+
+#### :rocket: Enhancement
+* [#7](https://github.com/lblod/ember-rdfa-editor-lblod-plugins/pull/7) Add roadsign regulation plugin ([@elpoelma](https://github.com/elpoelma))
+
+#### Committers: 1
+- Elena Poelman ([@elpoelma](https://github.com/elpoelma))
+
+## v0.2.0 (2022-11-23)
+
+#### :rocket: Enhancement
+* [#14](https://github.com/lblod/ember-rdfa-editor-lblod-plugins/pull/14) Add insert and template variable plugins ([@elpoelma](https://github.com/elpoelma))
+
+#### Committers: 1
+- Elena Poelman ([@elpoelma](https://github.com/elpoelma))
+
+## v0.1.3 (2022-11-23)
+
+#### :bug: Bug Fix
+* [#13](https://github.com/lblod/ember-rdfa-editor-lblod-plugins/pull/13) Fix path of table-of-contents outline component ([@elpoelma](https://github.com/elpoelma))
+
+#### Committers: 1
+- Elena Poelman ([@elpoelma](https://github.com/elpoelma))
+
+## v0.1.2 (2022-11-23)
+
+#### :house: Internal
+* [#12](https://github.com/lblod/ember-rdfa-editor-lblod-plugins/pull/12) Export config and translations ([@elpoelma](https://github.com/elpoelma))
+
+#### Committers: 1
+- Elena Poelman ([@elpoelma](https://github.com/elpoelma))
+
+## v0.1.1 (2022-11-23)
+
+#### :house: Internal
+* [#11](https://github.com/lblod/ember-rdfa-editor-lblod-plugins/pull/11) Loosen ember-data peerdep requirement to 3.27.0 ([@elpoelma](https://github.com/elpoelma))
+
+#### Committers: 1
+- Elena Poelman ([@elpoelma](https://github.com/elpoelma))
+
+## v0.1.0 (2022-11-23)
+
+#### :rocket: Enhancement
+* [#9](https://github.com/lblod/ember-rdfa-editor-lblod-plugins/pull/9) Add import-snippet plugin ([@elpoelma](https://github.com/elpoelma))
+* [#8](https://github.com/lblod/ember-rdfa-editor-lblod-plugins/pull/8) Add rdfa-date plugin ([@elpoelma](https://github.com/elpoelma))
+* [#3](https://github.com/lblod/ember-rdfa-editor-lblod-plugins/pull/3) Add standard-template plugin ([@elpoelma](https://github.com/elpoelma))
+* [#4](https://github.com/lblod/ember-rdfa-editor-lblod-plugins/pull/4) Add besluit-type plugin ([@elpoelma](https://github.com/elpoelma))
+* [#6](https://github.com/lblod/ember-rdfa-editor-lblod-plugins/pull/6) Add generate template plugin ([@elpoelma](https://github.com/elpoelma))
+* [#5](https://github.com/lblod/ember-rdfa-editor-lblod-plugins/pull/5) Add table-of-contents plugin ([@elpoelma](https://github.com/elpoelma))
+* [#2](https://github.com/lblod/ember-rdfa-editor-lblod-plugins/pull/2) Add citaten-plugin ([@elpoelma](https://github.com/elpoelma))
+
+#### :house: Internal
+* [#10](https://github.com/lblod/ember-rdfa-editor-lblod-plugins/pull/10) Set up woodpecker ([@elpoelma](https://github.com/elpoelma))
+* [#1](https://github.com/lblod/ember-rdfa-editor-lblod-plugins/pull/1) Setup basic test-app ([@elpoelma](https://github.com/elpoelma))
+
+#### Committers: 1
+- Elena Poelman ([@elpoelma](https://github.com/elpoelma))
+
+# Changelog

package/README.md

@@ -1,37 +1,334 @@
-ember-rdfa-editor-lblod-plugins
-==============================================================================
+# ember-rdfa-editor-lblod-plugins
 
-[Short description of the addon.]
 
+Ember v2 addon which bundles a collection of [ember-rdfa-editor](https://github.com/lblod/ember-rdfa-editor) plugins related to the LBLOD Project.
+
+
+## Compatibility
 
-Compatibility
-------------------------------------------------------------------------------
 
 * Ember.js v3.28 or above
 * Embroider or ember-auto-import v2
 
 
-Installation
-------------------------------------------------------------------------------
+## Installation
+
 
 ```
 ember install ember-rdfa-editor-lblod-plugins
 ```
 
 
-Usage
-------------------------------------------------------------------------------
+## General addon information
+
+
+This addon contains the following editor plugins:
+* besluit-type-plugin
+* citaten-plugin
+* generate-template-plugin
+* import-snippet-plugin
+* insert-variable-plugin
+* rdfa-date-plugin
+* roadsign-regulation-plugin
+* standard-template-plugin
+* table-of-contents-plugin
+* template-variable-plugin
+
+An array of plugin configurations can be passed to an instance of the ember-rdfa-editor in order to enable them.
+This is typically done in the following manner:
+```hbs
+<Rdfa::RdfaEditor
+      class="au-c-rdfa-editor"
+      @profile={{@profile}}
+      @rdfaEditorInit={{this.rdfaEditorInit}}
+      @editorOptions={{this.editorOptions}}
+      @toolbarOptions={{this.toolbarOptions}}
+      @plugins={{this.plugins}}
+    />
+```
+Where `this.plugins` is an array of plugin configurations found in the backing class of the template shown above.
+
+## besluit-type-plugin
+
+Plugin which allows a user to change the type of a [besluit](https://data.vlaanderen.be/ns/besluit#Besluit).
+
+This plugin can be configured in the following manner:
+
+```js
+  this.plugins = ["besluit"];
+```
+## citaten-plugin
+Plugin which allows a user to insert references to a legal resource or legal expression into the document.
+
+This plugin can be configured in the following manner:
+
+```js
+  this.plugins = ["citaten"];
+```
+
+### Using the plugin
+This plugin can be triggered by typing one of the following in the correct RDFa context (the [besluit:motivering](http://data.vlaanderen.be/ns/besluit#motivering) of a [besluit:Besluit](https://data.vlaanderen.be/ns/besluit#Besluit)).
+
+* [specification]**decreet** [words to search for] *(e.g. "gemeentedecreet wijziging")*
+* **omzendbrief** [words to search for]
+* **verdrag** [words to search for]
+* **grondwetswijziging** [words to search for]
+* **samenwerkingsakkoord** [words to search for]
+* [specification]**wetboek** [words to search for]
+* **protocol** [words to search for]
+* **besluit van de vlaamse regering** [words to search for]
+* **gecoordineerde wetten** [words to search for]
+* [specification]**wet** [words to search for] *(e.g. "kieswet wijziging", or "grondwet")*
+* **koninklijk besluit** [words to search for]
+* **ministerieel besluit** [words to search for]
+* **genummerd besluit** [words to search for]
+
+You should be able to add a reference manually by clicking on the `Insert` > `Insert reference` item in the Insert menu located on the top right of the editor. This will open the advanced search window. **Note** that this will only be avaliable in the proper context (see above in this section).
+
+## generate-template-plugin
+Plugin which provides an editor command which replaces resource URIs in a document by a generic template URI containing `${generateUuid()}`. This allows for the generation of template documents. Template documents can be used by other applications, these other applications can create an instance of a template by replacing the `${generateUuid()}` keywords by real URIs.
+
+This plugin can be configured in the following manner:
+
+```js
+  this.plugins = ["generate-template"];
+```
+
+The command can be used by executing:
+
+```js
+controller.executeCommand('generateTemplate', controller);
+```
+
+Where `controller` is an editor-controller.
+
+## import-snippet-plugin
+Plugin allowing importing of external RDFA snippets and inserting it in the document.
+
+This plugin can be configured in the following manner:
+
+```js
+  this.plugins = ["import-snippet"];
+```
+
+### Using the plugin
+
+This plugin provides an Ember service, `import-rdfa-snippet` which allows you to download rdfa snippets in the following manner:
+
+```js
+import { inject as service } from '@ember/service';
+
+
+// An entry point to download the resouce (e.g a route) in your host app.
+// (...)
+
+    let downloadData = { source: 'http://remote/resource.html' }
+    await this.importRdfaSnippet.downloadSnippet(downloadData);
+```
+
+After having downloaded a snippet, a user can use the plugin in the Gelinkt Notuleren application (https://github.com/lblod/frontend-gelinkt-notuleren). 
+
+When opening a new document, users will get the option to either include the snippet data in the document or as an attachment.
+
+## insert-variable-plugin
+Plugin which allows users to insert variable placeholders into a document.
+
+### Configuring the plugin
+
+The plugin can be configured through the following optional attributes:
+- `publisher`: the URI of a specific codelist publisher which you can use if you want to filter the codelists by its publisher.
+- `defaultEndpoint`: The default endpoint where the codelists are fetched, this is also the variable that gets passed to the fetchSubtypes and template function
+- `variableTypes`: a custom list of variable types you want the plugin to use. This list can contain the following default variable types: `text`, `number`,`date`,`location` and `codelist`. Additionally this list can also contain custom variable types, configured by the following three sub-attributes:
+  * `label`: the label of the custom variable type
+  * `fetchSubTypes` (optional): a function which returns a list of possible variable values. The function takes two optional arguments: an `endpoint` and a `publisher`.
+  * `template`: function which returns an html template which should be resolved and inserted when inserting a variable of the custom variable type. The function takes two arguments: an `endpoint` and a `selectedVariableValue`.
+
+#### Example
+
+```js
+{
+  name:'insert-variable',
+  options: {
+    publisher: 'http://data.lblod.info/id/bestuurseenheden/141d9d6b-54af-4d17-b313-8d1c30bc3f5b',
+    defaultEndpoint: 'https://dev.roadsigns.lblod.info/sparql',
+    variableTypes: [
+          'text',
+          'number',
+          'date',
+          'location',
+          'codelist',
+          {
+            label: 'Simple Variable',
+            template: `
+              <span property="ext:content" datatype="ext:myNewType">
+                <span class="mark-highlight-manual">\${Simple variable}</span>
+              </span>
+            `,
+          },
+          {
+            label: 'Complex Variable',
+            fetchSubtypes: async (endpoint, publisher) => {
+              const codelists = [
+                {
+                  uri: '1',
+                  label: '1',
+                },
+                {
+                  uri: '2',
+                  label: '2',
+                },
+                {
+                  uri: '3',
+                  label: '3',
+                },
+              ];
+              return codelists;
+            },
+            template: (endpoint, selectedCodelist) => `
+              <span property="ext:codelist" resource="${selectedCodelist.uri}"></span>
+              <span property="dct:type" content="location"></span>
+              <span property="dct:source" resource="${endpoint}"></span>
+              <span property="ext:content" datatype="xsd:date">
+                <span class="mark-highlight-manual">\${${selectedCodelist.label}}</span>
+              </span>
+            `,
+          },
+        ],
+  }
+}
+```
+### Using the plugin
+
+When the insert-variable-plugin is enabled, users will have the option to insert a variable into a document through a card which pops up in the sidebar of the editor.
+
+
+## rdfa-date-plugin
+Plugin to insert and modify semantic dates and timestamps in an editor document.
+
+This plugin can be configured in the following manner:
+
+```js
+  this.plugins = ["rdfa-date"];
+```
+
+
+
+## roadsign-regulation-plugin
+A plugin that fetches data from the mow regulation and roadsign registry and allows users to insert roadsign regulations inside an editor document.
+
+This plugin can be configured in the following manner:
+
+```js
+  this.plugins = ["roadsign-regulation"];
+```
+
+The default endpoint the plugin will query is https://roadsigns.lblod.info/sparql . This can be overwritten by setting `roadsignRegulationPlugin.endpoint` in your `config/environment.js`.
+
+## standard-template-plugin
+Plugin which allows users to insert standard templates in the editor. Depending on the position of the cursor or selected text, a dropdown will appear in the toolbar of the editor that lets you insert a template for the proper context at the location of the cursor.
+
+This plugin can be configured in the following manner:
+
+```js
+  this.plugins = ["standard-template"];
+```
+
+### Template resource used by the plugin
+
+When creating a template in your database, the following properties are used by the plugin:
+
+* the title of the template (`title`)
+* its HTML content (`content`)
+* the words of the document the template should match on (`matches`)
+* the contexts in which it should be active (`contexts`) 
+* the contexts in which it should not be active (`disabled-in-contexts`)
+
+### Using the plugin
+
+
+The plugin will search for RDFa contexts in the content of the editor and the editor itself. Based on the contexts, the plugin will show possible templates to be added at the location of the cursor. E.g. if an element in the editor has the `typeof="besluit:BehandelingVanAgendapunt"` attribute, the plugin will show the templates related to [`besluit:BehandelingVanAgendapunt`](http://data.vlaanderen.be/ns/besluit#BehandelingVanAgendapunt) in the dropdown menu. This attribute can be set on an element in the content of the editor or predefined in the editor itself.
+
+## table-of-contents-plugin
 
-[Longer description of how to use the addon in apps.]
+Plugin implementing an auto-refreshing table of contents using an ember-rdfa-editor inline component.
 
+In order to enable the plugin you need to add `table-of-contents` to the list of plugins passed to the rdfa-editor. You can configure the plugin with a custom table of contents configuration.
+### Configuring the plugin with a custom config
+
+```js
+this.plugins = [
+  { name: 'table-of-contents', 
+    options: { 
+      config: {
+        sectionPredicate: 'https://say.data.gift/ns/hasPart',
+        value: {
+          predicate: 'https://say.data.gift/ns/heading',
+        },
+      },
+      {
+        sectionPredicate: 'https://say.data.gift/ns/hasParagraph',
+        value: '§',
+      }, 
+    } 
+  },
+]
+```
+
+You can insert an instance of a table of contents using the `insert-component` command: 
+
+```js
+controller.executeCommand(
+      'insert-component',
+      'table-of-contents-plugin/inline-components/table-of-contents',
+      {
+        config: [
+          {
+            sectionPredicate: 'https://say.data.gift/ns/hasPart',
+            value: {
+              predicate: 'https://say.data.gift/ns/heading',
+            },
+          },
+          {
+            sectionPredicate: 'https://say.data.gift/ns/hasParagraph',
+            value: '§',
+          },
+        ],
+      },
+      {},
+      false
+    );
+```
+## template-variable-plugin
+
+Editor plugin which allows you to interact with placeholders created by the insert-variable-plugin.
+
+### Configuring the plugin
+
+You can enable the plugin by adding it to the list of plugins:
+
+```js
+this.plugins = ['template-variable'];
+```
+
+Additionally, you can configure the plugin in your `environment.js` file:
+
+```js
+templateVariablePlugin: {
+  endpoint: 'https://dev.roadsigns.lblod.info/sparql', // the fallback endpoint which should be used for codelists which do not have a `dct:source` property.
+  zonalLocationCodelistUri:
+    'http://lblod.data.gift/concept-schemes/62331E6900730AE7B99DF7EF',
+  nonZonalLocationCodelistUri:
+    'http://lblod.data.gift/concept-schemes/62331FDD00730AE7B99DF7F2',
+},
+```
+
+## Contributing
 
-Contributing
-------------------------------------------------------------------------------
 
 See the [Contributing](CONTRIBUTING.md) guide for details.
 
 
-License
-------------------------------------------------------------------------------
+## License
+
 
 This project is licensed under the [MIT License](LICENSE.md).

package/RELEASE.md

@@ -0,0 +1,60 @@
+# Release Process
+
+Releases are mostly automated using
+[release-it](https://github.com/release-it/release-it/) and
+[lerna-changelog](https://github.com/lerna/lerna-changelog/).
+
+## Preparation
+
+Since the majority of the actual release process is automated, the primary
+remaining task prior to releasing is confirming that all pull requests that
+have been merged since the last release have been labeled with the appropriate
+`lerna-changelog` labels and the titles have been updated to ensure they
+represent something that would make sense to our users. Some great information
+on why this is important can be found at
+[keepachangelog.com](https://keepachangelog.com/en/1.0.0/), but the overall
+guiding principle here is that changelogs are for humans, not machines.
+
+When reviewing merged PR's the labels to be used are:
+
+* breaking - Used when the PR is considered a breaking change.
+* enhancement - Used when the PR adds a new feature or enhancement.
+* bug - Used when the PR fixes a bug included in a previous release.
+* documentation - Used when the PR adds or updates documentation.
+* internal - Used for internal changes that still require a mention in the
+  changelog/release notes.
+
+## Release
+
+Once the prep work is completed, the actual release is straight forward:
+
+* First, ensure that you have installed your projects dependencies:
+
+```sh
+npm install
+```
+
+* Second, ensure that you have obtained a
+  [GitHub personal access token][generate-token] with the `repo` scope (no
+  other permissions are needed). Make sure the token is available as the
+  `GITHUB_AUTH` environment variable.
+
+  For instance:
+
+  ```bash
+  export GITHUB_AUTH=abc123def456
+  ```
+
+[generate-token]: https://github.com/settings/tokens/new?scopes=repo&description=GITHUB_AUTH+env+variable
+
+* And last (but not least 😁) do your release.
+
+```sh
+npx release-it
+```
+
+[release-it](https://github.com/release-it/release-it/) manages the actual
+release process. It will prompt you to to choose the version number after which
+you will have the chance to hand tweak the changelog to be used (for the
+`CHANGELOG.md` and GitHub release), then `release-it` continues on to tagging,
+pushing the tag and commits, etc.

package/addon/commands/generate-template-command.js

@@ -0,0 +1,35 @@
+import defaultResources from '../utils/generate-template-plugin/default-resources';
+
+export default class GenerateTemplateCommand {
+  name = 'generateTemplate';
+
+  constructor(model) {
+    this.model = model;
+  }
+
+  canExecute() {
+    return true;
+  }
+
+  execute(controller) {
+    let uris = [];
+    for (let resource of defaultResources) {
+      const quads = [
+        ...controller.datastore.match(null, 'a', `>${resource}`).asQuads(),
+      ];
+      const resourceUris = quads.map((quad) => quad.subject.value);
+      uris = [...uris, ...resourceUris];
+    }
+    let documentHTML = controller.htmlContent;
+    for (let uri of uris) {
+      const uriParts = uri.split('/');
+      uriParts.pop();
+      const uriWithoutUuid = uriParts.join('/');
+      documentHTML = documentHTML.replace(
+        uri,
+        `${uriWithoutUuid}/\${generateUuid()}`
+      );
+    }
+    return documentHTML;
+  }
+}

package/addon/commands/insert-and-collapse.js

@@ -0,0 +1,32 @@
+export default class InsertAndCollapseCommand {
+  name = 'insert-and-collapse';
+
+  constructor(model) {
+    this.model = model;
+  }
+
+  canExecute() {
+    return true;
+  }
+
+  execute(controller, htmlString, node) {
+    const range = controller.rangeFactory.fromInNode(
+      node,
+      0,
+      node.getMaxOffset()
+    );
+    controller.executeCommand('insert-html', htmlString, range);
+
+    controller.selection.selectRange(
+      controller.selection.lastRange.shrinkToVisible()
+    );
+    const containedNodes =
+      controller.selection.lastRange.contextNodes('rangeContains');
+    containedNodes.next();
+    const span = containedNodes.next().value;
+    const finalRange = controller.rangeFactory.fromInNode(span);
+    controller.selection.selectRange(finalRange);
+
+    this.model.writeSelection();
+  }
+}

package/addon/commands/modify-date-command.js

@@ -0,0 +1,42 @@
+export default class ModifyDateCommand {
+  name = 'modify-date';
+
+  constructor(model) {
+    this.model = model;
+  }
+
+  canExecute() {
+    return true;
+  }
+
+  execute(controller, element, dateValue, onlyDate) {
+    this.model.change((mutator) => {
+      const range = controller.rangeFactory.fromInElement(
+        element,
+        0,
+        element.getMaxOffset()
+      );
+      mutator.insertText(
+        range,
+        this.formatDate(dateValue, onlyDate),
+        range.getMarks()
+      );
+      element.attributeMap.set('content', dateValue.toISOString());
+    });
+  }
+
+  formatDate(date, onlyDate) {
+    let options = {
+      year: 'numeric',
+      month: '2-digit',
+      day: '2-digit',
+      hour: '2-digit',
+      minute: '2-digit',
+    };
+    if (onlyDate) {
+      options.hour = undefined;
+      options.minute = undefined;
+    }
+    return date.toLocaleString('nl-BE', options);
+  }
+}

package/addon/components/besluit-type-plugin/besluit-type-select.hbs

@@ -0,0 +1,28 @@
+<div ...attributes>
+  <PowerSelect
+    @renderInPlace={{true}}
+    @searchEnabled={{true}}
+    @searchMessage={{t "besluit-type-plugin.search-message"}}
+    @noMatchesMessage={{t "besluit-type-plugin.no-matches-message"}}
+    @search={{this.search}}
+    @options={{this.besluitTypes}}
+    @selected={{@selected}}
+    @onChange={{@onchange}} as |besluitType|>
+    {{besluitType.label}}
+  </PowerSelect>
+  <p class='au-u-muted au-u-margin-tiny au-u-margin-bottom-small'>
+    {{@selected.definition}}
+  </p>
+  {{#if @showWarningWhenEmpty}}
+    {{#unless @selected}}
+      <AuAlert
+        @icon="alert-triangle"
+        @title={{t "besluit-type-plugin.alert-title"}}
+        @skin="warning"
+        @size="small"
+        class="au-u-margin-bottom-none au-u-margin-top-small">
+      <p>{{t "besluit-type-plugin.alert-body"}}</p>
+      </AuAlert>
+    {{/unless}}
+  {{/if}}
+</div>