Add Configuration API

Add vitest

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

Author: zachasme

.github/workflows/ci.yml

@@ -55,7 +55,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,56 @@ 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: using `Lexxy.configure` and element 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: {
+    richText: false
+  }
+})
+<lexxy-editor preset="simple"></lexxy-editor>
+
+// you can override specific options with attributes on editor elements
+<lexxy-editor preset="simple" rich-text="true"></lexxy-editor>
+
+// finally, some options can only be configured globally
+Lexxy.configure({
+  global: {
+    attachmentTagName: "bc-attachment"
+  }
+})
+```
+
 ## Options
 
-The `<lexxy-editor>` element supports these options:
+Editors support the following options, configurable using presets and element attributes:
+
+- `toolbar`: Pass `false` to disable the toolbar entirely, or pass the ID of a `<lexxy-toolbar>` element to use as an external toolbar. 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.
+- `markdown`: Pass `false` to disable Markdown support.
+- `multiLine`: Pass `false` to force single line editing.
+- `richText`: Pass `false` to disable rich text editing.
+
+In addition, the `<lexxy-editor>` element supports these 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.
+- 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.
+
+Finally, the following can only be configured using `Lexxy.configure({ global: ... })`:
 
-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.
+- `attachmentTagName`: The tag name used for [Action Text custom attachments](https://guides.rubyonrails.org/action_text_overview.html#signed-globalid). By default, they will be rendered as `action-text-attachment` tags.
 
 ## 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": "rollup -wc --watch.onEnd=\"rails restart\"",
     "lint": "eslint",
+    "test": "vitest --environment=jsdom",
     "prerelease": "yarn build:npm",
     "release": "yarn build:npm && yarn publish"
   },