@harbour-enterprises/superdoc 0.29.0-next.6 → 0.29.0-next.8

package/dist/{stores → packages/superdoc/src/stores}/superdoc-store.d.ts

@@ -1,17 +1,17 @@
 export const useSuperdocStore: import("pinia").StoreDefinition<"superdoc", Pick<{
     commentsStore: import("pinia").Store<"comments", Pick<{
-        COMMENT_EVENTS: Readonly<{
-            RESOLVED: "resolved";
-            NEW: "new";
-            ADD: "add";
-            UPDATE: "update";
-            DELETED: "deleted";
-            PENDING: "pending";
-            SELECTED: "selected";
-            COMMENTS_LIST: "comments-list";
-            CHANGE_ACCEPTED: "change-accepted";
-            CHANGE_REJECTED: "change-rejected";
-        }>;
+        COMMENT_EVENTS: {
+            readonly RESOLVED: "resolved";
+            readonly NEW: "new";
+            readonly ADD: "add";
+            readonly UPDATE: "update";
+            readonly DELETED: "deleted";
+            readonly PENDING: "pending";
+            readonly SELECTED: "selected";
+            readonly COMMENTS_LIST: "comments-list";
+            readonly CHANGE_ACCEPTED: "change-accepted";
+            readonly CHANGE_REJECTED: "change-rejected";
+        };
         isDebugging: boolean;
         hasInitializedComments: import("vue").Ref<boolean, boolean>;
         hasSyncedCollaborationComments: import("vue").Ref<boolean, boolean>;
@@ -82,18 +82,18 @@ export const useSuperdocStore: import("pinia").StoreDefinition<"superdoc", Pick<
             params: any;
         }) => void;
     }, "COMMENT_EVENTS" | "isDebugging" | "hasInitializedComments" | "hasSyncedCollaborationComments" | "editingCommentId" | "activeComment" | "commentDialogs" | "overlappingComments" | "overlappedIds" | "suppressInternalExternal" | "pendingComment" | "currentCommentText" | "commentsList" | "isCommentsListVisible" | "generalCommentIds" | "editorCommentIds" | "commentsParentElement" | "editorCommentPositions" | "hasInitializedLocations" | "isCommentHighlighted" | "floatingCommentsOffset" | "sortedConversations" | "visibleConversations" | "skipSelectionUpdate" | "isFloatingCommentsReady">, Pick<{
-        COMMENT_EVENTS: Readonly<{
-            RESOLVED: "resolved";
-            NEW: "new";
-            ADD: "add";
-            UPDATE: "update";
-            DELETED: "deleted";
-            PENDING: "pending";
-            SELECTED: "selected";
-            COMMENTS_LIST: "comments-list";
-            CHANGE_ACCEPTED: "change-accepted";
-            CHANGE_REJECTED: "change-rejected";
-        }>;
+        COMMENT_EVENTS: {
+            readonly RESOLVED: "resolved";
+            readonly NEW: "new";
+            readonly ADD: "add";
+            readonly UPDATE: "update";
+            readonly DELETED: "deleted";
+            readonly PENDING: "pending";
+            readonly SELECTED: "selected";
+            readonly COMMENTS_LIST: "comments-list";
+            readonly CHANGE_ACCEPTED: "change-accepted";
+            readonly CHANGE_REJECTED: "change-rejected";
+        };
         isDebugging: boolean;
         hasInitializedComments: import("vue").Ref<boolean, boolean>;
         hasSyncedCollaborationComments: import("vue").Ref<boolean, boolean>;
@@ -164,18 +164,18 @@ export const useSuperdocStore: import("pinia").StoreDefinition<"superdoc", Pick<
             params: any;
         }) => void;
     }, "getConfig" | "documentsWithConverations" | "getGroupedComments" | "getFloatingComments">, Pick<{
-        COMMENT_EVENTS: Readonly<{
-            RESOLVED: "resolved";
-            NEW: "new";
-            ADD: "add";
-            UPDATE: "update";
-            DELETED: "deleted";
-            PENDING: "pending";
-            SELECTED: "selected";
-            COMMENTS_LIST: "comments-list";
-            CHANGE_ACCEPTED: "change-accepted";
-            CHANGE_REJECTED: "change-rejected";
-        }>;
+        COMMENT_EVENTS: {
+            readonly RESOLVED: "resolved";
+            readonly NEW: "new";
+            readonly ADD: "add";
+            readonly UPDATE: "update";
+            readonly DELETED: "deleted";
+            readonly PENDING: "pending";
+            readonly SELECTED: "selected";
+            readonly COMMENTS_LIST: "comments-list";
+            readonly CHANGE_ACCEPTED: "change-accepted";
+            readonly CHANGE_REJECTED: "change-rejected";
+        };
         isDebugging: boolean;
         hasInitializedComments: import("vue").Ref<boolean, boolean>;
         hasSyncedCollaborationComments: import("vue").Ref<boolean, boolean>;
@@ -292,20 +292,20 @@ export const useSuperdocStore: import("pinia").StoreDefinition<"superdoc", Pick<
     getPageBounds: (documentId: any, page: any) => {
         top: number;
     };
-}, "commentsStore" | "documents" | "documentBounds" | "pages" | "documentUsers" | "users" | "activeZoom" | "documentScroll" | "isInternal" | "selectionPosition" | "activeSelection" | "isReady" | "user" | "modules">, Pick<{
+}, "user" | "commentsStore" | "documents" | "documentBounds" | "pages" | "documentUsers" | "users" | "activeZoom" | "documentScroll" | "isInternal" | "selectionPosition" | "activeSelection" | "isReady" | "modules">, Pick<{
     commentsStore: import("pinia").Store<"comments", Pick<{
-        COMMENT_EVENTS: Readonly<{
-            RESOLVED: "resolved";
-            NEW: "new";
-            ADD: "add";
-            UPDATE: "update";
-            DELETED: "deleted";
-            PENDING: "pending";
-            SELECTED: "selected";
-            COMMENTS_LIST: "comments-list";
-            CHANGE_ACCEPTED: "change-accepted";
-            CHANGE_REJECTED: "change-rejected";
-        }>;
+        COMMENT_EVENTS: {
+            readonly RESOLVED: "resolved";
+            readonly NEW: "new";
+            readonly ADD: "add";
+            readonly UPDATE: "update";
+            readonly DELETED: "deleted";
+            readonly PENDING: "pending";
+            readonly SELECTED: "selected";
+            readonly COMMENTS_LIST: "comments-list";
+            readonly CHANGE_ACCEPTED: "change-accepted";
+            readonly CHANGE_REJECTED: "change-rejected";
+        };
         isDebugging: boolean;
         hasInitializedComments: import("vue").Ref<boolean, boolean>;
         hasSyncedCollaborationComments: import("vue").Ref<boolean, boolean>;
@@ -376,18 +376,18 @@ export const useSuperdocStore: import("pinia").StoreDefinition<"superdoc", Pick<
             params: any;
         }) => void;
     }, "COMMENT_EVENTS" | "isDebugging" | "hasInitializedComments" | "hasSyncedCollaborationComments" | "editingCommentId" | "activeComment" | "commentDialogs" | "overlappingComments" | "overlappedIds" | "suppressInternalExternal" | "pendingComment" | "currentCommentText" | "commentsList" | "isCommentsListVisible" | "generalCommentIds" | "editorCommentIds" | "commentsParentElement" | "editorCommentPositions" | "hasInitializedLocations" | "isCommentHighlighted" | "floatingCommentsOffset" | "sortedConversations" | "visibleConversations" | "skipSelectionUpdate" | "isFloatingCommentsReady">, Pick<{
-        COMMENT_EVENTS: Readonly<{
-            RESOLVED: "resolved";
-            NEW: "new";
-            ADD: "add";
-            UPDATE: "update";
-            DELETED: "deleted";
-            PENDING: "pending";
-            SELECTED: "selected";
-            COMMENTS_LIST: "comments-list";
-            CHANGE_ACCEPTED: "change-accepted";
-            CHANGE_REJECTED: "change-rejected";
-        }>;
+        COMMENT_EVENTS: {
+            readonly RESOLVED: "resolved";
+            readonly NEW: "new";
+            readonly ADD: "add";
+            readonly UPDATE: "update";
+            readonly DELETED: "deleted";
+            readonly PENDING: "pending";
+            readonly SELECTED: "selected";
+            readonly COMMENTS_LIST: "comments-list";
+            readonly CHANGE_ACCEPTED: "change-accepted";
+            readonly CHANGE_REJECTED: "change-rejected";
+        };
         isDebugging: boolean;
         hasInitializedComments: import("vue").Ref<boolean, boolean>;
         hasSyncedCollaborationComments: import("vue").Ref<boolean, boolean>;
@@ -458,18 +458,18 @@ export const useSuperdocStore: import("pinia").StoreDefinition<"superdoc", Pick<
             params: any;
         }) => void;
     }, "getConfig" | "documentsWithConverations" | "getGroupedComments" | "getFloatingComments">, Pick<{
-        COMMENT_EVENTS: Readonly<{
-            RESOLVED: "resolved";
-            NEW: "new";
-            ADD: "add";
-            UPDATE: "update";
-            DELETED: "deleted";
-            PENDING: "pending";
-            SELECTED: "selected";
-            COMMENTS_LIST: "comments-list";
-            CHANGE_ACCEPTED: "change-accepted";
-            CHANGE_REJECTED: "change-rejected";
-        }>;
+        COMMENT_EVENTS: {
+            readonly RESOLVED: "resolved";
+            readonly NEW: "new";
+            readonly ADD: "add";
+            readonly UPDATE: "update";
+            readonly DELETED: "deleted";
+            readonly PENDING: "pending";
+            readonly SELECTED: "selected";
+            readonly COMMENTS_LIST: "comments-list";
+            readonly CHANGE_ACCEPTED: "change-accepted";
+            readonly CHANGE_REJECTED: "change-rejected";
+        };
         isDebugging: boolean;
         hasInitializedComments: import("vue").Ref<boolean, boolean>;
         hasSyncedCollaborationComments: import("vue").Ref<boolean, boolean>;
@@ -588,18 +588,18 @@ export const useSuperdocStore: import("pinia").StoreDefinition<"superdoc", Pick<
     };
 }, "areDocumentsReady">, Pick<{
     commentsStore: import("pinia").Store<"comments", Pick<{
-        COMMENT_EVENTS: Readonly<{
-            RESOLVED: "resolved";
-            NEW: "new";
-            ADD: "add";
-            UPDATE: "update";
-            DELETED: "deleted";
-            PENDING: "pending";
-            SELECTED: "selected";
-            COMMENTS_LIST: "comments-list";
-            CHANGE_ACCEPTED: "change-accepted";
-            CHANGE_REJECTED: "change-rejected";
-        }>;
+        COMMENT_EVENTS: {
+            readonly RESOLVED: "resolved";
+            readonly NEW: "new";
+            readonly ADD: "add";
+            readonly UPDATE: "update";
+            readonly DELETED: "deleted";
+            readonly PENDING: "pending";
+            readonly SELECTED: "selected";
+            readonly COMMENTS_LIST: "comments-list";
+            readonly CHANGE_ACCEPTED: "change-accepted";
+            readonly CHANGE_REJECTED: "change-rejected";
+        };
         isDebugging: boolean;
         hasInitializedComments: import("vue").Ref<boolean, boolean>;
         hasSyncedCollaborationComments: import("vue").Ref<boolean, boolean>;
@@ -670,18 +670,18 @@ export const useSuperdocStore: import("pinia").StoreDefinition<"superdoc", Pick<
             params: any;
         }) => void;
     }, "COMMENT_EVENTS" | "isDebugging" | "hasInitializedComments" | "hasSyncedCollaborationComments" | "editingCommentId" | "activeComment" | "commentDialogs" | "overlappingComments" | "overlappedIds" | "suppressInternalExternal" | "pendingComment" | "currentCommentText" | "commentsList" | "isCommentsListVisible" | "generalCommentIds" | "editorCommentIds" | "commentsParentElement" | "editorCommentPositions" | "hasInitializedLocations" | "isCommentHighlighted" | "floatingCommentsOffset" | "sortedConversations" | "visibleConversations" | "skipSelectionUpdate" | "isFloatingCommentsReady">, Pick<{
-        COMMENT_EVENTS: Readonly<{
-            RESOLVED: "resolved";
-            NEW: "new";
-            ADD: "add";
-            UPDATE: "update";
-            DELETED: "deleted";
-            PENDING: "pending";
-            SELECTED: "selected";
-            COMMENTS_LIST: "comments-list";
-            CHANGE_ACCEPTED: "change-accepted";
-            CHANGE_REJECTED: "change-rejected";
-        }>;
+        COMMENT_EVENTS: {
+            readonly RESOLVED: "resolved";
+            readonly NEW: "new";
+            readonly ADD: "add";
+            readonly UPDATE: "update";
+            readonly DELETED: "deleted";
+            readonly PENDING: "pending";
+            readonly SELECTED: "selected";
+            readonly COMMENTS_LIST: "comments-list";
+            readonly CHANGE_ACCEPTED: "change-accepted";
+            readonly CHANGE_REJECTED: "change-rejected";
+        };
         isDebugging: boolean;
         hasInitializedComments: import("vue").Ref<boolean, boolean>;
         hasSyncedCollaborationComments: import("vue").Ref<boolean, boolean>;
@@ -752,18 +752,18 @@ export const useSuperdocStore: import("pinia").StoreDefinition<"superdoc", Pick<
             params: any;
         }) => void;
     }, "getConfig" | "documentsWithConverations" | "getGroupedComments" | "getFloatingComments">, Pick<{
-        COMMENT_EVENTS: Readonly<{
-            RESOLVED: "resolved";
-            NEW: "new";
-            ADD: "add";
-            UPDATE: "update";
-            DELETED: "deleted";
-            PENDING: "pending";
-            SELECTED: "selected";
-            COMMENTS_LIST: "comments-list";
-            CHANGE_ACCEPTED: "change-accepted";
-            CHANGE_REJECTED: "change-rejected";
-        }>;
+        COMMENT_EVENTS: {
+            readonly RESOLVED: "resolved";
+            readonly NEW: "new";
+            readonly ADD: "add";
+            readonly UPDATE: "update";
+            readonly DELETED: "deleted";
+            readonly PENDING: "pending";
+            readonly SELECTED: "selected";
+            readonly COMMENTS_LIST: "comments-list";
+            readonly CHANGE_ACCEPTED: "change-accepted";
+            readonly CHANGE_REJECTED: "change-rejected";
+        };
         isDebugging: boolean;
         hasInitializedComments: import("vue").Ref<boolean, boolean>;
         hasSyncedCollaborationComments: import("vue").Ref<boolean, boolean>;
@@ -880,5 +880,5 @@ export const useSuperdocStore: import("pinia").StoreDefinition<"superdoc", Pick<
     getPageBounds: (documentId: any, page: any) => {
         top: number;
     };
-}, "init" | "setExceptionHandler" | "reset" | "handlePageReady" | "getDocument" | "getPageBounds">>;
+}, "reset" | "init" | "setExceptionHandler" | "handlePageReady" | "getDocument" | "getPageBounds">>;
 //# sourceMappingURL=superdoc-store.d.ts.map

package/dist/{stores → packages/superdoc/src/stores}/superdoc-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"superdoc-store.d.ts","sourceRoot":"","sources":["../../src/stores/superdoc-store.js"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oGA4QG"}
+{"version":3,"file":"superdoc-store.d.ts","sourceRoot":"","sources":["../../../../../src/stores/superdoc-store.js"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oGA4QG"}

package/dist/{super-editor.d.ts.map → packages/superdoc/src/super-editor.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"super-editor.d.ts","sourceRoot":"","sources":["../src/super-editor.js"],"names":[],"mappings":""}
+{"version":3,"file":"super-editor.d.ts","sourceRoot":"","sources":["../../../../src/super-editor.js"],"names":[],"mappings":""}

package/dist/shared/common/Telemetry.d.ts

@@ -0,0 +1,237 @@
+type TelemetryAttributes = Record<string, unknown>;
+type ReadonlyTelemetryRecord = Readonly<Record<string, unknown>>;
+/**
+ * Standard telemetry event names
+ */
+export declare const TelemetryEventNames: {
+    readonly DOCUMENT_OPENED: "document:opened";
+    readonly DOCUMENT_PARSED: "document:parsed";
+    readonly DOCUMENT_EXPORTED: "document:exported";
+    readonly ERROR_OCCURRED: "error:occurred";
+    readonly FEATURE_USED: "feature:used";
+    readonly CONVERSION_STARTED: "conversion:started";
+    readonly CONVERSION_COMPLETED: "conversion:completed";
+};
+/**
+ * Known telemetry event names (provides autocomplete)
+ */
+export type KnownTelemetryEvent = typeof TelemetryEventNames[keyof typeof TelemetryEventNames];
+/**
+ * Custom telemetry event name - use for application-specific events
+ * Branded type to distinguish from known events
+ */
+export type CustomTelemetryEvent = string & {
+    readonly __custom?: never;
+};
+/**
+ * Telemetry event name - either a known event or a custom event
+ */
+export type TelemetryEventName = KnownTelemetryEvent | CustomTelemetryEvent;
+/**
+ * Valid statistic categories for tracking
+ */
+export type StatisticCategory = 'node' | 'unknown' | 'error';
+/**
+ * Create a custom telemetry event name
+ * Use this for application-specific events not covered by TelemetryEventNames
+ * @param eventName - Custom event name (e.g., 'feature:custom-action')
+ * @returns Branded custom event name
+ */
+export declare function customTelemetryEvent(eventName: string): CustomTelemetryEvent;
+export interface TelemetryConfig {
+    readonly licenseKey?: string;
+    readonly enabled?: boolean;
+    readonly endpoint?: string;
+    readonly documentGuid?: string;
+    readonly documentIdentifier?: string;
+    readonly superdocVersion: string;
+}
+export interface BrowserInfo {
+    readonly userAgent: string;
+    readonly currentUrl: string;
+    readonly hostname: string;
+    readonly referrerUrl: string;
+    readonly screenSize: {
+        readonly width: number;
+        readonly height: number;
+    };
+}
+export interface Statistics {
+    nodeTypes: Record<string, number>;
+    markTypes: Record<string, number>;
+    attributes: Record<string, number>;
+    errorCount: number;
+}
+export interface FileInfo {
+    readonly path: string;
+    readonly name: string;
+    readonly size?: number;
+    readonly depth: number;
+}
+export interface FileStructure {
+    totalFiles: number;
+    maxDepth: number;
+    totalNodes: number;
+    files: FileInfo[];
+}
+export interface DocumentInfo {
+    readonly guid?: string;
+    readonly identifier?: string;
+    readonly name: string;
+    readonly size: number;
+    readonly lastModified: string | null;
+    readonly type: string;
+    readonly internalId?: string;
+}
+export interface BaseTelemetryEvent {
+    id: string;
+    timestamp: string;
+    sessionId: string;
+    documentGuid?: string;
+    documentIdentifier?: string;
+    superdocVersion: string;
+    file: DocumentInfo | null;
+    browser: BrowserInfo;
+}
+export interface TelemetryUsageEvent extends BaseTelemetryEvent {
+    type: 'usage';
+    name: string;
+    properties: TelemetryAttributes;
+}
+export interface TelemetryParsingReport extends BaseTelemetryEvent {
+    type: 'parsing';
+    statistics: Statistics;
+    fileStructure: FileStructure;
+    unknownElements: UnknownElement[];
+    errors: TelemetryError[];
+}
+export type TelemetryPayload = TelemetryUsageEvent | TelemetryParsingReport[];
+export interface TelemetryError extends ReadonlyTelemetryRecord {
+    readonly message?: string;
+    readonly elementName?: string;
+    readonly attributes?: TelemetryAttributes;
+    readonly timestamp?: string;
+}
+export interface UnknownElement {
+    readonly elementName: string;
+    count: number;
+    attributes?: TelemetryAttributes;
+}
+/**
+ * Discriminated union for statistic data based on category
+ */
+export type StatisticData = {
+    category: 'node';
+    elementName: string;
+    attributes?: TelemetryAttributes;
+    marks?: Array<{
+        type: string;
+    }>;
+} | {
+    category: 'unknown';
+    elementName: string;
+    attributes?: TelemetryAttributes;
+} | {
+    category: 'error';
+    message?: string;
+    elementName?: string;
+    attributes?: TelemetryAttributes;
+    timestamp?: string;
+    [key: string]: unknown;
+};
+export declare class Telemetry {
+    enabled: boolean;
+    documentGuid?: string;
+    documentIdentifier?: string;
+    superdocVersion: string;
+    licenseKey: string;
+    endpoint: string;
+    sessionId: string;
+    statistics: Statistics;
+    unknownElements: UnknownElement[];
+    errors: TelemetryError[];
+    fileStructure: FileStructure;
+    documentInfo: DocumentInfo | null;
+    static readonly COMMUNITY_LICENSE_KEY: "community-and-eval-agplv3";
+    static readonly DEFAULT_ENDPOINT: "https://ingest.superdoc.dev/v1/collect";
+    /**
+     * Initialize telemetry service
+     * @param config - Telemetry configuration
+     */
+    constructor(config: TelemetryConfig);
+    /**
+     * Get browser environment information
+     * @returns Browser information
+     */
+    getBrowserInfo(): BrowserInfo;
+    /**
+     * Track document usage event
+     * @param name - Event name (use TelemetryEventNames for standard events)
+     * @param properties - Additional properties
+     */
+    trackUsage(name: TelemetryEventName, properties?: TelemetryAttributes): Promise<void>;
+    /**
+     * Track parsing statistics (new discriminated union API)
+     * @param data - Statistic data with category discriminator
+     */
+    trackStatistic(data: StatisticData): void;
+    /**
+     * Track parsing statistics (legacy API for backward compatibility)
+     * @param category - Statistic category
+     * @param data - Statistic data without category
+     * @deprecated Use the single-parameter overload with discriminated union instead
+     */
+    trackStatistic(category: 'node', data: Omit<Extract<StatisticData, {
+        category: 'node';
+    }>, 'category'>): void;
+    trackStatistic(category: 'unknown', data: Omit<Extract<StatisticData, {
+        category: 'unknown';
+    }>, 'category'>): void;
+    trackStatistic(category: 'error', data: Omit<Extract<StatisticData, {
+        category: 'error';
+    }>, 'category'>): void;
+    /**
+     * Track file structure
+     * @param structure - File structure information
+     * @param fileSource - original file
+     * @param documentId - document GUID
+     * @param documentIdentifier - document identifier (GUID or hash)
+     * @param internalId - document ID from settings.xml
+     */
+    trackFileStructure(structure: FileStructure, fileSource: File, documentId?: string, documentIdentifier?: string, internalId?: string): Promise<void>;
+    /**
+     * Process document metadata
+     * @param file - Document file
+     * @param options - Additional options
+     * @returns Document metadata
+     */
+    processDocument(file: File | null, options?: {
+        guid?: string;
+        identifier?: string;
+        internalId?: string;
+    }): Promise<DocumentInfo | null>;
+    isTelemetryDataChanged(): boolean;
+    /**
+     * Sends current report
+     * @returns Promise that resolves when report is sent
+     */
+    sendReport(): Promise<void>;
+    /**
+     * Sends data to the service
+     * @param data - Payload to send
+     * @returns Promise that resolves when data is sent
+     */
+    sendDataToTelemetry(data: TelemetryPayload): Promise<void>;
+    /**
+     * Generate unique identifier
+     * @returns Unique ID
+     * @private
+     */
+    generateId(): string;
+    /**
+     * Reset statistics
+     */
+    resetStatistics(): void;
+}
+export {};
+//# sourceMappingURL=Telemetry.d.ts.map

package/dist/shared/common/Telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Telemetry.d.ts","sourceRoot":"","sources":["../../../../../shared/common/Telemetry.ts"],"names":[],"mappings":"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"}

package/dist/shared/common/collaboration/awareness.d.ts

@@ -0,0 +1,39 @@
+type ReadonlyLooseRecord = Readonly<Record<string, unknown>>;
+/**
+ * Hex color string (e.g., "#FF0000")
+ */
+export type HexColor = `#${string}`;
+export interface User extends ReadonlyLooseRecord {
+    readonly email: string;
+    readonly name?: string;
+}
+export interface AwarenessState extends ReadonlyLooseRecord {
+    user?: User;
+}
+export interface AwarenessContext {
+    userColorMap: Map<string, HexColor>;
+    colorIndex: number;
+    config: {
+        readonly colors: readonly HexColor[];
+    };
+}
+export interface UserWithColor extends User {
+    readonly clientId: number;
+    readonly color: HexColor;
+}
+/**
+ * Convert provider awareness to an array of users
+ *
+ * @param context - Awareness context with color configuration
+ * @param states - The provider's awareness states object
+ * @returns Array of users with assigned colors
+ */
+export declare const awarenessStatesToArray: (context: AwarenessContext, states: Map<number, AwarenessState>) => UserWithColor[];
+/**
+ * Shuffle an array of hex colors
+ * @param array - List of hex colors
+ * @returns Shuffled array of hex colors
+ */
+export declare const shuffleArray: (array: HexColor[]) => HexColor[];
+export {};
+//# sourceMappingURL=awareness.d.ts.map

package/dist/shared/common/collaboration/awareness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"awareness.d.ts","sourceRoot":"","sources":["../../../../../../shared/common/collaboration/awareness.ts"],"names":[],"mappings":"AAAA,KAAK,mBAAmB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,IAAI,MAAM,EAAE,CAAC;AAEpC,MAAM,WAAW,IAAK,SAAQ,mBAAmB;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAe,SAAQ,mBAAmB;IACzD,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE;QACN,QAAQ,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAC;KACtC,CAAC;CACH;AAED,MAAM,WAAW,aAAc,SAAQ,IAAI;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;CAC1B;AASD;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,SAAS,gBAAgB,EACzB,QAAQ,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,KAClC,aAAa,EA4Bf,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,QAAQ,EAAE,KAAG,QAAQ,EAMxD,CAAC"}

package/dist/shared/common/document-types.d.ts

@@ -0,0 +1,10 @@
+export declare const DOCX: "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
+export declare const PDF: "application/pdf";
+export declare const HTML: "text/html";
+export declare const documentTypes: {
+    readonly docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
+    readonly pdf: "application/pdf";
+    readonly html: "text/html";
+};
+export type DocumentType = typeof DOCX | typeof PDF | typeof HTML;
+//# sourceMappingURL=document-types.d.ts.map

package/dist/shared/common/document-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-types.d.ts","sourceRoot":"","sources":["../../../../../shared/common/document-types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,EAAG,yEAAkF,CAAC;AACvG,eAAO,MAAM,GAAG,EAAG,iBAA0B,CAAC;AAC9C,eAAO,MAAM,IAAI,EAAG,WAAoB,CAAC;AAEzC,eAAO,MAAM,aAAa;;;;CAIhB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,OAAO,IAAI,GAAG,OAAO,GAAG,GAAG,OAAO,IAAI,CAAC"}

package/dist/shared/common/event-types.d.ts

@@ -0,0 +1,14 @@
+export declare const comments_module_events: {
+    readonly RESOLVED: "resolved";
+    readonly NEW: "new";
+    readonly ADD: "add";
+    readonly UPDATE: "update";
+    readonly DELETED: "deleted";
+    readonly PENDING: "pending";
+    readonly SELECTED: "selected";
+    readonly COMMENTS_LIST: "comments-list";
+    readonly CHANGE_ACCEPTED: "change-accepted";
+    readonly CHANGE_REJECTED: "change-rejected";
+};
+export type CommentEvent = typeof comments_module_events[keyof typeof comments_module_events];
+//# sourceMappingURL=event-types.d.ts.map

package/dist/shared/common/event-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-types.d.ts","sourceRoot":"","sources":["../../../../../shared/common/event-types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB;;;;;;;;;;;CAezB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,OAAO,sBAAsB,CAAC,MAAM,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/shared/common/helpers/compare-superdoc-versions.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Compare two versions of a superdoc.
+ * @param version1 - First version string (e.g., "1.2.3")
+ * @param version2 - Second version string (e.g., "1.2.4")
+ * @returns 1 if version1 is greater, -1 if version2 is greater, 0 if equal
+ */
+export declare function compareVersions(version1: string, version2: string): -1 | 0 | 1;
+//# sourceMappingURL=compare-superdoc-versions.d.ts.map

package/dist/shared/common/helpers/compare-superdoc-versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-superdoc-versions.d.ts","sourceRoot":"","sources":["../../../../../../shared/common/helpers/compare-superdoc-versions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAY9E"}