smartrte-react 0.3.4 → 0.3.5

package/dist/formatRuntime.js

@@ -0,0 +1,20 @@
+import { createBuiltInFormatDefinitions } from "./builtInFormatDefinitions.js";
+export const createEditorFormatRuntime = (config = {}, replacements = createBuiltInFormatDefinitions()) => {
+    const seen = new Set();
+    replacements.forEach((format) => {
+        if (seen.has(format.id))
+            throw new Error(`Duplicate editor format "${format.id}".`);
+        seen.add(format.id);
+    });
+    const formats = replacements.filter((format) => config[format.id] !== false);
+    const byId = new Map(formats.map((format) => [format.id, format]));
+    return {
+        formats,
+        imports: formats.filter((format) => format.canImport),
+        exports: formats.filter((format) => format.canExport),
+        has: (format) => byId.has(format),
+        get: (format) => byId.get(format),
+        canImport: (format) => Boolean(byId.get(format)?.canImport),
+        canExport: (format) => Boolean(byId.get(format)?.canExport),
+    };
+};

package/dist/index.d.ts

@@ -1,4 +1,28 @@
 export { ClassicEditor } from './components/ClassicEditor.js';
+export type { ClassicEditorProps } from './components/ClassicEditor.js';
 export type { MediaManagerAdapter, MediaItem, MediaSearchQuery } from './components/MediaManager.js';
 export type { SrteTheme } from './theme.js';
 export { SRTE_DEFAULT_CSS, ensureStyleSheet } from './theme.js';
+export { createReactEditorPluginRuntime } from './pluginRuntime.js';
+export type { ReactEditorFeatureConfig, ReactEditorPluginRuntime } from './pluginRuntime.js';
+export type { ReactEditorPlugin, ReactPluginUi, ReactToolbarContribution } from './pluginRuntime.js';
+export type { ReactContextMenuContext, ReactContextMenuContribution, ReactKeyboardShortcutContribution } from './pluginRuntime.js';
+export type { ReactCommandContribution, ReactCommandContributionContext } from './pluginRuntime.js';
+export { matchesPluginShortcut } from './pluginRuntime.js';
+export { createDocumentFormatRegistry, defaultDocumentFormatRegistry, DocumentFormatRegistry, exportTextDocument, getDocumentFormatAdapter, importTextDocument, roundTripTextDocument } from './adapters/documentFormats.js';
+export type { DocumentFormatAdapter, DocumentImportContext, TextDocumentFormat } from './adapters/documentFormats.js';
+export { DOCX_MEDIA_TYPE, exportDocxDocument, importDocxDocumentWithMammoth, smartDocumentToDocxXml } from './adapters/docxFormat.js';
+export { enhanceDocxTables, importStyledDocxDocument } from './adapters/styledDocxFormat.js';
+export type { StyledDocxImportResult } from './adapters/styledDocxFormat.js';
+export { buildPdfPrintDocument, importPdfDocument, PDF_MEDIA_TYPE, printSmartDocumentAsPdf, reconstructPdfPages } from './adapters/pdfFormat.js';
+export type { PdfImportResult, PdfPageSnapshot, PdfTextItemSnapshot } from './adapters/pdfFormat.js';
+export { createEditorFormatRuntime } from './formatRuntime.js';
+export type { BuiltInDocumentFormat, EditorDocumentFormat, EditorFormatConfig, EditorFormatDefinition, EditorFormatExportContext, EditorFormatExportResult, EditorFormatImportContext, EditorFormatImportResult, EditorFormatRuntime } from './formatRuntime.js';
+export { builtInFormatFidelity, getFormatFidelity } from './formatFidelity.js';
+export type { FeatureFidelityContract, FidelityFeature, FidelityFormat, FidelityLevel, FormatFidelityCapability } from './formatFidelity.js';
+export { createBuiltInFormatDefinitions } from './builtInFormatDefinitions.js';
+export type { BuiltInFormatDefinitionOptions } from './builtInFormatDefinitions.js';
+export { createDomEditorController, DomEditorController } from './editorController.js';
+export type { DomEditorControllerChange, DomEditorControllerListener, DomEditorControllerSnapshot } from './editorController.js';
+export type { DomBlockCommand } from './adapters/domBlockCommandBridge.js';
+export type { DomTableCommand } from './adapters/domTableCommandBridge.js';

package/dist/index.js

@@ -1,2 +1,12 @@
 export { ClassicEditor } from './components/ClassicEditor.js';
 export { SRTE_DEFAULT_CSS, ensureStyleSheet } from './theme.js';
+export { createReactEditorPluginRuntime } from './pluginRuntime.js';
+export { matchesPluginShortcut } from './pluginRuntime.js';
+export { createDocumentFormatRegistry, defaultDocumentFormatRegistry, DocumentFormatRegistry, exportTextDocument, getDocumentFormatAdapter, importTextDocument, roundTripTextDocument } from './adapters/documentFormats.js';
+export { DOCX_MEDIA_TYPE, exportDocxDocument, importDocxDocumentWithMammoth, smartDocumentToDocxXml } from './adapters/docxFormat.js';
+export { enhanceDocxTables, importStyledDocxDocument } from './adapters/styledDocxFormat.js';
+export { buildPdfPrintDocument, importPdfDocument, PDF_MEDIA_TYPE, printSmartDocumentAsPdf, reconstructPdfPages } from './adapters/pdfFormat.js';
+export { createEditorFormatRuntime } from './formatRuntime.js';
+export { builtInFormatFidelity, getFormatFidelity } from './formatFidelity.js';
+export { createBuiltInFormatDefinitions } from './builtInFormatDefinitions.js';
+export { createDomEditorController, DomEditorController } from './editorController.js';

package/dist/mediaProvider.d.ts

@@ -0,0 +1,39 @@
+export type MediaKind = "image" | "video" | "audio";
+export interface UploadOptions {
+    readonly signal?: AbortSignal;
+}
+export interface MediaFilters {
+    readonly mimePrefix?: string;
+    readonly tags?: readonly string[];
+    readonly hashHex?: string;
+    readonly pageSize?: number;
+}
+export interface MediaItem {
+    readonly id: string;
+    readonly url: string;
+    readonly width?: number;
+    readonly height?: number;
+    readonly sizeBytes?: number;
+    readonly mimeType?: string;
+    readonly hashHex?: string;
+    readonly createdAt?: string;
+    readonly title?: string;
+    readonly alt?: string;
+    readonly tags?: readonly string[];
+    readonly license?: {
+        readonly author?: string;
+        readonly licenseType?: string;
+        readonly licenseText?: string;
+        readonly sourceUrl?: string;
+        readonly workName?: string;
+    };
+}
+/** Host-owned media boundary. The editor never receives storage credentials. */
+export interface MediaProvider {
+    upload(file: File, opts?: UploadOptions): Promise<{
+        url: string;
+        id: string;
+    }>;
+    search(query: string, filters?: MediaFilters, page?: number): Promise<MediaItem[]>;
+    remove(id: string): Promise<void>;
+}

package/dist/mediaProvider.js

@@ -0,0 +1 @@
+export {};

package/dist/pluginRuntime.d.ts

@@ -0,0 +1,68 @@
+import { type CoreFeatureConfig, type CoreFeatureId, type SmartRtePlugin } from "smartrte-core";
+import type { ReactNode } from "react";
+import type { EditorFormatDefinition } from "./formatRuntime.js";
+export type ReactEditorFeatureConfig = CoreFeatureConfig;
+export interface ReactCommandContributionContext {
+    root: HTMLElement | null;
+    selection: Selection | null;
+    readOnly: boolean;
+    canExecute: (commandId: string, input?: unknown) => boolean;
+}
+export interface ReactCommandContribution {
+    id: string;
+    commandId: string;
+    input?: unknown;
+    order?: number;
+    isVisible?: (context: ReactCommandContributionContext) => boolean;
+    isEnabled?: (context: ReactCommandContributionContext) => boolean;
+    isActive?: (context: ReactCommandContributionContext) => boolean;
+}
+export interface ReactToolbarContribution extends ReactCommandContribution {
+    label: string;
+    title?: string;
+    placement?: "main" | "insert" | "more";
+    icon?: ReactNode;
+}
+export interface ReactKeyboardShortcutContribution extends ReactCommandContribution {
+    key: string;
+    primary?: boolean;
+    alt?: boolean;
+    shift?: boolean;
+}
+export interface ReactContextMenuContext {
+    root: HTMLElement;
+    target: HTMLElement;
+    selection: Selection | null;
+}
+export interface ReactContextMenuContribution extends ReactCommandContribution {
+    label: string;
+    when?: (context: ReactContextMenuContext) => boolean;
+}
+export interface ReactPluginUi {
+    toolbar?: readonly ReactToolbarContribution[];
+    shortcuts?: readonly ReactKeyboardShortcutContribution[];
+    contextMenu?: readonly ReactContextMenuContribution[];
+    formats?: readonly EditorFormatDefinition[];
+}
+export type ReactEditorPlugin = SmartRtePlugin & {
+    react?: ReactPluginUi;
+};
+export interface ReactEditorPluginRuntime {
+    plugins: readonly SmartRtePlugin[];
+    featureIds: ReadonlySet<CoreFeatureId>;
+    toolbar: readonly ReactToolbarContribution[];
+    shortcuts: readonly ReactKeyboardShortcutContribution[];
+    contextMenu: readonly ReactContextMenuContribution[];
+    formats: readonly EditorFormatDefinition[];
+    hasFeature: (feature: CoreFeatureId) => boolean;
+}
+/**
+ * Resolves one authoritative plugin set for both React UI availability and
+ * core command execution. Passing `plugins` creates an exact custom runtime;
+ * otherwise the standard plugin preset is filtered by `features`.
+ */
+export declare const createReactEditorPluginRuntime: (options?: {
+    features?: ReactEditorFeatureConfig;
+    plugins?: readonly ReactEditorPlugin[];
+}) => ReactEditorPluginRuntime;
+export declare const matchesPluginShortcut: (event: Pick<KeyboardEvent, "key" | "metaKey" | "ctrlKey" | "altKey" | "shiftKey">, shortcut: ReactKeyboardShortcutContribution) => boolean;

package/dist/pluginRuntime.js

@@ -0,0 +1,78 @@
+import { createCorePlugins, orderPlugins, } from "smartrte-core";
+const pluginIdByFeature = {
+    basicFormatting: "basic-formatting",
+    blockType: "block-type",
+    alignment: "alignment",
+    list: "list",
+    checklist: "checklist",
+    blockquote: "blockquote",
+    codeBlock: "code-block",
+    table: "table",
+    media: "media",
+    formula: "formula",
+    move: "move",
+};
+/**
+ * Resolves one authoritative plugin set for both React UI availability and
+ * core command execution. Passing `plugins` creates an exact custom runtime;
+ * otherwise the standard plugin preset is filtered by `features`.
+ */
+export const createReactEditorPluginRuntime = (options = {}) => {
+    const plugins = orderPlugins(options.plugins ? [...options.plugins] : createCorePlugins(options.features));
+    const pluginIds = new Set(plugins.map((plugin) => plugin.id));
+    const featureIds = new Set(Object.keys(pluginIdByFeature)
+        .filter((feature) => pluginIds.has(pluginIdByFeature[feature])));
+    const commandIds = new Set(plugins.flatMap((plugin) => Object.keys(plugin.commands || {})));
+    const contributionIds = new Set();
+    const ordered = (items) => items.map((item, index) => ({ item, index }))
+        .sort((left, right) => (left.item.order ?? 0) - (right.item.order ?? 0) || left.index - right.index)
+        .map(({ item }) => item);
+    const validateContribution = (pluginId, contribution, kind) => {
+        if (!contribution.id.trim())
+            throw new Error(`Plugin "${pluginId}" has a ${kind} contribution with an empty id.`);
+        if (contributionIds.has(contribution.id)) {
+            throw new Error(`Duplicate UI contribution id "${contribution.id}".`);
+        }
+        if (!commandIds.has(contribution.commandId)) {
+            throw new Error(`${kind} contribution "${contribution.id}" references missing command "${contribution.commandId}".`);
+        }
+        contributionIds.add(contribution.id);
+    };
+    const toolbar = ordered(plugins.flatMap((plugin) => (plugin.react?.toolbar || []).map((contribution) => {
+        validateContribution(plugin.id, contribution, "Toolbar");
+        return { ...contribution };
+    })));
+    const shortcuts = ordered(plugins.flatMap((plugin) => (plugin.react?.shortcuts || []).map((contribution) => {
+        validateContribution(plugin.id, contribution, "Shortcut");
+        if (!contribution.key.trim()) {
+            throw new Error(`Shortcut contribution "${contribution.id}" requires a key.`);
+        }
+        return { ...contribution, key: contribution.key.toLowerCase() };
+    })));
+    const contextMenu = ordered(plugins.flatMap((plugin) => (plugin.react?.contextMenu || []).map((contribution) => {
+        validateContribution(plugin.id, contribution, "Context menu");
+        return { ...contribution };
+    })));
+    const formatIds = new Set();
+    const formats = plugins.flatMap((plugin) => (plugin.react?.formats || []).map((format) => {
+        if (!format.id.trim())
+            throw new Error(`Plugin "${plugin.id}" has a format with an empty id.`);
+        if (formatIds.has(format.id))
+            throw new Error(`Duplicate plugin format "${format.id}".`);
+        formatIds.add(format.id);
+        return format;
+    }));
+    return {
+        plugins,
+        featureIds,
+        toolbar,
+        shortcuts,
+        contextMenu,
+        formats,
+        hasFeature: (feature) => featureIds.has(feature),
+    };
+};
+export const matchesPluginShortcut = (event, shortcut) => event.key.toLowerCase() === shortcut.key.toLowerCase() &&
+    (shortcut.primary ? event.metaKey || event.ctrlKey : !event.metaKey && !event.ctrlKey) &&
+    event.altKey === Boolean(shortcut.alt) &&
+    event.shiftKey === Boolean(shortcut.shift);