@layers-app/editor 0.7.32 → 0.7.34

package/README.md

@@ -426,116 +426,6 @@ For uploading a file or audio, you might need the third parameter "data".
 </details>
 
 
-<details>
-  <summary>
-    📊 Analytics (onTrack)
-  </summary>
-
-## Event Tracking
-
-The editor can track user actions via the `onTrack` callback. This allows the host application to send analytics events to any provider (Yandex.Metrika, Google Analytics, Mixpanel, etc.) without the editor depending on any specific analytics SDK.
-
-### Basic Usage
-
-```tsx
-import { trackGoal } from '@layers/hooks/useAnalytics';
-
-<Editor
-  {...props}
-  onTrack={trackGoal}
-/>
-```
-
-### Custom Handler
-
-```tsx
-const handleTrack = (event: string, params?: Record<string, unknown>) => {
-  console.log('Editor event:', event, params);
-
-  // Send to your analytics provider
-  myAnalytics.track(event, params);
-};
-
-<Editor
-  {...props}
-  onTrack={handleTrack}
-/>
-```
-
-### Type Signature
-
-```ts
-type EditorTrackFn = (
-  event: string,
-  params?: Record<string, unknown>,
-) => void;
-```
-
-### Tracked Events
-
-| Event | Trigger | Plugin |
-|-------|---------|--------|
-| `block_table_created` | User inserts a table | BlockFormatDropDown |
-| `block_image_added` | User inserts an image | BlockFormatDropDown |
-| `block_code_created` | User inserts a code block | BlockFormatDropDown |
-| `block_layout_used` | User inserts a grid/layout | BlockFormatDropDown |
-| `block_collapse_created` | User inserts a toggle/collapsible | BlockFormatDropDown |
-| `block_link_inserted` | User inserts a link | ToolbarPlugin |
-| `block_comment_added` | User adds an inline comment | ToolbarPlugin |
-| `ai_menu_opened` | User clicks the AI toolbar button | ToolbarPlugin/AI |
-| `block_heading_created` | User creates a heading (h1-h4) | BlockFormatDropDown |
-| `list_bullet_created` | User creates a bullet list | BlockFormatDropDown |
-| `list_number_created` | User creates a numbered list | BlockFormatDropDown |
-| `list_check_created` | User creates a checklist | BlockFormatDropDown |
-| `block_quote_created` | User creates a quote block | BlockFormatDropDown |
-| `block_divider_inserted` | User inserts a horizontal rule | BlockFormatDropDown |
-| `block_child_docs_inserted` | User inserts child documents block | BlockFormatDropDown |
-| `block_embed_added` | User adds an embed/integration | BlockFormatDropDown |
-| `media_audio_added` | User adds an audio block | BlockFormatDropDown |
-| `media_file_added` | User adds a file block | BlockFormatDropDown |
-| `table_row_added` | User inserts a table row | TableActionMenuPlugin |
-| `table_column_added` | User inserts a table column | TableActionMenuPlugin |
-| `table_row_deleted` | User deletes a table row | TableActionMenuPlugin |
-| `table_column_deleted` | User deletes a table column | TableActionMenuPlugin |
-| `block_duplicated` | User duplicates a block | DraggableBlockPlugin |
-| `block_deleted` | User deletes a block | DraggableBlockPlugin |
-| `text_code_toggled` | User toggles inline code format | ToolbarPlugin |
-| `text_formatting_cleared` | User clears all text formatting | ToolbarPlugin |
-
-> Events fire from both the toolbar dropdown menu and the slash command menu (`/`).
-
-### What Happens Without onTrack?
-
-If `onTrack` is not provided, **nothing happens** — all tracking calls use optional chaining (`onTrack?.('event')`) and are silently skipped. The editor works exactly the same with or without analytics. There is no error, no console warning, and no performance impact.
-
-This means:
-- **No analytics SDK required** — the editor is a standalone package with zero analytics dependencies
-- **Safe to omit** — if you don't need tracking, simply don't pass the prop
-- **No counter needed** — the editor itself never calls `ym()`, `gtag()`, or any external API directly
-
-### How It Works Internally
-
-1. `onTrack` is passed as a prop to `<Editor>` and stored in React Context
-2. Plugins access it via `useContext(Context)` and call `onTrack?.('event_name')`
-3. The host app decides what to do with the event (send to Metrika, log, ignore)
-
-```
-Host App                          Editor Package
-─────────                         ──────────────
-trackGoal() ──→ onTrack prop ──→ Context.onTrack
-     │                                │
-     │                          Plugins call:
-     │                          onTrack?.('block_table_created')
-     │                                │
-     ◄────────────────────────────────┘
-     │
-  ym(ID, 'reachGoal', 'block_table_created')
-  dataLayer.push({ event: 'block_table_created' })
-```
-
-</details>
-
-
 <details>
   <summary>
     👥 Collaboration
@@ -824,7 +714,6 @@ maxImageSizeError?: () => void - A function that is called if the image exceeds
 disable?: boolean - Toggles the editor into read-only mode.
 ws?: { url: string, id: string, user: { color: string, name: string }, getActiveUsers: (users) => void } - WebSocket settings: URL, document ID, current user details, and function to return active users editing the document.
 editorRef?: { current: EditorType | null } - Reference to the editor.
-onTrack?: (event: string, params?: Record<string, unknown>) => void - Optional callback for analytics event tracking. Called when the user performs tracked actions (insert table, add image, open AI menu, etc.). If not provided, tracking is silently skipped. See the "Analytics (onTrack)" section for the full list of events.
 ```
 
 </details>