@pretextbook/web-editor 0.14.0 → 0.15.0

package/dist/components/AssetManagerModal.d.ts

@@ -21,12 +21,12 @@ export interface AssetManagerModalProps {
      * takes over from this asset (handled by `onReplaceAsset`).
      */
     replaceTarget?: Asset | null;
-    onLoadAssets?: () => Promise<Asset[]>;
-    onLoadLibraryAssets?: () => Promise<Asset[]>;
-    /** Associate a library asset with the current project. */
-    onAddFromLibrary?: (asset: Asset) => Promise<void> | void;
-    /** Upload an image file; host returns the created asset. */
-    onUpload?: (file: File) => Promise<Asset>;
+    /**
+     * Upload an image file; host returns the created asset. `title` is the
+     * human-readable title the user entered — distinct from `file.name` — and
+     * should be persisted as the asset's title.
+     */
+    onUpload?: (file: File, title?: 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
@@ -50,12 +50,10 @@ export interface AssetManagerModalProps {
     /** Rewrite in-document `<plus:KIND ref="oldRef"/>` placeholders to `newRef`. */
     onResolveRef: (kind: AssetKind, oldRef: string, newRef: string) => void;
     /**
-     * Replace `oldAsset` with the user's chosen `newAsset`. `fromLibrary` is true
-     * when `newAsset` is an existing library asset (so it keeps its own ref and
-     * the document is re-pointed), false when freshly created (so it adopts the
-     * old asset's ref).
+     * Replace `oldAsset` with the user's freshly created `newAsset`, which adopts
+     * the old asset's ref so the document's references don't move.
      */
-    onReplaceAsset: (oldAsset: Asset, newAsset: Asset, fromLibrary: boolean) => void;
+    onReplaceAsset: (oldAsset: Asset, newAsset: Asset) => void;
 }
-declare const AssetManagerModal: ({ open, onClose, resolveTarget, replaceTarget, onLoadAssets, onLoadLibraryAssets, onAddFromLibrary, onUpload, onFetchUrl, onCreateDoenet, onRemoveAsset, onDuplicateAsset, onAssetAdded, onResolveRef, onReplaceAsset, }: AssetManagerModalProps) => import("react").JSX.Element | null;
+declare const AssetManagerModal: ({ open, onClose, resolveTarget, replaceTarget, onUpload, onFetchUrl, onCreateDoenet, onRemoveAsset, onDuplicateAsset, onAssetAdded, onResolveRef, onReplaceAsset, }: AssetManagerModalProps) => import("react").JSX.Element | null;
 export default AssetManagerModal;

package/dist/components/CodeEditor.d.ts

@@ -36,6 +36,7 @@ interface CodeEditorProps {
      * since the tag/title/xml:id aren't editable in-place.
      */
     onRequestWrapperEdit?: () => void;
+    hideAssets?: boolean;
 }
 /** Imperative handle exposed via `forwardRef` for programmatic control. */
 export interface CodeEditorHandle {

package/dist/components/CodeEditorMenu.d.ts

@@ -34,6 +34,7 @@ interface CodeEditorMenuProps {
     onOpenAssets?: () => void;
     /** Called when the user clicks "Display Full Source" to open the assembled-source modal. */
     onShowFullSource: () => void;
+    hideAssets?: boolean;
 }
 declare const CodeEditorMenu: React.FC<CodeEditorMenuProps>;
 export default CodeEditorMenu;

package/dist/components/Editors.d.ts

@@ -100,13 +100,12 @@ export interface editorProps {
      * `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.
+     * before this is called, so persistence never blocks the UI. The division
+     * arrives with **no** `id`: it is new until the host saves it through the
+     * project's nested `divisions_attributes` (no id = insert) and the server
+     * mints one, which flows back via the `divisions` prop (matched by `xmlId`).
      */
-    onDivisionAdd?: (division: Division) => Promise<string> | void;
+    onDivisionAdd?: (division: Division) => void;
     /**
      * Called when the user deletes a division via the TOC UI.
      */
@@ -127,27 +126,27 @@ export interface editorProps {
      * button and modal are hidden entirely.
      */
     projectAssets?: Asset[];
-    /**
-     * All assets available in the user's library (across all projects).
-     */
-    libraryAssets?: Asset[];
     /**
      * @deprecated Assets are no longer inserted at the cursor — adding an asset
      * now copies its embed code to the clipboard. Retained for backward
      * compatibility; it is no longer called. Use the creation hooks
-     * (`onAssetUpload`/`onAssetAddFromLibrary`/`onCreateDoenet`) to learn when an
-     * asset enters the project.
+     * (`onAssetUpload`/`onCreateDoenet`) to learn when an asset enters the
+     * project.
      */
     onAssetInsert?: (asset: Asset) => void;
-    /** Called when the user picks a library asset not yet in this project. */
-    onAssetAddFromLibrary?: (asset: Asset) => Promise<void> | void;
-    /** Called when the user uploads an image file. */
-    onAssetUpload?: (file: File) => Promise<Asset>;
+    /**
+     * Called when the user uploads an image file, or after `onAssetFetchUrl`
+     * fetches an external URL. `title` is the human-readable title the user
+     * entered in the modal (may differ from `file.name`) — persist it as the
+     * asset's title rather than deriving one from the filename.
+     */
+    onAssetUpload?: (file: File, title?: 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.
+     * `onAssetUpload`, the same as a local file pick, with the user's entered
+     * title passed as `onAssetUpload`'s second argument.
      */
     onAssetFetchUrl?: (url: string) => Promise<File>;
     /** Called when the user creates a new Doenet activity. */
@@ -156,10 +155,8 @@ export interface editorProps {
     onAssetRemove?: (asset: Asset) => void;
     /** Called when the user saves edits to an asset's content (e.g. its `source`). */
     onAssetUpdate?: (asset: Asset) => Promise<void> | void;
-    /** Called when the asset modal opens to fetch the latest project assets. */
-    onLoadAssets?: () => Promise<Asset[]>;
-    /** Called when the asset modal opens to fetch the full library asset list. */
-    onLoadLibraryAssets?: () => Promise<Asset[]>;
+    /** If true, the TOC and asset manager hide all assets. */
+    hideAssets?: boolean;
 }
 /**
  * Top-level editor component.  Creates the per-instance Zustand store and

package/dist/components/TableOfContents.d.ts

@@ -4,7 +4,9 @@ export interface TableOfContentsProps {
     onToggleCollapse: () => void;
     /** When provided, shows "Open asset picker" affordance in the TOC. */
     onOpenAssetPicker?: () => void;
+    /** If true, hides all assets in the TOC and asset manager. */
+    hideAssets?: boolean;
 }
 /** TOC sidebar. ArticleToc reads divisions data from the editor store. */
-declare const TableOfContents: ({ isCollapsed, onToggleCollapse, onOpenAssetPicker, }: TableOfContentsProps) => import("react").JSX.Element;
+declare const TableOfContents: ({ isCollapsed, onToggleCollapse, onOpenAssetPicker, hideAssets, }: TableOfContentsProps) => import("react").JSX.Element;
 export default TableOfContents;

package/dist/components/toc/ArticleToc.d.ts

@@ -1,5 +1,6 @@
 export interface ArticleTocProps {
     onOpenAssetPicker?: () => void;
+    hideAssets?: boolean;
 }
-declare const ArticleToc: ({ onOpenAssetPicker }: ArticleTocProps) => import("react").JSX.Element;
+declare const ArticleToc: ({ onOpenAssetPicker, hideAssets }: ArticleTocProps) => import("react").JSX.Element;
 export default ArticleToc;