autumnnote 2.6.0 → 2.7.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "autumnnote",
-  "version": "2.6.0",
-  "description": "WYSIWYG rich-text editor built with vanilla JavaScript \u2014 zero dependencies, no jQuery. Dark mode, @mention, markdown shortcuts, bubble toolbar. React and Vue\u00a03 wrappers included.",
+  "version": "2.7.1",
+  "description": "WYSIWYG rich-text editor built with vanilla JavaScript — zero dependencies, no jQuery. Dark mode, @mention, markdown shortcuts, bubble toolbar. React and Vue 3 wrappers included.",
   "type": "module",
   "main": "dist/autumnnote.cjs",
   "module": "dist/autumnnote.es.js",
@@ -119,13 +119,13 @@
     "@vitest/browser-playwright": "^4.1.10",
     "@vitest/coverage-v8": "^4.1.8",
     "cross-env": "^10.1.0",
-    "eslint": "^10.7.0",
-    "jsdom": "^25.0.1",
-    "playwright": "^1.61.1",
-    "rollup-plugin-visualizer": "^7.0.1",
-    "sass": "^1.101.0",
-    "typescript": "^6.0.2",
-    "vite": "^8.1.5",
+    "eslint": "^10.8.1",
+    "jsdom": "^30.0.1",
+    "playwright": "^1.62.1",
+    "rollup-plugin-visualizer": "^7.1.1",
+    "sass": "^1.102.0",
+    "typescript": "^7.0.2",
+    "vite": "^8.2.1",
     "vitest": "^4.1.8"
   },
   "packageManager": "pnpm@11.1.3",

package/src/js/core/func.js

@@ -108,9 +108,14 @@ export function isFunction(val) {
  * mutations to the merged result do not bleed back into the source object
  * (e.g. mutating `instance.options.fontFamilies` should not affect
  * `AutumnNote.defaults.fontFamilies`).
- * @param {object} target
- * @param {object} source
- * @returns {object}
+ *
+ * The result starts as a copy of `target`, so it carries `target`'s shape —
+ * `source` only overwrites values. Typing the return as `T` rather than
+ * `object` is what lets callers read properties off the merged result.
+ * @template {object} T
+ * @param {T} target
+ * @param {object} [source]
+ * @returns {T}
  */
 export function mergeDeep(target, source) {
   // Start with a shallow copy of target; clone any arrays to avoid shared refs
@@ -133,7 +138,8 @@ export function mergeDeep(target, source) {
       }
     }
   }
-  return output;
+  // `output` is built key by key from `target`, which no inference can follow.
+  return /** @type {T} */ (output);
 }
 
 /**

package/types/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * AutumnNote – TypeScript declarations
- * @version 2.0.0
+ * The runtime version is sourced from package.json during the build.
  */
 
 // ---------------------------------------------------------------------------
@@ -29,6 +29,40 @@ export interface AutoSaveAdapter {
   remove?(payload: { key: string; context: Context }): void | Promise<void>;
 }
 
+/**
+ * One entry in the right-click menu. Most entries are a labelled row with an
+ * `action`; the remaining fields each select a different kind of row, and an
+ * entry that sets one of them ignores `action`.
+ */
+export interface ContextMenuItem {
+  /** Unique identifier. Omitted on separators and other non-interactive rows. */
+  name?: string;
+  label?: string;
+  /** Icon markup (SVG or HTML). */
+  icon?: string;
+  /** Key into `locale.contextMenu`; preferred over `label` when it resolves. */
+  localeKey?: string;
+  action?: (context: Context) => void;
+  /** Greys the row out and blocks the click. A function is evaluated per open. */
+  disabled?: boolean | ((context: Context) => boolean);
+  /** Opens a submenu instead of firing `action`. */
+  navigate?: ContextMenuItem[] | ((context: Context) => ContextMenuItem[]);
+  /** A horizontal rule. `sep` is an accepted alias. */
+  separator?: boolean;
+  /** @see separator */
+  sep?: boolean;
+  /** Renders as the submenu's "back" row rather than a command. */
+  back?: boolean;
+  /** Renders a row of quick colour swatches for `colorType`. */
+  colorStrip?: 'foreColor' | 'hiliteColor';
+  /** Renders the full palette plus a native colour input, for `colorType`. */
+  colorPalette?: boolean;
+  /** Which command `colorStrip` / `colorPalette` applies. */
+  colorType?: 'foreColor' | 'hiliteColor';
+  /** Renders the drag-to-size table picker. */
+  tableGrid?: boolean;
+}
+
 export interface SlashCommand {
   id: string;
   label?: string;
@@ -145,7 +179,14 @@ export interface AsnOptions {
   /** Auto-load Prism.js for syntax highlighting inside code blocks. */
   codeHighlight?: boolean;
   /** CDN base URL for Prism assets. */
+  /** Base URL for Prism assets, or your own origin to self-host. A trailing slash is normalised away. */
   codeHighlightCDN?: string;
+  /** CSP nonce applied to dynamically injected Prism and Font Awesome assets. */
+  cspNonce?: string;
+  /** crossorigin value applied to optional external assets. Default: 'anonymous'. */
+  externalAssetCrossOrigin?: '' | 'anonymous' | 'use-credentials';
+  /** Referrer policy applied to optional external assets. Default: 'no-referrer'. */
+  externalAssetReferrerPolicy?: ReferrerPolicy;
   /** Convert pasted Markdown text to HTML. */
   markdownPaste?: boolean;
   /** Maximum undo/redo history steps. */
@@ -230,6 +271,14 @@ export interface AsnOptions {
   /** @mention autocomplete configuration. Activated when mention.onSearch is provided. */
   mention?: MentionOptions | null;
 
+  // ---- Right-click menu ------------------------------------------------------
+
+  /**
+   * Replaces the built-in right-click menu. Omit it, or omit `items`, to keep
+   * the default list.
+   */
+  contextMenu?: { items?: ContextMenuItem[] } | null;
+
   // ---- Slash command menu ----------------------------------------------------
 
   /** Show a "/" command palette for quick block insertion (headings, lists, table, image, ...). Default: true. */