@pretextbook/web-editor 0.14.0 → 0.15.0

package/dist/sectionUtils.d.ts

@@ -140,18 +140,18 @@ export declare function updateLatexDivisionMetadata(division: Division, changes:
  * Convert a LaTeX division's source to PreTeXt by passing the visible LaTeX
  * straight to `@pretextbook/latex-pretext` and using its output as-is.
  *
- * A content division's header (`\section{…}\label{…}`, `\worksheet{…}`, …)
- * converts to its own complete `<type xml:id="…"><title>…>` element, so the
- * conversion is used exactly as produced — if a header doesn't convert
- * correctly, that surfaces here to be fixed in the converter rather than worked
- * around. Root divisions (`book`/`article`/`slideshow`) hold a whole document
- * body that converts to a sequence of elements, so it is wrapped in the root
- * element (whose title/`xml:id` aren't expressed in the LaTeX body).
+ * A division's header (`\section{…}\label{…}`, `\worksheet{…}`, … — and, for a
+ * root division, `\article{…}`/`\book{…}`/`\slideshow{…}`) converts to its own
+ * complete `<type xml:id="…"><title>…>` element, so the conversion is used
+ * exactly as produced with no extra wrapper added here — doing so would nest a
+ * second `<article>`/`<book>`/`<slideshow>` around the one the converter
+ * already emitted from the header. If a header doesn't convert correctly,
+ * that surfaces here to be fixed in the converter rather than worked around.
  *
  * Returns `null` when the conversion fails, so callers can disable the convert
  * action / fall back.
  */
-export declare function latexDivisionToTaggedPretext(division: Pick<Division, "source" | "type" | "xmlId" | "title">): string | null;
+export declare function latexDivisionToTaggedPretext(division: Pick<Division, "source">): string | null;
 /** Create a new blank LaTeX section as a `Division`. */
 export declare function createNewLatexSection(title?: string): DocumentSection;
 /** Create a blank LaTeX introduction. */

package/dist/store/editorStore.d.ts

@@ -30,7 +30,6 @@ import type { Asset, AssetKind, FeedbackSubmission, SourceFormat } from "../type
 import type { Division, DivisionType } from "../types/sections";
 import type { EditDraft } from "../components/toc/types";
 export type DivisionChanges = {
-    id?: string;
     title?: string;
     type?: DivisionType;
     xmlId?: string | null;
@@ -93,12 +92,6 @@ export interface EditorStoreState {
      * it's added, without waiting for the host to echo it back.
      */
     projectAssets: Asset[] | undefined;
-    /**
-     * The user's cross-project asset library. Unlike `projectAssets` this stays a
-     * host-owned, fetch-on-demand cache (loaded via `onLoadLibraryAssets`), so it
-     * is still mirrored from props every render via `syncState`.
-     */
-    libraryAssets: Asset[] | undefined;
     title: string;
     docinfo: string;
     commonDocinfo: string;
@@ -196,13 +189,6 @@ export interface EditorStoreState {
     removeAssetRefFromDocument: (kind: AssetKind, ref: string) => void;
     /** Duplicate a project asset under a fresh ref. Resolves when the host settles. */
     duplicateAsset: (asset: Asset) => Promise<void>;
-    /**
-     * Replace the whole project-asset pool — e.g. after `onLoadAssets` resolves
-     * with the server's fresh list. The server is authoritative at that point,
-     * so this overwrites the pool wholesale (matching how the divisions pool is
-     * reset on an external update).
-     */
-    setProjectAssets: (assets: Asset[]) => void;
     /**
      * Optimistically add an asset to the pool (no-op if one with the same
      * kind+ref already exists). Used when an asset is uploaded, created, added
@@ -227,7 +213,7 @@ export interface EditorStoreState {
     feedbackSubmit: (feedback: FeedbackSubmission) => void;
 }
 /** The subset of EditorStoreState that Editors.tsx syncs on each render. */
-export type EditorSyncableState = Pick<EditorStoreState, "source" | "sourceFormat" | "libraryAssets" | "title" | "docinfo" | "commonDocinfo" | "useCommonDocinfo" | "projectType" | "projectUrl" | "divisions" | "rootDivisionId" | "activeDivisionId" | "canConvertToPretext" | "activeEditorSource" | "hasFeedback" | "hasAssetDuplicate">;
+export type EditorSyncableState = Pick<EditorStoreState, "source" | "sourceFormat" | "title" | "docinfo" | "commonDocinfo" | "useCommonDocinfo" | "projectType" | "projectUrl" | "divisions" | "rootDivisionId" | "activeDivisionId" | "canConvertToPretext" | "activeEditorSource" | "hasFeedback" | "hasAssetDuplicate">;
 export interface EditorStoreInit {
     source: string;
     sourceFormat: SourceFormat;

package/dist/types/editor.d.ts

@@ -2,10 +2,17 @@
 export type SourceFormat = "pretext" | "latex" | "markdown";
 /** The kind of a project asset — determines the inserted PreTeXt tag. */
 export type AssetKind = "image" | "doenet";
-/** An asset stored in the project asset library. */
+/** An asset owned by a single project. */
 export interface Asset {
-    /** Stable server-assigned identifier (hidden from users). */
-    id: string;
+    /**
+     * Stable server-assigned identifier (hidden from users). Assets are
+     * persisted through the project's nested `assets_attributes`, so a
+     * freshly-created asset has **no** `id` until the project is saved and the
+     * server mints one — the *absence* of an `id` is the signal that an asset is
+     * new. The editor keys asset identity on `kind` + `ref` (never `id`), so an
+     * id-less asset is fully usable the instant it's added.
+     */
+    id?: string;
     /** Human-readable display title shown in the library UI. */
     title: string;
     /** Short reference used when authoring references, e.g. `"euler-painting"`.

package/dist/types/sections.d.ts

@@ -29,8 +29,15 @@ export type DivisionType = "book" | "article" | "slideshow" | "part" | "chapter"
  * the editor.
  */
 export interface Division {
-    /** Stable server-assigned identifier (Rails record id or UUID). */
-    id: string;
+    /**
+     * Stable server-assigned identifier. Divisions are persisted through the
+     * project's nested `divisions_attributes`, so a freshly-created division has
+     * **no** `id` until the project is saved and the server mints one — the
+     * *absence* of an `id` is the signal that a division is new. The editor keys
+     * division identity on `xmlId` (never `id`), so an id-less division is fully
+     * usable the instant it's added.
+     */
+    id?: string;
     /**
      * The `xml:id` attribute value for this division.  Used as the `ref`
      * value in `<plus:division ref="..."/>` placeholders in parent divisions.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pretextbook/web-editor",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "private": false,
   "description": "A web-based editor for PreTeXt documents, with simple preview functionality",
   "keywords": [