@pretextbook/web-editor 0.5.4 → 0.6.0

package/dist/components/AssetManagerModal.d.ts

@@ -12,12 +12,17 @@ export interface AssetManagerModalProps {
     onAddFromLibrary?: (asset: Asset) => Promise<void> | void;
     /** Upload an image file; host returns the created asset. */
     onUpload?: (file: File) => Promise<Asset>;
-    /** Add an image from a URL; host downloads and returns the created asset. */
-    onAddUrl?: (url: string, name: string) => Promise<Asset>;
+    /**
+     * Fetch an external URL on the user's behalf (server-side, to avoid CORS)
+     * and return the raw file bytes. Must not create a persisted asset — the
+     * returned file is then committed via `onUpload`, the same as a local
+     * file pick, so there is a single code path that creates project assets.
+     */
+    onFetchUrl?: (url: string) => Promise<File>;
     /** Create a new Doenet activity; host returns the created asset. */
     onCreateDoenet?: (name: string, ref: string) => Promise<Asset>;
     /** Remove an asset from the project. */
     onRemoveAsset?: (asset: Asset) => void;
 }
-declare const AssetManagerModal: ({ open, onClose, onLoadAssets, onLoadLibraryAssets, onInsert, onAddFromLibrary, onUpload, onAddUrl, onCreateDoenet, onRemoveAsset, }: AssetManagerModalProps) => import("react").JSX.Element | null;
+declare const AssetManagerModal: ({ open, onClose, onLoadAssets, onLoadLibraryAssets, onInsert, onAddFromLibrary, onUpload, onFetchUrl, onCreateDoenet, onRemoveAsset, }: AssetManagerModalProps) => import("react").JSX.Element | null;
 export default AssetManagerModal;

package/dist/components/Editors.d.ts

@@ -94,9 +94,19 @@ export interface editorProps {
      */
     onDivisionSelect?: (xmlId: string) => void;
     /**
-     * Called when the user creates a new division via the TOC UI.
+     * Called when the user creates a new division via the TOC UI (including
+     * an auto-create triggered by typing a new `<plus:TYPE ref="..."/>`
+     * placeholder). `division` is the full local record — including the
+     * `xmlId` the editor picked — and should be persisted as-is.
+     *
+     * The division is added to the local pool synchronously and immediately,
+     * before this is called, so the host's `id` provisioning never blocks the
+     * UI. If a host needs to mint its own stable `id` (e.g. a Rails record
+     * id) for the division, it can return that id here; once the returned
+     * promise resolves, the editor patches it into the division's `id` field
+     * in place. `xmlId` is unaffected and is never remapped.
      */
-    onDivisionAdd?: (division: Division) => void;
+    onDivisionAdd?: (division: Division) => Promise<string> | void;
     /**
      * Called when the user deletes a division via the TOC UI.
      */
@@ -127,8 +137,13 @@ export interface editorProps {
     onAssetAddFromLibrary?: (asset: Asset) => Promise<void> | void;
     /** Called when the user uploads an image file. */
     onAssetUpload?: (file: File) => Promise<Asset>;
-    /** Called when the user adds an image by URL. */
-    onAssetAddUrl?: (url: string, name: string) => Promise<Asset>;
+    /**
+     * Called when the user adds an image by URL. Should fetch the URL
+     * server-side (to avoid CORS) and return the raw file bytes — it must
+     * NOT create a persisted asset. The returned file is then committed via
+     * `onAssetUpload`, the same as a local file pick.
+     */
+    onAssetFetchUrl?: (url: string) => Promise<File>;
     /** Called when the user creates a new Doenet activity. */
     onCreateDoenet?: (name: string, ref: string) => Promise<Asset>;
     /** Called when the user removes an asset from the project. */