@pretextbook/web-editor 0.12.0 → 0.13.0

package/dist/sectionUtils.d.ts

@@ -306,8 +306,12 @@ export declare function canEmbedDivisionRefs(sourceFormat: SourceFormat): boolea
  *
  * Only direct children are returned — the function does not recurse.
  * Call it for each division in the pool to build the full tree.
+ *
+ * `sourceFormat` is the parent division's format: only that format's include
+ * syntax is scanned, and its verbatim spans are blanked first, so example
+ * placeholders in code samples don't become phantom children.
  */
-export declare function parseDivisionRefs(content: string): string[];
+export declare function parseDivisionRefs(content: string, sourceFormat: SourceFormat): string[];
 /**
  * Like {@link parseDivisionRefs} but also returns the division type inferred
  * from the tag name (e.g. `<plus:chapter ref="x"/>` → `{ type: "chapter", xmlId: "x" }`).
@@ -318,7 +322,7 @@ export declare function parseDivisionRefs(content: string): string[];
  * skipped. The generic `<plus:division ref="x"/>` alias falls back to type
  * `"section"`, matching {@link tagToType}'s default for unrecognised tags.
  */
-export declare function parseDivisionRefsWithTypes(content: string): {
+export declare function parseDivisionRefsWithTypes(content: string, sourceFormat: SourceFormat): {
     xmlId: string;
     type: DivisionType;
 }[];
@@ -340,7 +344,7 @@ export interface AssetRef {
  * disjoint tag set (`image`/`doenet`) so the two kinds of include are never
  * conflated.
  */
-export declare function parseAssetRefs(content: string): AssetRef[];
+export declare function parseAssetRefs(content: string, sourceFormat: SourceFormat): AssetRef[];
 /**
  * Rewrite every asset placeholder for `oldRef` in `content` to use `newRef`
  * instead, leaving any other attributes (e.g. `width="50%"`) untouched. The

package/dist/types/editor.d.ts

@@ -26,28 +26,29 @@ export interface Asset {
     /**
      * Whether this asset is backed by an uploaded/fetched file rather than
      * being defined purely by `source`. File-based image assets emit a
-     * `source` attribute on the generated `<image>` element (from
-     * {@link fileRef}, falling back to {@link url}); non-file image assets
-     * carry no `source` attribute and rely entirely on their authored
+     * `source` attribute on the generated `<image>` element built from this
+     * asset's {@link ref} plus a file extension (e.g. `ref="euler-painting"`
+     * with a PNG upload emits `source="euler-painting.png"`); non-file image
+     * assets carry no `source` attribute and rely entirely on their authored
      * `source` content.
      */
     isFile?: boolean;
     /**
-     * Publicly accessible URL used **only** as the asset-manager thumbnail
-     * (`<img src={url}>`). It is no longer the value written to the `<image>`
-     * `source` attribute — use {@link fileRef} for that. It remains the
-     * `source` fallback when `fileRef` is absent, for backwards compatibility.
+     * Publicly accessible URL used as the asset-manager thumbnail
+     * (`<img src={url}>`). Its filename extension (if any) is also used, as a
+     * fallback after {@link fileRef}, to determine the extension appended to
+     * `ref` for the generated `<image source="...">` attribute. The URL itself
+     * (e.g. a UUID-based storage key) is never written into the document.
      */
     url?: string;
     /**
-     * The exact string emitted as the `source` attribute of the generated
-     * `<image>` element for a file-backed asset — typically a bare external
-     * filename like `"euler-painting.png"`. The PreTeXt build server treats
-     * `<image source="X">` as an external-asset filename and prepends
-     * `external/` itself, so this must be a bare filename, not a URL.
+     * The server-assigned storage filename for a file-backed asset (e.g. a
+     * UUID-based key). Its extension, if present, is used to build the
+     * `source` attribute of the generated `<image>` element as
+     * `"{ref}.{extension}"` — the rest of this value (e.g. the UUID itself)
+     * is never written into the document.
      *
-     * Only meaningful when {@link isFile} is true. When absent, the emit sites
-     * fall back to {@link url} so existing hosts keep working unchanged.
+     * Only meaningful when {@link isFile} is true.
      */
     fileRef?: string;
     /** Mime type for the asset, if applicable.  Used for hints only. */

package/package.json

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