@shelamkoff/rector 1.0.0

package/dist/core/editorEvents.d.ts

@@ -0,0 +1,89 @@
+export type EditorEvent = string;
+export namespace EditorEvent {
+    let READY: string;
+    let WILL_CHANGE: string;
+    let CHANGED: string;
+    let DESTROYED: string;
+    let BLOCK_ADDED: string;
+    let BLOCK_REMOVED: string;
+    let BLOCK_MOVED: string;
+    let BLOCK_CONVERTED: string;
+    let BLOCK_CHANGED: string;
+    let BLOCK_FOCUSED: string;
+    let BLOCK_BLURRED: string;
+    let BLOCK_SELECTED: string;
+    let TOOLBAR_OPENED: string;
+    let TOOLBAR_CLOSED: string;
+    let UNDO_BATCH_START: string;
+    let UNDO_BATCH_END: string;
+    let HISTORY_COMMIT: string;
+    let HISTORY_CHANGED: string;
+    let READ_ONLY_CHANGED: string;
+    let PASTE_APPLIED: string;
+    let INLINE_PLUGIN_INSERT: string;
+    let DRAG_HANDLE_CLICKED: string;
+}
+/**
+ * Event payload type map. Used for JSDoc annotations at call sites.
+ */
+export type EditorEventMap = {
+    READY: void;
+    WILL_CHANGE: void;
+    CHANGED: void;
+    DESTROYED: void;
+    BLOCK_ADDED: {
+        blockId: string;
+        index: number;
+    };
+    BLOCK_REMOVED: {
+        blockId: string;
+        index: number;
+        animDone?: Promise<void>;
+    };
+    BLOCK_MOVED: {
+        blockId: string;
+        from: number;
+        to: number;
+    };
+    BLOCK_CONVERTED: {
+        blockId: string;
+        from: string;
+        to: string;
+    };
+    BLOCK_CHANGED: {
+        blockId: string;
+    };
+    BLOCK_FOCUSED: {
+        blockId: string;
+    };
+    BLOCK_BLURRED: {
+        blockId: string;
+    };
+    BLOCK_SELECTED: {
+        blockIds: string[];
+    };
+    TOOLBAR_OPENED: {
+        type: "block" | "inline";
+    };
+    TOOLBAR_CLOSED: {
+        type: "block" | "inline";
+    };
+    UNDO_BATCH_START: void;
+    UNDO_BATCH_END: void;
+    HISTORY_COMMIT: void;
+    HISTORY_CHANGED: {
+        canUndo: boolean;
+        canRedo: boolean;
+    };
+    READ_ONLY_CHANGED: {
+        readOnly: boolean;
+    };
+    PASTE_APPLIED: {
+        startBlockId?: string;
+        endBlockId?: string;
+    };
+    INLINE_PLUGIN_INSERT: {
+        type: string;
+    };
+    DRAG_HANDLE_CLICKED: void;
+};

package/dist/core/editorEvents.js

@@ -0,0 +1,60 @@
+/**
+ * Event payload type map. Used for JSDoc annotations at call sites.
+ *
+ * @typedef {Object} EditorEventMap
+ * @property {void} READY
+ * @property {void} WILL_CHANGE
+ * @property {void} CHANGED
+ * @property {void} DESTROYED
+ * @property {{ blockId: string, index: number }} BLOCK_ADDED
+ * @property {{ blockId: string, index: number, animDone?: Promise<void> }} BLOCK_REMOVED
+ * @property {{ blockId: string, from: number, to: number }} BLOCK_MOVED
+ * @property {{ blockId: string, from: string, to: string }} BLOCK_CONVERTED
+ * @property {{ blockId: string }} BLOCK_CHANGED
+ * @property {{ blockId: string }} BLOCK_FOCUSED
+ * @property {{ blockId: string }} BLOCK_BLURRED
+ * @property {{ blockIds: string[] }} BLOCK_SELECTED
+ * @property {{ type: 'block' | 'inline' }} TOOLBAR_OPENED
+ * @property {{ type: 'block' | 'inline' }} TOOLBAR_CLOSED
+ * @property {void} UNDO_BATCH_START
+ * @property {void} UNDO_BATCH_END
+ * @property {void} HISTORY_COMMIT
+ * @property {{ canUndo: boolean, canRedo: boolean }} HISTORY_CHANGED
+ * @property {{ readOnly: boolean }} READ_ONLY_CHANGED
+ * @property {{ startBlockId?: string, endBlockId?: string }} PASTE_APPLIED
+ * @property {{ type: string }} INLINE_PLUGIN_INSERT
+ * @property {void} DRAG_HANDLE_CLICKED
+ */
+
+/** @enum {string} */
+export const EditorEvent = {
+  READY: 'editor:ready',
+  WILL_CHANGE: 'editor:willChange',
+  CHANGED: 'editor:changed',
+  DESTROYED: 'editor:destroyed',
+
+  BLOCK_ADDED: 'block:added',
+  BLOCK_REMOVED: 'block:removed',
+  BLOCK_MOVED: 'block:moved',
+  BLOCK_CONVERTED: 'block:converted',
+  BLOCK_CHANGED: 'block:changed',
+  BLOCK_FOCUSED: 'block:focused',
+  BLOCK_BLURRED: 'block:blurred',
+  BLOCK_SELECTED: 'block:selected',
+
+  TOOLBAR_OPENED: 'toolbar:opened',
+  TOOLBAR_CLOSED: 'toolbar:closed',
+
+  UNDO_BATCH_START: 'undo:batchStart',
+  UNDO_BATCH_END: 'undo:batchEnd',
+  HISTORY_COMMIT: 'history:commit',
+  HISTORY_CHANGED: 'history:changed',
+  READ_ONLY_CHANGED: 'readOnly:changed',
+  PASTE_APPLIED: 'paste:applied',
+
+  INLINE_PLUGIN_INSERT: 'inlinePlugin:insert',
+
+  /** Drag handle was clicked (no drag occurred). Fired by DragManager,
+   *  consumed by Toolbar to open its block settings menu. */
+  DRAG_HANDLE_CLICKED: 'dragHandle:clicked',
+}

package/dist/core/hydrateInlinePlugins.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Hydrate inline plugin widgets inside a DOM root.
+ * Finds all `[data-inline-plugin]` elements and calls the matching plugin's `hydrate()`.
+ *
+ * @param {HTMLElement} root
+ * @param {import('./types.js').IInlinePluginRegistry} registry
+ * @param {import('./types.js').InlinePluginContext} ctx
+ */
+export function hydrateInlinePlugins(root: HTMLElement, registry: import("./types.js").IInlinePluginRegistry, ctx: import("./types.js").InlinePluginContext): void;

package/dist/core/hydrateInlinePlugins.js

@@ -0,0 +1,36 @@
+/**
+ * Hydrate inline plugin widgets inside a DOM root.
+ * Finds all `[data-inline-plugin]` elements and calls the matching plugin's `hydrate()`.
+ *
+ * @param {HTMLElement} root
+ * @param {import('./types').IInlinePluginRegistry} registry
+ * @param {import('./types').InlinePluginContext} ctx
+ */
+export function hydrateInlinePlugins(root, registry, ctx) {
+  if (!registry || registry.size === 0) return
+
+  const widgets = root.querySelectorAll('[data-inline-plugin]')
+  for (const widget of widgets) {
+    const el = /** @type {HTMLElement} */ (widget)
+    // Skip already hydrated widgets
+    if (el.dataset.hydrated) continue
+
+    const type = el.dataset.inlinePlugin
+    if (!type) continue
+
+    const plugin = registry.get(type)
+    if (!plugin) {
+      console.warn(`[hydrateInlinePlugins] Unknown inline plugin type: "${type}"`)
+      continue
+    }
+
+    try {
+      plugin.hydrate(el, ctx)
+      el.dataset.hydrated = '1'
+    } catch (err) {
+      // One malformed third-party widget must not prevent the rest of a
+      // document from rendering or hydrating.
+      console.warn(`[hydrateInlinePlugins] Failed to hydrate "${type}":`, err)
+    }
+  }
+}

package/dist/core/icons.d.ts

@@ -0,0 +1,10 @@
+export function createSvgIcon(d: string, size?: number): string;
+export const ICON_PLUS: string;
+export const ICON_DRAG: string;
+export const ICON_DELETE: string;
+export const ICON_UP: string;
+export const ICON_DOWN: string;
+export const ICON_DUPLICATE: string;
+export const ICON_BACK: string;
+export const ICON_SWITCH: string;
+export const ICON_CHEVRON_RIGHT: string;

package/dist/core/icons.js

@@ -0,0 +1,21 @@
+/**
+ * Create a 16×16 Tabler-style SVG icon from path data.
+ * @param {string} d — inner SVG elements (paths, circles, etc.)
+ * @param {number} [size=16]
+ * @returns {string}
+ */
+export const createSvgIcon = (d, size = 16) =>
+  `<svg xmlns="http://www.w3.org/2000/svg" width="${size}" height="${size}" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">${d}</svg>`
+
+// Toolbar icons
+export const ICON_PLUS = createSvgIcon('<path d="M12 5l0 14"/><path d="M5 12l14 0"/>')
+export const ICON_DRAG = createSvgIcon('<circle cx="9" cy="5" r="1"/><circle cx="15" cy="5" r="1"/><circle cx="9" cy="12" r="1"/><circle cx="15" cy="12" r="1"/><circle cx="9" cy="19" r="1"/><circle cx="15" cy="19" r="1"/>')
+
+// BlockSettingsMenu icons
+export const ICON_DELETE = createSvgIcon('<path d="M4 7l16 0"/><path d="M10 11l0 6"/><path d="M14 11l0 6"/><path d="M5 7l1 12a2 2 0 0 0 2 2h8a2 2 0 0 0 2 -2l1 -12"/><path d="M9 7v-3a1 1 0 0 1 1 -1h4a1 1 0 0 1 1 1v3"/>')
+export const ICON_UP = createSvgIcon('<path d="M6 15l6 -6l6 6"/>')
+export const ICON_DOWN = createSvgIcon('<path d="M6 9l6 6l6 -6"/>')
+export const ICON_DUPLICATE = createSvgIcon('<path d="M7 7m0 2.667a2.667 2.667 0 0 1 2.667 -2.667h8.666a2.667 2.667 0 0 1 2.667 2.667v8.666a2.667 2.667 0 0 1 -2.667 2.667h-8.666a2.667 2.667 0 0 1 -2.667 -2.667z"/><path d="M4.012 16.737a2.005 2.005 0 0 1 -2.012 -2.012v-8.725c0 -1.656 1.344 -3 3 -3h8.725a2 2 0 0 1 2.013 2.013"/>')
+export const ICON_BACK = createSvgIcon('<path d="M15 6l-6 6l6 6"/>')
+export const ICON_SWITCH = createSvgIcon('<path d="M20 10h-16l5.5 -6"/><path d="M4 14h16l-5.5 6"/>')
+export const ICON_CHEVRON_RIGHT = createSvgIcon('<path d="M9 6l6 6l-6 6"/>')

package/dist/core/index.d.ts

@@ -0,0 +1,59 @@
+export type {
+  EditorDocument,
+  BlockData,
+  DocumentMigration,
+  EditorDiagnostic,
+  EditorDiagnosticCode,
+  DiagnosticThresholds,
+  BasePlugin,
+  BlockPlugin,
+  BlockMutationContext,
+  BlockPluginConstructor,
+  ToolboxEntry,
+  PasteConfig,
+  PasteEvent,
+  TagPasteEvent,
+  FilePasteEvent,
+  PatternPasteEvent,
+  ShortcutEntry,
+  InlineTool,
+  InlineToolActionContext,
+  CaretPosition,
+  InlineSelection,
+  EditorEvents,
+  EditorConfig,
+  I18nMessages,
+  IBlock,
+  IBlockReader,
+  IBlockManager,
+  ISelectionManager,
+  IBlockOperations,
+  IEventBus,
+  EditorBlockView,
+  EditorBlocksApi,
+  EditorEventSubscriptions,
+  IEditor,
+  ICrossBlockSelection,
+  InlineControlContext,
+  InlineControlGroup,
+} from './types.js'
+
+export function createEditor(config: import('./types.js').EditorConfig): import('./types.js').IEditor
+export function createDefaultInlineTools(options?: { i18n?: import('./I18n.js').I18n, crossBlockSelection?: import('./types.js').ICrossBlockSelection }): import('./types.js').InlineTool[]
+export function uid(): string
+export function sanitizeHtml(html: string): string
+export function escapeHtml(text: string): string
+
+export { DocumentSchema } from './DocumentSchema.js'
+export { InlinePluginRegistry } from './InlinePluginRegistry.js'
+export { createColorSwatchPlugin } from '../inline-plugins/color.js'
+export { createMentionPlugin } from '../inline-plugins/mention/index.js'
+export type {
+  MentionItem,
+  MentionSearchResult,
+  MentionSearchFunction,
+  MentionRenderItem,
+  MentionRenderNoResults,
+  MentionRenderLoading,
+  MentionPluginOptions,
+} from '../inline-plugins/mention/index.js'