Add Configuration API

Linting

Fix attribute parsing

Fix `configure` and `listen` (again)

No need for inheritance, move preset getter to editor level

Refresh DOMPurify config on each call, extract deepMerge helper

Rely on JSON.parse when possible

Add vitest

Make fallback logic clearer

Split presets/global into separate configs, use preset for global api, merge all config constructor args into tree

Run tests during local ci and github actions

Move javascript tests to into first level test/ folder

Rely on editor element preset getter, remove second preset arg from EditorConfiguration

Use runtime default preset as source of truth for override attributes

Remove unused helper

Tweak config export

Document config api

Rename external toolbar attribute to toolbartarget

Author: zachasme

.github/workflows/ci.yml

@@ -1,9 +1,6 @@
 name: CI
 
-on:
-  pull_request:
-  push:
-    branches: [ main ]
+on: [push, pull_request]
 
 jobs:
   lint:
@@ -55,7 +52,19 @@ jobs:
           ruby-version: ruby-3.3.7
           bundler-cache: true
 
-      - name: Run tests
+      - name: Set up Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: '20'
+          cache: 'yarn'
+
+      - name: Install JavaScript dependencies
+        run: yarn install --frozen-lockfile
+
+      - name: Run JavaScript tests
+        run: yarn test
+
+      - name: Run Rails tests
         env:
           RAILS_ENV: test
           # REDIS_URL: redis://localhost:6379/0

README.md

@@ -142,15 +142,44 @@ Under the hood, this will insert a `<lexxy-editor>` tag, that will be a first-cl
 <lexxy-editor name="post[body]"...>...</lexxy-editor>
 ```
 
+You can configure editors in two ways: presets and attributes.
+
+```js
+import * as Lexxy from "lexxy"
+
+// overriding default options will affect all editors
+Lexxy.configure({
+  default: {
+    toolbar: false
+  }
+})
+<lexxy-editor></lexxy-editor>
+
+// you can also create new presets, which will extend the default preset
+Lexxy.configure({
+  simple: {
+    attachments: false
+  }
+})
+<lexxy-editor preset="simple"></lexxy-editor>
+
+// you can override specific options with attributes on editor elements
+<lexxy-editor preset="simple" attachments="true"></lexxy-editor>
+```
+
 ## Options
 
-The `<lexxy-editor>` element supports these options:
+Editors support the following options, configurable using presets and element attributes:
 
-- `placeholder`: Text displayed when the editor is empty.
-- `toolbar`: Pass `"false"` to disable the toolbar entirely, or pass an element ID to render the toolbar in an external element. By default, the toolbar is bootstrapped and displayed above the editor.
-- `attachments`: Pass `"false"` to disable attachments completely. By default, attachments are supported, including paste and Drag & Drop support.
+- `toolbar`: Pass `false` to disable the toolbar entirely. By default, the toolbar is bootstrapped and displayed above the editor. Use the `toolbartarget` element attribute to render in an external element.
+- `attachments`: Pass `false` to disable attachments completely. By default, attachments are supported, including paste and Drag & Drop support.
+- `multiline`: Pass `false` to force single line editing.
 
-Lexxy uses the `ElementInternals` API to participate in HTML forms as any standard control. This means that you can use standard HTML attributes like `name`, `value`, `required`, `disabled`, etc.
+In addition, the `<lexxy-editor>` element supports these attributes:
+
+- `toolbartarget`: Pass an element ID to render the toolbar in an external element. By default, the toolbar is bootstrapped and displayed above the editor.
+- `placeholder`: Text displayed when the editor is empty.
+- Lexxy uses the `ElementInternals` API to participate in HTML forms as any standard control. This means that you can use standard HTML attributes like `name`, `value`, `required`, `disabled`, etc.
 
 ## Prompts
 

app/assets/javascript/lexxy.js

@@ -4,8 +4,9 @@
   step "Style: Ruby", "bin/rubocop -f github"
   step "Style: JavaScript", "yarn lint"
 
-  step "Tests: prepare", "env RAILS_ENV=test bin/rails db:test:prepare"
-  step "Tests: run", "env RAILS_ENV=test bin/rails test:all -d"
+  step "Tests: JavaScript", "yarn test"
+  step "Tests: Rails (prepare)", "env RAILS_ENV=test bin/rails db:test:prepare"
+  step "Tests: Rails (run)", "env RAILS_ENV=test bin/rails test:all -d"
 
   unless success?
     failure "Signoff: CI failed.", "Fix the issues and try again."

app/assets/javascript/lexxy.js.br

@@ -18,15 +18,18 @@
     "@rollup/plugin-node-resolve": "^16.0.1",
     "@rollup/plugin-terser": "^0.4.4",
     "eslint": "^9.15.0",
+    "jsdom": "^27.3.0",
     "rollup": "^4.44.1",
     "rollup-plugin-copy": "^3.5.0",
-    "rollup-plugin-gzip": "^4.1.1"
+    "rollup-plugin-gzip": "^4.1.1",
+    "vitest": "^4.0.16"
   },
   "scripts": {
     "build": "rollup -c",
     "build:npm": "rollup -c rollup.config.npm.mjs",
     "watch": "NODE_ENV=development rollup -wc --watch.onEnd=\"rails restart\"",
     "lint": "eslint",
+    "test": "vitest --environment=jsdom",
     "prerelease": "yarn build:npm",
     "release": "yarn build:npm && yarn publish"
   },