@everystack/admin 0.4.4 → 0.4.5

package/CHANGELOG.md

@@ -4,6 +4,16 @@ All notable changes to `@everystack/admin` are documented here.
 
 Format based on [Keep a Changelog](https://keepachangelog.com/).
 
+## [0.4.5] - 2026-10-15
+
+### Added
+
+- the visual editor keeps data-* attributes on every node and mark
+
+### Documentation
+
+- InputContext.values is required since 0.4.3
+
 ## [0.4.4] - 2026-10-15
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@everystack/admin",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "description": "Declarative admin dashboard framework for PostgREST APIs",
   "license": "AGPL-3.0-only",
   "author": "Scalable Technology, Inc. <licensing@scalable.technology>",
@@ -117,8 +117,8 @@
     "react-test-renderer": "19.2.0",
     "ts-jest": "29.4.9",
     "typescript": "5.9.3",
-    "@everystack/api": "0.4.4",
-    "@everystack/ui": "0.4.3"
+    "@everystack/ui": "0.4.4",
+    "@everystack/api": "0.4.5"
   },
   "scripts": {
     "test": "jest",

package/src/editors/rich-html-extensions.ts

@@ -1,4 +1,4 @@
-import { Node, type Extensions } from '@tiptap/react';
+import { Extension, Node, getSchema, mergeAttributes, type Extensions } from '@tiptap/react';
 import type { DOMOutputSpec, TagParseRule } from '@tiptap/pm/model';
 import StarterKit from '@tiptap/starter-kit';
 import { Code } from '@tiptap/extension-code';
@@ -21,8 +21,8 @@ export const Figure = Node.create({
       getAttrs: (element: HTMLElement): null | false => element.querySelector('img[src]') ? null : false,
     }];
   },
-  renderHTML(): DOMOutputSpec {
-    return ['figure', 0];
+  renderHTML({ HTMLAttributes }): DOMOutputSpec {
+    return ['figure', mergeAttributes(HTMLAttributes), 0];
   },
 });
 
@@ -35,13 +35,38 @@ export const Figcaption = Node.create({
   parseHTML(): TagParseRule[] {
     return [{ tag: 'figcaption', context: 'figure/' }];
   },
-  renderHTML(): DOMOutputSpec {
-    return ['figcaption', 0];
+  renderHTML({ HTMLAttributes }): DOMOutputSpec {
+    return ['figcaption', mergeAttributes(HTMLAttributes), 0];
   },
 });
 
-export function richHtmlExtensions(): Extensions {
-  return [
+export const DataAttributes = Extension.create<{ types: string[] }>({
+  name: 'dataAttributes',
+  addOptions() {
+    return { types: [] };
+  },
+  addGlobalAttributes() {
+    return [{
+      types: this.options.types,
+      attributes: {
+        dataAttributes: {
+          default: null,
+          keepOnSplit: false,
+          parseHTML: (element: HTMLElement): Record<string, string> | null => {
+            const entries = Array.from(element.attributes)
+              .filter(attribute => attribute.name.startsWith('data-'))
+              .map(attribute => [attribute.name, attribute.value]);
+            return entries.length ? Object.fromEntries(entries) : null;
+          },
+          renderHTML: (attributes): Record<string, string> => attributes.dataAttributes ?? {},
+        },
+      },
+    }];
+  },
+});
+
+export function richHtmlExtensions(options?: { dataAttributes?: boolean }): Extensions {
+  const base: Extensions = [
     StarterKit.configure({
       code: false,
       codeBlock: false,
@@ -60,4 +85,10 @@ export function richHtmlExtensions(): Extensions {
     Subscript,
     Superscript,
   ];
+  if (options?.dataAttributes === false) return base;
+
+  const schema = getSchema(base);
+  const types = [...Object.keys(schema.nodes), ...Object.keys(schema.marks)]
+    .filter(type => type !== 'doc' && type !== 'text');
+  return [...base, DataAttributes.configure({ types })];
 }

package/src/types.ts

@@ -60,6 +60,8 @@ export interface InputContext {
   /**
    * The whole form's current values, keyed by field name (what Save would
    * send). Read another field here to render a block that depends on it.
+   * Required since 0.4.3: code that builds an InputContext by hand, such as a
+   * test, must pass it.
    */
   values: Record<string, unknown>;
 }