@lax-wp/editor 0.3.16 → 0.3.18

package/dist/components/sidebar/content/anonymization-page/PIIScanResults.d.ts

@@ -1,13 +1,11 @@
 import { type DetectionConfig } from "@/constants/sidebar";
-import { type ScanDocumentResult } from "@/config/EditorConfig";
 export interface PIIScanResultsProps {
     detectionConfigs: DetectionConfig[];
-    scanResult?: ScanDocumentResult;
     onClose?: () => void;
     onSettings?: () => void;
-    onApply?: (selectedReplacements: string[]) => void;
+    onApply?: (selectedReplacements: string[], unselectedReplacements: string[]) => void;
     onRevealStart?: () => void;
     onRevealEnd?: () => void;
     onRevertAnonymization?: () => void;
 }
-export declare const PIIScanResults: ({ detectionConfigs, scanResult, onClose, onApply, onRevertAnonymization }: PIIScanResultsProps) => import("react/jsx-runtime").JSX.Element;
+export declare const PIIScanResults: ({ detectionConfigs, onClose, onApply, onRevertAnonymization }: PIIScanResultsProps) => import("react/jsx-runtime").JSX.Element;

package/dist/components/sidebar/content/anonymization-page/anonymizationUtils.d.ts

@@ -1,6 +1,17 @@
 import type { Editor } from "@tiptap/react";
 import type { ApiTagEntry } from "@/config/EditorConfig";
 export declare function setShowValue(editor: Editor, showValue: boolean, filter?: Set<string>): void;
+/**
+ * Replace `anonymizedLink` marks in the document with the editor's default
+ * `link` mark. The restored `href` is the original URL stored in
+ * `anonymizedData[0].value` (falling back to the mark's `href` attr if the
+ * value is missing). `target` / `rel` / `class` are carried over so the
+ * resulting link preserves its formatting while PII metadata is dropped.
+ *
+ * If `filter` is provided, only marks whose `anonymizedVariable` is in the
+ * set are reverted. No-op if either mark type is missing from the schema.
+ */
+export declare function revertAnonymizedLinksToLinks(editor: Editor, filter?: Set<string>): void;
 export declare function revertToPlainText(editor: Editor, filter?: Set<string>): void;
 export declare function buildTagsFromEditor(editor: Editor): Record<string, ApiTagEntry[]>;
 export type AnonymizedVariableRevealState = 'placeholder' | 'revealed';

package/dist/config/EditorConfig.d.ts

@@ -59,6 +59,9 @@ export interface ScanDocumentResult {
  * - For `placeholderFormat === "descriptive"`, strips the `[` / `]` brackets
  *   from placeholder tokens so the chip shows e.g. `PERSON_A_NAME` not
  *   `[PERSON_A_NAME]`.
+ * - Normalises `anonymizedLink` marks: when `showValue: true`, the mark is
+ *   rewritten to the standard `link` mark (using the original URL stored in
+ *   `anonymizedData[0].value`) so it behaves identically to a default link.
  */
 export declare function normalizeAnonymizationApiResponse(jsonContent: Record<string, unknown>, placeholderFormat?: string): Record<string, unknown>;
 /** Payload for Save Changes (PII anonymization settings). Passed to onSaveAnonymizationSettings. */
@@ -79,6 +82,8 @@ export interface AIAutocompletionConfig {
     /** Required: Custom fetch function for API calls. AI autocompletion only works when this is provided. */
     fetchCompletion?: (text: string) => Promise<string>;
 }
+/** Pass scan/API JSON or an HTML string into the editor (used with {@link EditorConfig.onScanComplete}). */
+export type ApplyScanCompleteContent = (editorContent: string | Record<string, unknown>) => void;
 export interface EditorConfig {
     /** Editor mode */
     mode?: TEditorMode;
@@ -159,8 +164,11 @@ export interface EditorConfig {
         settings?: PiiDetectionConfig;
         onSaveAnonymizationSettings?: (payload: AnonymizationSavePayload) => void;
         onScanDocument?: (json: Record<string, unknown>) => Promise<ScanDocumentResult | void>;
-        tags?: Record<string, ApiTagEntry[]>;
-        onApplyAnonymization?: (document: Record<string, unknown>) => void;
+        /**
+         * Called once when the editor is ready. You receive {@link ApplyScanCompleteContent};
+         * call it after a scan/API returns to load new document JSON (normalized for anonymization) or HTML.
+         */
+        onScanComplete?: (applyScanCompleteContent: ApplyScanCompleteContent) => void;
         onRevertAnonymization?: () => void;
         onAnonymizeDocument?: () => void;
         isAnonymized?: boolean;

package/dist/extensions/AnonymizedLink.d.ts

@@ -0,0 +1,62 @@
+import { Mark } from '@tiptap/core';
+import type { AnonymizedDataItem } from './AnonymizedText';
+export interface AnonymizedLinkOptions {
+    /** HTML attributes to add to the rendered <a> element. */
+    HTMLAttributes: Record<string, unknown>;
+    /** If true, clicking a link in a non-editable view opens the href in a new tab. */
+    openOnClick: boolean;
+}
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        anonymizedLink: {
+            /**
+             * Set an anonymizedLink mark on the current selection.
+             */
+            setAnonymizedLink: (attributes: {
+                href: string;
+                target?: string | null;
+                rel?: string | null;
+                class?: string | null;
+                anonymizedData?: AnonymizedDataItem[] | string | null;
+                showValue?: boolean | null;
+            }) => ReturnType;
+            /**
+             * Remove the anonymizedLink mark from the current selection.
+             */
+            unsetAnonymizedLink: () => ReturnType;
+        };
+    }
+}
+/**
+ * AnonymizedLink Mark
+ *
+ * Renders anonymized URLs as regular `<a>` elements while preserving the
+ * original value inside the mark's `anonymizedData` attribute. It mirrors the
+ * behaviour of the default Tiptap `link` mark (href / target / rel / class)
+ * and adds the PII-specific `anonymizedData` + `showValue` attributes used by
+ * the anonymization pipeline.
+ *
+ * Accepts the following JSON shape:
+ * ```json
+ * {
+ *   "type": "text",
+ *   "text": "arrived",
+ *   "marks": [{
+ *     "type": "anonymizedLink",
+ *     "attrs": {
+ *       "href": "https://google.com/",
+ *       "target": "_blank",
+ *       "rel": "noopener noreferrer nofollow",
+ *       "class": null,
+ *       "anonymizedData": [{ "anonymizedVariable": "URL 3", "value": "https://google.com/" }],
+ *       "showValue": false
+ *     }
+ *   }]
+ * }
+ * ```
+ *
+ * The mark coexists with the default `link` mark: only `<a>` elements tagged
+ * with `data-anon-link` (or a `data-anon-data` payload) parse into this mark,
+ * so plain links continue to be handled by the Link extension.
+ */
+export declare const AnonymizedLink: Mark<AnonymizedLinkOptions, any>;

package/dist/extensions/index.d.ts

@@ -1,5 +1,5 @@
 import { type EditorConfig } from "@/config/EditorConfig";
-export declare const EditorExtensions: (config?: EditorConfig) => (import("@tiptap/core").Node<import("@tiptap/extension-list").OrderedListOptions, any> | import("@tiptap/core").Node<import("@tiptap/extension-list").TaskItemOptions, any> | import("@tiptap/core").Extension<import("@/extensions/AIAutoCompletion").AIAutocompletionOptions, any> | import("@tiptap/core").Extension<any, any> | import("@tiptap/core").Extension<import("./Indent").IndentOptions, any> | import("@tiptap/core").Node<import("./ListItemWithDepthLimit").ListItemOptions, any> | import("@tiptap/core").Extension<import("./Redline").RedlineOptions, any> | import("@tiptap/core").Node<import("@tiptap/extension-table").TableOptions, any> | import("@tiptap/core").Node<import("@tiptap/extension-table").TableRowOptions, any> | import("@tiptap/core").Node<import("./VariableText").VariableOptions, any> | import("@tiptap/core").Node<import("@tiptap/extension-horizontal-rule").HorizontalRuleOptions, any> | import("@tiptap/core").Node<import("./CodeBlockWithToolbar").CodeBlockWithToolbarOptions, any> | import("@tiptap/core").Extension<import("./PageMargin").PageMarginOptions, any> | import("@tiptap/core").Extension<import("./PageBackground").PageBackgroundOptions, any> | import("@tiptap/core").Node<import("./PageBreak").PageBreakOptions, any> | import("@tiptap/core").Node<any, any> | import("@tiptap/core").Node<import("./CustomImageExtension").CustomImageExtensionOptions, any> | import("@tiptap/core").Node<import("./Signature").SignatureOptions, any> | import("@tiptap/core").Node<import("./AnonymizedText").AnonymizedTextOptions, any> | import("@tiptap/core").Extension<import("@tiptap/extensions").UndoRedoOptions, any> | import("@tiptap/core").Extension<import("@tiptap/extensions").CharacterCountOptions, import("@tiptap/extensions").CharacterCountStorage> | import("@tiptap/core").Extension<import("@tiptap/extensions").PlaceholderOptions, any> | import("@tiptap/core").Extension<import("@tiptap/extension-typography").TypographyOptions, any> | import("@tiptap/core").Mark<import("@tiptap/extension-text-style").TextStyleOptions, any> | import("@tiptap/core").Extension<import("@tiptap/extension-text-style").FontSizeOptions, any> | import("@tiptap/core").Mark<import("@tiptap/extension-superscript").SuperscriptExtensionOptions, any> | import("@tiptap/core").Mark<import("@tiptap/extension-highlight").HighlightOptions, any> | import("@tiptap/core").Node<import("@tiptap/extension-list").TaskListOptions, any> | import("@tiptap/core").Extension<import("@tiptap/extension-text-align").TextAlignOptions, any> | import("@tiptap/core").Node<import("@tiptap/extension-heading").HeadingOptions, any> | import("@tiptap/core").Mark<import("@tiptap/extension-link").LinkOptions, any> | import("@tiptap/core").Node<import("@tiptap/extension-hard-break").HardBreakOptions, any> | import("@tiptap/core").Extension<import("@tiptap/extensions").TrailingNodeOptions, any> | import("@tiptap/core").Extension<import("@tiptap/extension-collaboration").CollaborationOptions, import("@tiptap/extension-collaboration").CollaborationStorage> | import("@tiptap/core").Extension<import("@tiptap/extension-collaboration-caret").CollaborationCaretOptions, {
+export declare const EditorExtensions: (config?: EditorConfig) => (import("@tiptap/core").Node<import("@tiptap/extension-list").OrderedListOptions, any> | import("@tiptap/core").Node<import("@tiptap/extension-list").TaskItemOptions, any> | import("@tiptap/core").Extension<import("@/extensions/AIAutoCompletion").AIAutocompletionOptions, any> | import("@tiptap/core").Extension<any, any> | import("@tiptap/core").Extension<import("./Indent").IndentOptions, any> | import("@tiptap/core").Node<import("./ListItemWithDepthLimit").ListItemOptions, any> | import("@tiptap/core").Extension<import("./Redline").RedlineOptions, any> | import("@tiptap/core").Node<import("@tiptap/extension-table").TableOptions, any> | import("@tiptap/core").Node<import("@tiptap/extension-table").TableRowOptions, any> | import("@tiptap/core").Node<import("./VariableText").VariableOptions, any> | import("@tiptap/core").Node<import("@tiptap/extension-horizontal-rule").HorizontalRuleOptions, any> | import("@tiptap/core").Node<import("./CodeBlockWithToolbar").CodeBlockWithToolbarOptions, any> | import("@tiptap/core").Extension<import("./PageMargin").PageMarginOptions, any> | import("@tiptap/core").Extension<import("./PageBackground").PageBackgroundOptions, any> | import("@tiptap/core").Node<import("./PageBreak").PageBreakOptions, any> | import("@tiptap/core").Node<any, any> | import("@tiptap/core").Node<import("./CustomImageExtension").CustomImageExtensionOptions, any> | import("@tiptap/core").Node<import("./Signature").SignatureOptions, any> | import("@tiptap/core").Node<import("./AnonymizedText").AnonymizedTextOptions, any> | import("@tiptap/core").Mark<import("./AnonymizedLink").AnonymizedLinkOptions, any> | import("@tiptap/core").Extension<import("@tiptap/extensions").UndoRedoOptions, any> | import("@tiptap/core").Extension<import("@tiptap/extensions").CharacterCountOptions, import("@tiptap/extensions").CharacterCountStorage> | import("@tiptap/core").Extension<import("@tiptap/extensions").PlaceholderOptions, any> | import("@tiptap/core").Extension<import("@tiptap/extension-typography").TypographyOptions, any> | import("@tiptap/core").Mark<import("@tiptap/extension-text-style").TextStyleOptions, any> | import("@tiptap/core").Extension<import("@tiptap/extension-text-style").FontSizeOptions, any> | import("@tiptap/core").Mark<import("@tiptap/extension-superscript").SuperscriptExtensionOptions, any> | import("@tiptap/core").Mark<import("@tiptap/extension-highlight").HighlightOptions, any> | import("@tiptap/core").Node<import("@tiptap/extension-list").TaskListOptions, any> | import("@tiptap/core").Extension<import("@tiptap/extension-text-align").TextAlignOptions, any> | import("@tiptap/core").Node<import("@tiptap/extension-heading").HeadingOptions, any> | import("@tiptap/core").Mark<import("@tiptap/extension-link").LinkOptions, any> | import("@tiptap/core").Node<import("@tiptap/extension-hard-break").HardBreakOptions, any> | import("@tiptap/core").Extension<import("@tiptap/extensions").TrailingNodeOptions, any> | import("@tiptap/core").Extension<import("@tiptap/extension-collaboration").CollaborationOptions, import("@tiptap/extension-collaboration").CollaborationStorage> | import("@tiptap/core").Extension<import("@tiptap/extension-collaboration-caret").CollaborationCaretOptions, {
     users: {
         clientId: number;
         [key: string]: any;