@flogeez/angular-tiptap-editor 3.3.0 → 3.4.1

package/lib/components/bubble-menus/base/ate-base-bubble-menu.d.ts

@@ -14,7 +14,7 @@ export declare abstract class AteBaseBubbleMenu implements AfterViewInit, OnDest
     editor: import("@angular/core").InputSignal<Editor>;
     menuRef: import("@angular/core").Signal<ElementRef<HTMLDivElement>>;
     protected tippyInstance: TippyInstance | null;
-    protected updateTimeout: number | null;
+    protected updateTimeout: ReturnType<typeof setTimeout> | null;
     protected readonly isToolbarInteracting: import("@angular/core").Signal<boolean>;
     readonly state: import("@angular/core").Signal<import("@flogeez/angular-tiptap-editor").AteEditorStateSnapshot>;
     constructor();

package/lib/components/bubble-menus/base/ate-base-sub-bubble-menu.d.ts

@@ -14,7 +14,7 @@ export declare abstract class AteBaseSubBubbleMenu implements AfterViewInit, OnD
     editor: import("@angular/core").InputSignal<Editor>;
     menuRef: import("@angular/core").Signal<ElementRef<HTMLDivElement>>;
     protected tippyInstance: TippyInstance | null;
-    protected updateTimeout: number | null;
+    protected updateTimeout: ReturnType<typeof setTimeout> | null;
     readonly state: import("@angular/core").Signal<import("@flogeez/angular-tiptap-editor").AteEditorStateSnapshot>;
     constructor();
     ngAfterViewInit(): void;

package/lib/components/table-of-contents/ate-table-of-contents.component.d.ts

@@ -0,0 +1,48 @@
+import { OnDestroy } from "@angular/core";
+import { Editor } from "@tiptap/core";
+import { AteEditorRef } from "../../models/ate-editor-ref";
+import * as i0 from "@angular/core";
+export interface AteTocItem {
+    text: string;
+    level: number;
+    pos: number;
+    id: string;
+    active: boolean;
+}
+export type AteTocVariant = "card" | "transparent" | "minimal";
+/**
+ * Table of Contents Component (Notion-style)
+ * Dynamically extracts headings from the active editor and displays them.
+ * Configurable via inputs (floating, position, variants, hover expansion) and CSS variables.
+ */
+export declare class AteTableOfContentsComponent implements OnDestroy {
+    editor: import("@angular/core").InputSignal<string | Editor | AteEditorRef | null | undefined>;
+    title: import("@angular/core").InputSignal<string | null>;
+    showTitle: import("@angular/core").InputSignal<boolean>;
+    floating: import("@angular/core").InputSignal<boolean>;
+    position: import("@angular/core").InputSignal<"left" | "right">;
+    variant: import("@angular/core").InputSignal<AteTocVariant>;
+    hoverExpand: import("@angular/core").InputSignal<boolean>;
+    private readonly registry;
+    private readonly i18n;
+    dashWidth(level: number): number;
+    readonly headerTitle: import("@angular/core").Signal<string>;
+    readonly resolvedEditor: import("@angular/core").Signal<Editor | null>;
+    readonly items: import("@angular/core").WritableSignal<AteTocItem[]>;
+    isMouseHovered: import("@angular/core").WritableSignal<boolean>;
+    isFocused: import("@angular/core").WritableSignal<boolean>;
+    readonly isExpanded: import("@angular/core").Signal<boolean>;
+    constructor();
+    ngOnDestroy(): void;
+    onScroll(): void;
+    setMouseHover(hovered: boolean): void;
+    setFocused(focused: boolean): void;
+    scrollToHeading(item: AteTocItem, event: MouseEvent): void;
+    private bindEditorEvents;
+    private unbindEditorEvents;
+    private readonly onEditorUpdate;
+    private updateHeadings;
+    private checkActiveHeading;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AteTableOfContentsComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AteTableOfContentsComponent, "ate-table-of-contents", never, { "editor": { "alias": "editor"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "showTitle": { "alias": "showTitle"; "required": false; "isSignal": true; }; "floating": { "alias": "floating"; "required": false; "isSignal": true; }; "position": { "alias": "position"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "hoverExpand": { "alias": "hoverExpand"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}

package/lib/components/table-of-contents/ate-toc-node.component.d.ts

@@ -0,0 +1,19 @@
+import { Injector } from "@angular/core";
+import { AteAngularNodeView } from "../../node-view/ate-angular-node-view";
+import { RegisterAngularComponentOptions } from "../../node-view/ate-node-view.models";
+import * as i0 from "@angular/core";
+/**
+ * Custom Angular NodeView wrapper for displaying Table of Contents directly inside the editor content.
+ */
+export declare class AteTocNodeComponent extends AteAngularNodeView {
+    static ɵfac: i0.ɵɵFactoryDeclaration<AteTocNodeComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<AteTocNodeComponent, "ate-toc-node", never, {}, {}, never, never, true, never>;
+}
+/**
+ * Registration options for the Table of Contents Angular NodeView
+ */
+export declare const AteTocNodeOptions: RegisterAngularComponentOptions<AteTocNodeComponent>;
+/**
+ * Creates the Table of Contents TipTap Node Extension instance.
+ */
+export declare function getAteTocNodeExtension(injector?: Injector): import("@tiptap/core").Node<any, any>;

package/lib/config/ate-slash-commands.config.d.ts

@@ -4,7 +4,7 @@ import { AteEditorCommandsService } from "../services/ate-editor-commands.servic
 /**
  * Clés des commandes natives dans l'ordre d'affichage
  */
-export declare const ATE_SLASH_COMMAND_KEYS: readonly ["heading1", "heading2", "heading3", "bulletList", "orderedList", "blockquote", "code", "image", "horizontalRule", "table"];
+export declare const ATE_SLASH_COMMAND_KEYS: readonly ["heading1", "heading2", "heading3", "bulletList", "orderedList", "blockquote", "code", "image", "horizontalRule", "table", "tableOfContents"];
 export type AteSlashCommandKey = (typeof ATE_SLASH_COMMAND_KEYS)[number];
 /**
  * Configuration simplifiée pour activer/désactiver les slash commands natives.

package/lib/i18n/ateTranslationsModel.d.ts

@@ -104,6 +104,11 @@ export interface AteTranslations {
             description: string;
             keywords: string[];
         };
+        tableOfContents: {
+            title: string;
+            description: string;
+            keywords: string[];
+        };
     };
     table: {
         addRowBefore: string;
@@ -161,6 +166,7 @@ export interface AteTranslations {
         viewMode: string;
         blockAdd: string;
         blockDrag: string;
+        tableOfContents: string;
     };
     common: {
         cancel: string;

package/lib/node-view/ate-angular-node-view.d.ts

@@ -49,6 +49,10 @@ export declare abstract class AteAngularNodeView {
      * The ProseMirror node
      */
     node: Signal<ProseMirrorNode>;
+    /**
+     * Helper signal to directly access node attributes
+     */
+    attributes: Signal<Record<string, unknown>>;
     /**
      * Decorations applied to this node
      */

package/lib/services/ate-i18n.service.d.ts

@@ -113,6 +113,11 @@ export declare class AteI18nService {
             description: string;
             keywords: string[];
         };
+        tableOfContents: {
+            title: string;
+            description: string;
+            keywords: string[];
+        };
     }>;
     readonly table: import("@angular/core").Signal<{
         addRowBefore: string;
@@ -170,6 +175,7 @@ export declare class AteI18nService {
         viewMode: string;
         blockAdd: string;
         blockDrag: string;
+        tableOfContents: string;
     }>;
     readonly common: import("@angular/core").Signal<{
         cancel: string;
@@ -243,6 +249,10 @@ export declare class AteI18nService {
         title: string;
         description: string;
         keywords: string[];
+    } | {
+        title: string;
+        description: string;
+        keywords: string[];
     };
     static ɵfac: i0.ɵɵFactoryDeclaration<AteI18nService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AteI18nService>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flogeez/angular-tiptap-editor",
-  "version": "3.3.0",
+  "version": "3.4.1",
   "description": "A modern, customizable rich-text editor for Angular (18+), built with Tiptap and featuring complete internationalization support",
   "keywords": [
     "angular",

package/public-api.d.ts

@@ -1,4 +1,6 @@
 export * from "./lib/components/editor/angular-tiptap-editor.component";
+export { AteTableOfContentsComponent, type AteTocItem, type AteTocVariant } from "./lib/components/table-of-contents/ate-table-of-contents.component";
+export { AteTocNodeComponent, AteTocNodeOptions, getAteTocNodeExtension } from "./lib/components/table-of-contents/ate-toc-node.component";
 export * from "./lib/ate-editor.provider";
 export * from "./lib/directives/ate-noop-value-accessor.directive";
 export * from "./lib/directives/ate-tooltip.directive";

package/src/lib/styles/ate-variables.global.css

@@ -0,0 +1,173 @@
+/* ==========================================================================
+   Full Design Tokens & CSS Custom Properties for angular-tiptap-editor
+   ========================================================================== */
+:root {
+  /* ===== BASE TOKENS ===== */
+  --ate-primary: #2563eb;
+  --ate-primary-hover: #153ca9;
+  --ate-primary-contrast: #ffffff;
+  --ate-primary-light: color-mix(in srgb, var(--ate-primary), transparent 90%);
+  --ate-primary-lighter: color-mix(in srgb, var(--ate-primary), transparent 95%);
+  --ate-primary-light-alpha: color-mix(in srgb, var(--ate-primary), transparent 85%);
+
+  --ate-surface: #ffffff;
+  --ate-surface-secondary: #f8f9fa;
+  --ate-surface-tertiary: #f1f5f9;
+  --ate-surface-hover: rgba(37, 99, 235, 0.05);
+
+  --ate-text: #2d3748;
+  --ate-text-primary: #1e293b;
+  --ate-text-secondary: #64748b;
+  --ate-text-muted: #a0aec0;
+
+  --ate-border: #e2e8f0;
+
+  --ate-highlight-bg: #fef08a;
+  --ate-highlight-color: #854d0e;
+
+  --ate-button-hover: #f1f5f9;
+  --ate-button-active: #e2e8f0;
+
+  --ate-selection-bg: var(--ate-primary-light-alpha);
+
+  --ate-error-color: #c53030;
+  --ate-error-bg: #fed7d7;
+  --ate-error-border: #feb2b2;
+
+  /* ===== COMPONENT TOKENS ===== */
+  --ate-border-color: var(--ate-border);
+  --ate-border-width: 2px;
+  --ate-border-radius: 12px;
+  --ate-sub-border-radius: 8px;
+  --ate-focus-color: var(--ate-primary);
+  --ate-background: var(--ate-surface);
+
+  /* Content */
+  --ate-text-color: var(--ate-text);
+  --ate-placeholder-color: var(--ate-text-muted);
+  --ate-line-height: 1.6;
+  --ate-content-padding-block: 16px;
+  --ate-content-padding-inline: 16px;
+  --ate-content-gutter: 0px;
+
+  /* Menus (Slash/Bubble/TOC) */
+  --ate-menu-bg: var(--ate-surface);
+  --ate-menu-border-radius: var(--ate-border-radius);
+  --ate-menu-border: var(--ate-border);
+  --ate-menu-shadow: 0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -2px rgba(0, 0, 0, 0.05);
+  --ate-menu-padding: 4px;
+  --ate-menu-gap: 2px;
+
+  /* Toolbar */
+  --ate-toolbar-padding: var(--ate-menu-padding);
+  --ate-toolbar-gap: var(--ate-menu-gap);
+  --ate-toolbar-background: var(--ate-surface-secondary);
+  --ate-toolbar-border-color: var(--ate-border);
+  --ate-toolbar-button-color: var(--ate-text-secondary);
+  --ate-toolbar-button-hover-background: transparent;
+  --ate-toolbar-button-active-background: var(--ate-primary-light);
+  --ate-toolbar-button-active-color: var(--ate-primary);
+
+  /* Counter & Footer */
+  --ate-counter-color: var(--ate-text-secondary);
+  --ate-counter-background: var(--ate-surface-secondary);
+  --ate-counter-border-color: var(--ate-border);
+
+  /* Table of Contents (TOC) */
+  --ate-toc-width: 240px;
+  --ate-toc-gap: 2px;
+  --ate-toc-item-height: 16px;
+  --ate-toc-item-hover-height: 24px;
+  --ate-toc-border-radius: var(--ate-border-radius);
+  --ate-toc-padding: var(--ate-menu-padding);
+  --ate-toc-hitbox-padding: 16px;
+  --ate-toc-hitbox-padding-vertical: 8px;
+
+  /* Drag & Drop */
+  --ate-drag-background: #f0f8ff;
+  --ate-drag-border-color: var(--ate-primary);
+
+  /* Blockquote */
+  --ate-blockquote-border-color: var(--ate-border);
+  --ate-blockquote-background: var(--ate-surface-secondary);
+
+  /* Code */
+  --ate-code-background: var(--ate-surface-secondary);
+  --ate-code-color: var(--ate-text);
+  --ate-code-border-color: var(--ate-border);
+
+  --ate-code-block-background: #0f172a;
+  --ate-code-block-color: #e2e8f0;
+  --ate-code-block-border-color: var(--ate-border);
+
+  /* Images */
+  --ate-image-border-radius: 16px;
+  --ate-image-selected-color: var(--ate-primary);
+
+  /* Scrollbars */
+  --ate-scrollbar-width: 10px;
+  --ate-scrollbar-thumb: var(--ate-border);
+  --ate-scrollbar-thumb-hover: var(--ate-text-muted);
+  --ate-scrollbar-track: transparent;
+
+  /* Tables */
+  --ate-table-border-color: var(--ate-border);
+  --ate-table-header-background: var(--ate-surface-secondary);
+  --ate-table-header-color: var(--ate-text);
+  --ate-table-cell-background: var(--ate-surface);
+  --ate-table-cell-selected-background: var(--ate-primary-light);
+  --ate-table-resize-handle-color: var(--ate-primary);
+  --ate-table-row-hover-background: var(--ate-primary-lighter);
+
+  /* Floating UI & Tooltips */
+  --ate-tooltip-bg: var(--ate-code-block-background, #0f172a);
+  --ate-tooltip-color: var(--ate-code-block-color, #e2e8f0);
+}
+
+/* Dark mode global theme support */
+.dark,
+:root.dark,
+body.dark,
+:root[data-theme="dark"],
+[data-theme="dark"] {
+  --ate-primary: #3b82f6;
+  --ate-primary-contrast: #ffffff;
+  --ate-primary-light: color-mix(in srgb, var(--ate-primary), transparent 85%);
+  --ate-primary-lighter: color-mix(in srgb, var(--ate-primary), transparent 92%);
+  --ate-primary-light-alpha: color-mix(in srgb, var(--ate-primary), transparent 80%);
+
+  --ate-surface: #020617;
+  --ate-surface-secondary: #0f172a;
+  --ate-surface-tertiary: #1e293b;
+  --ate-surface-hover: rgba(59, 130, 246, 0.1);
+
+  --ate-text: #f8fafc;
+  --ate-text-primary: #f8fafc;
+  --ate-text-secondary: #94a3b8;
+  --ate-text-muted: #64748b;
+
+  --ate-border: #1e293b;
+
+  --ate-highlight-bg: #854d0e;
+  --ate-highlight-color: #fef08a;
+
+  --ate-button-hover: #1e293b;
+  --ate-button-active: #0f172a;
+
+  --ate-menu-border: rgba(255, 255, 255, 0.1);
+  --ate-menu-shadow: 0 20px 25px -5px rgba(0, 0, 0, 0.3), 0 10px 10px -5px rgba(0, 0, 0, 0.2);
+
+  --ate-error-color: #f87171;
+  --ate-error-bg: #450a0a;
+  --ate-error-border: #7f1d1d;
+
+  --ate-drag-background: var(--ate-surface-tertiary);
+  --ate-drag-border-color: var(--ate-primary);
+  --ate-blockquote-border-color: var(--ate-primary);
+  --ate-toolbar-button-active-background: var(--ate-primary-light);
+  --ate-toolbar-button-active-color: var(--ate-primary);
+  --ate-button-hover: var(--ate-surface-tertiary);
+  --ate-button-active: var(--ate-surface-secondary);
+  --ate-scrollbar-thumb: var(--ate-surface-tertiary);
+  --ate-scrollbar-thumb-hover: var(--ate-text-muted);
+}

package/src/lib/styles/index.css

@@ -1,3 +1,4 @@
+@import "./ate-variables.global.css";
 @import "./ate-bubble-menu.global.css";
 @import "./ate-tooltip.global.css";
 @import "./material-symbols.css";