pptx-angular-viewer 1.1.61 → 1.1.63

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to this project are documented here.
 This file is generated from [Conventional Commits](https://www.conventionalcommits.org)
 by [git-cliff](https://git-cliff.org); do not edit it by hand.
 
+## [1.1.62](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-angular-viewer@1.1.62) - 2026-07-03
+
+### Documentation
+
+- **vue,angular:** Correct stale parity-tracker claims (by @ChristopherVR) ([54c4f05](https://github.com/ChristopherVR/pptx-viewer/commit/54c4f0540e33692d82f961c96d8a1818c8678751))
+
 ## [1.1.59](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-angular-viewer@1.1.59) - 2026-07-03
 
 ### Features

package/README.md

@@ -194,8 +194,7 @@ polish/cosmetic, not behavioural gaps:
   image otherwise (the same as the React package).
 
 The `pptx-viewer-core` engine parses all element data, so you can access it from
-the model even where the UI does not expose it yet. Progress and design notes live
-in [`PORTING.md`](./PORTING.md).
+the model even where the UI does not expose it yet.
 
 ## Build (contributing)
 

package/fesm2022/pptx-angular-viewer.mjs

@@ -4946,15 +4946,15 @@ function convertOmmlToLatex(omml) {
 }
 
 /**
- * Framework-agnostic chart helpers — a focused Vue port of the React package's
+ * Framework-agnostic chart helpers, a focused Vue port of the React package's
  * `viewer/utils/chart-helpers.ts`, `chart-layout.ts`, and
  * `chart-style-palettes.ts`.
  *
- * Only the pieces the common-type renderers (bar / column / stacked / line /
- * area / pie / doughnut) and the shared chrome need are ported here. Advanced
- * features (log axes, secondary axes, display units, data tables, overlays)
- * are intentionally omitted — see the `// TODO(vue):` markers in
- * `ChartRenderer.vue`.
+ * This module only covers the common-type renderers (bar / column / stacked /
+ * line / area / pie / doughnut) and the shared chrome. Advanced axis/overlay
+ * features (log axes, secondary axes, display units, trendlines, error bars,
+ * data tables) live in `chart-axis.ts` / `chart-axis-render.ts` /
+ * `chart-cartesian.ts` and are consumed via `chart/ChartViewModelSvg.vue`.
  *
  * These small pure helpers are an extraction candidate: long-term they (and
  * their React counterparts) should live in a shared, framework-agnostic
@@ -21862,7 +21862,7 @@ function connectorBendFraction(element) {
  * for straight connectors (which render as a `<line>`). Endpoints are already
  * flip-adjusted by the caller.
  *
- * Viewer-first approximation (full A* routing is a TODO, see PORTING.md):
+ * Viewer-first approximation (full A* routing is a TODO):
  *  - **bent**: orthogonal elbow polyline. `bentConnector2` is a single L-bend;
  *    `bentConnector3..5` route through a vertical mid-axis at `bend`.
  *  - **curved**: `curvedConnector2` is a quadratic Bezier; `curvedConnector3..5`
@@ -22992,6 +22992,164 @@ function observeYDocSlides(ydoc, onChange) {
     return () => arr.unobserveDeep(onChange);
 }
 
+/**
+ * collaboration-text-merge.ts: character-level in-place merging of a desired
+ * text state into a live Y.Text.
+ *
+ * `reconcileTextBody` used to replace the whole Y.Text whenever the canonical
+ * decoded form differed, which made concurrent edits to the SAME text element
+ * collide at element granularity (last writer wins). This module instead
+ * applies a minimal edit script to the existing Y.Text:
+ *
+ *  - plain-text diff via common prefix/suffix (surrogate-pair safe): one
+ *    delete + attributed inserts for the changed middle span
+ *  - attribute reconcile: walk the current and desired attribute runs by
+ *    position and `format()` only the ranges whose attributes differ
+ *
+ * Because each peer submits a minimal delta, Yjs merges concurrent edits to
+ * the same run at character granularity (e.g. one peer prepends while another
+ * appends, both survive).
+ */
+function isYTextEditable(value) {
+    return (isYTextLike(value) &&
+        typeof value.delete === 'function' &&
+        typeof value.format === 'function');
+}
+const isHighSurrogate = (code) => code >= 0xd800 && code <= 0xdbff;
+const isLowSurrogate = (code) => code >= 0xdc00 && code <= 0xdfff;
+function opsText(ops) {
+    let text = '';
+    for (const op of ops) {
+        if (typeof op.insert === 'string') {
+            text += op.insert;
+        }
+    }
+    return text;
+}
+function commonPrefixLength(a, b) {
+    const max = Math.min(a.length, b.length);
+    let i = 0;
+    while (i < max && a.charCodeAt(i) === b.charCodeAt(i)) {
+        i++;
+    }
+    // Never cut between a surrogate pair.
+    if (i > 0 && isHighSurrogate(a.charCodeAt(i - 1))) {
+        i--;
+    }
+    return i;
+}
+function commonSuffixLength(a, b, prefix) {
+    const max = Math.min(a.length, b.length) - prefix;
+    let i = 0;
+    while (i < max && a.charCodeAt(a.length - i - 1) === b.charCodeAt(b.length - i - 1)) {
+        i++;
+    }
+    if (i > 0 && isLowSurrogate(a.charCodeAt(a.length - i))) {
+        i--;
+    }
+    return i;
+}
+/**
+ * Insert the desired-text span [from, to) into `ytext`, carrying each desired
+ * op's attributes so no character inherits formatting from its neighbour.
+ */
+function insertSpanWithAttrs(ytext, desiredOps, from, to) {
+    let opStart = 0;
+    let index = from;
+    for (const op of desiredOps) {
+        if (typeof op.insert !== 'string') {
+            continue;
+        }
+        const opEnd = opStart + op.insert.length;
+        const start = Math.max(opStart, from);
+        const end = Math.min(opEnd, to);
+        if (start < end) {
+            const chunk = op.insert.slice(start - opStart, end - opStart);
+            // Explicit attrs always: attribute-less inserts inherit the previous
+            // character's formatting in Yjs (the style-bleed bug).
+            ytext.insert(index, chunk, (op.attributes ?? {}));
+            index += chunk.length;
+        }
+        opStart = opEnd;
+    }
+}
+function attrsEqual(a, b) {
+    const aKeys = Object.keys(a);
+    if (aKeys.length !== Object.keys(b).length) {
+        return false;
+    }
+    return aKeys.every((k) => a[k] === b[k]);
+}
+/**
+ * Bring the attribute runs of `ytext` (whose plain text already matches the
+ * desired ops) in line with the desired attributes, formatting only the
+ * ranges that differ.
+ */
+function reconcileAttributeRuns(ytext, desiredOps) {
+    const currentOps = ytext.toDelta().filter((op) => typeof op.insert === 'string');
+    let ci = 0;
+    let cOff = 0;
+    let pos = 0;
+    for (const dop of desiredOps) {
+        if (typeof dop.insert !== 'string') {
+            continue;
+        }
+        const dAttrs = (dop.attributes ?? {});
+        let remaining = dop.insert.length;
+        while (remaining > 0 && ci < currentOps.length) {
+            const cText = currentOps[ci].insert;
+            const len = Math.min(cText.length - cOff, remaining);
+            const cAttrs = (currentOps[ci].attributes ?? {});
+            if (!attrsEqual(cAttrs, dAttrs)) {
+                const patch = {};
+                for (const key of Object.keys(dAttrs)) {
+                    if (cAttrs[key] !== dAttrs[key]) {
+                        patch[key] = dAttrs[key];
+                    }
+                }
+                for (const key of Object.keys(cAttrs)) {
+                    if (!(key in dAttrs)) {
+                        patch[key] = null;
+                    }
+                }
+                ytext.format(pos, len, patch);
+            }
+            pos += len;
+            remaining -= len;
+            cOff += len;
+            if (cOff >= cText.length) {
+                ci++;
+                cOff = 0;
+            }
+        }
+    }
+}
+/**
+ * Apply the minimal edit script that turns the live `ytext` into the state
+ * described by `desiredOps`. Returns false (leaving the caller to fall back
+ * to wholesale replacement) if the text diff did not converge.
+ *
+ * Must be called inside a Y.Doc transaction when the text is integrated.
+ */
+function mergeDeltaIntoYText(ytext, desiredOps) {
+    const currentText = opsText(ytext.toDelta());
+    const desiredText = opsText(desiredOps);
+    if (currentText !== desiredText) {
+        const prefix = commonPrefixLength(currentText, desiredText);
+        const suffix = commonSuffixLength(currentText, desiredText, prefix);
+        const deleteLen = currentText.length - prefix - suffix;
+        if (deleteLen > 0) {
+            ytext.delete(prefix, deleteLen);
+        }
+        insertSpanWithAttrs(ytext, desiredOps, prefix, desiredText.length - suffix);
+        if (opsText(ytext.toDelta()) !== desiredText) {
+            return false;
+        }
+    }
+    reconcileAttributeRuns(ytext, desiredOps);
+    return true;
+}
+
 /**
  * collaboration-reconcile.ts: Granular Y.Doc reconciliation for collaborative
  * editing.
@@ -23004,7 +23162,9 @@ function observeYDocSlides(ydoc, onChange) {
  *  - slides and elements are matched by `id`; unchanged ones keep their Y.Map
  *    instance so concurrent field edits merge via Yjs
  *  - scalar / complex fields are compared and only set when different
- *  - textBody is only replaced when its canonical decoded form differs
+ *  - textBody is edited in place (minimal char-level diff via
+ *    collaboration-text-merge.ts) when its canonical decoded form differs;
+ *    wholesale replacement is only a fallback
  *  - removed items are deleted, new ones inserted at their position; moves
  *    are delete+reinsert (Yjs has no move primitive)
  *
@@ -23053,11 +23213,17 @@ function reconcileTextBody(ymap, rec, factories) {
         }
         return;
     }
-    const desired = decodeDelta(encodeSegmentsToDelta(segments));
+    const desiredDelta = encodeSegmentsToDelta(segments);
+    const desired = decodeDelta(desiredDelta);
     const existing = isYTextLike(current) ? decodeDelta(current.toDelta()) : undefined;
     if (existing !== undefined && jsonEqual(existing, desired)) {
         return;
     }
+    // Prefer an in-place minimal edit so concurrent edits to the same text
+    // element merge at character granularity instead of element-level LWW.
+    if (isYTextEditable(current) && mergeDeltaIntoYText(current, desiredDelta)) {
+        return;
+    }
     const ytext = factories.createText();
     encodeTextBody(segments, ytext);
     ymap.set('textBody', ytext);
@@ -34423,10 +34589,9 @@ function segmentFrameCount(durationMs, fps) {
  *   - loader:    load-pipeline helpers (media/image collection, guides).
  *   - types:     CanvasSize, CollaborationConfig, CollaborationRole.
  *   - constants: scalar viewer defaults (canvas size, fallback colours).
- *
- * Roadmap (see packages/angular/PORTING.md and packages/vue/PORTING.md):
- *   color resolution, geometry/clip-paths, connector routing, animation
- *   timeline engine, table-merge math, morph matching, export data helpers.
+ *   - render:    the bulk of the shared logic (colour/geometry/connector/
+ *                animation/table/chart/text/effects/collaboration/i18n).
+ *   - export:    export data helpers.
  */
 
 /**
@@ -39301,10 +39466,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.5", ngImpor
  * Provide it at the component level so its lifetime tracks the host viewer:
  * `@Component({ providers: [LoadContentService] })`.
  *
- * This is the viewer-first subset; the React hook also populated ~25 extra
- * pieces of presentation metadata (sections, custom shows, embedded fonts,
- * digital signatures, …). Those are tracked in PORTING.md and added here as
- * the corresponding features are ported.
+ * Originally the viewer-first subset of the React hook; the extra pieces of
+ * presentation metadata (sections, custom shows, embedded fonts, digital
+ * signatures, …) were added alongside the corresponding features.
  */
 class LoadContentService {
     /** Parsed slides (with image Blob URLs patched in). */
@@ -40715,7 +40879,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.5", ngImpor
  * building the SmartArt element payload from a chosen preset, hierarchy
  * parenting) is delegated to the pure functions below so they can be unit-tested
  * in plain vitest (the Angular package's vitest setup has no Angular compiler,
- * so component / TestBed tests are not available - see PORTING.md).
+ * so component / TestBed tests are not available).
  *
  * The preset catalogue itself is the framework-agnostic, vendored
  * `pptx-viewer-shared` source of truth (`render/smart-art-presets`), consumed
@@ -46514,7 +46678,7 @@ function describeSmartArtBounds(layout) {
  * `editor-insert.ts` (sourced from `pptx-viewer-core`). Keeping this logic out of
  * the component lets it be unit-tested in plain vitest (the Angular package's
  * vitest setup has no Angular compiler, so TestBed component tests are not
- * available - see PORTING.md).
+ * available).
  *
  * Mirrors the React inspector:
  *   packages/react/src/viewer/components/inspector/SmartArtPropertiesPanel.tsx
@@ -52203,7 +52367,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.5", ngImpor
  * Compound (double/triple) lines render as parallel strands and line caps map
  * from `a:ln/@cap`; both derive from the shared connector geometry.
  *
- * Not yet ported (TODO, see PORTING.md): line shadows/glow.
+ * Not yet ported (TODO): line shadows/glow.
  */
 class ConnectorRendererComponent {
     element = input.required(/* @ts-ignore */
@@ -52630,7 +52794,8 @@ function buildDuotoneFilter(element) {
  * and paint text boxes, basic preset shapes, images, and image/gradient fills
  * (the latter via the parser's prebuilt CSS gradient string). Advanced visuals
  * (the structured gradient builder, pattern fills, custom geometry clip-paths,
- * shadows, 3D, image effects, text warp) are tracked in PORTING.md.
+ * shadows, 3D, image effects, text warp) are handled by the shared render
+ * modules (`pptx-viewer-shared`) consumed from the renderer components.
  *
  * Long term the *logic* here is a shared-extraction candidate; only the
  * return type (CSS map shape) differs per framework, so a future refactor
@@ -53068,7 +53233,7 @@ function buildInkContainerStyle(element, zIndex) {
  * radii follow the per-point pressure, matching React's `renderInk`. Strokes
  * without pressure variation degrade to a plain constant-width `<path>`.
  *
- * Not ported (TODO, see PORTING.md): ink replay animation and the
+ * Not ported (TODO): ink replay animation and the
  * highlighter/eraser tool blend modes.
  *
  * All non-trivial pure computation lives in `ink-renderer-helpers.ts` (no
@@ -54463,7 +54628,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.5", ngImpor
  * its text directly on the diagram. Everything that can be expressed as a pure
  * function lives here so it can be unit-tested in plain vitest (the Angular
  * package's vitest setup has no Angular compiler, so component/TestBed tests are
- * not available - see PORTING.md). The component
+ * not available). The component
  * (`smart-art-renderer.component.ts`) stays thin: it owns only the edit-state
  * signal, the positioned `<textarea>`, and the call into the existing commit
  * path (`EditorStateService.updateElement`, the same channel the inspector's
@@ -57128,8 +57293,7 @@ function runStyleFromSegment(seg) {
  * ElementRendererComponent: Angular port of the React `ElementRenderer.tsx`
  * and the Vue `ElementRenderer.vue`.
  *
- * Renders a single slide element by its `type` discriminant (viewer-first
- * subset):
+ * Renders a single slide element by its `type` discriminant:
  *  - `text` / `shape`    → positioned box with fill/stroke + rich text + effects
  *  - `connector`         → SVG straight/bent/curved connector
  *  - `chart`             → inline-SVG chart (bar/line/area/pie/scatter)
@@ -57137,14 +57301,13 @@ function runStyleFromSegment(seg) {
  *  - `smartArt`          → SVG drawing-shapes / node-text fallback
  *  - `ink`               → SVG ink strokes
  *  - `ole`               → embedded-object preview / icon
- *  - `model3d`           → poster / placeholder (no three.js)
+ *  - `model3d`           → interactive three.js scene when the optional
+ *                          `three` peer is present, else poster / placeholder
  *  - `zoom`              → slide/section zoom thumbnail
  *  - `picture` / `image` → `<img>`
  *  - `media`             → native `<video>`/`<audio>` playback, poster fallback
  *  - `group`             → recursive children (self-referencing selector)
- *  - everything else     → labelled placeholder (TODO, see PORTING.md)
- *
- * Interaction (selection, resize, inline editing) is not yet ported.
+ *  - everything else     → labelled placeholder (defensive fallback)
  */
 class ElementRendererComponent {
     element = input.required(/* @ts-ignore */
@@ -58030,8 +58193,8 @@ function plainText(el) {
  * Renders the active slide as a fixed-size stage scaled by `zoom`, with each
  * element absolutely positioned. When `editable`, supports click-to-select
  * (event delegation), selection outlines, and pointer drag-to-move / resize
- * handles. Rulers, grid, guides, marquee, and collaboration overlays are
- * tracked in PORTING.md.
+ * handles, plus the rulers, grid, guides, marquee, and collaboration
+ * overlays.
  */
 class SlideCanvasComponent {
     slide = input(undefined, /* @ts-ignore */
@@ -71265,7 +71428,6 @@ const GRID_GAP = 16;
  * Escape or clicking the ✕ button emits `closed`.
  *
  * Viewer-first scope: no drag-reorder, no context menu, no section grouping.
- * Those features are tracked in PORTING.md.
  *
  * Usage:
  * ```html
@@ -76833,10 +76995,9 @@ const ZOOM_MAX = 3;
  * and Vue `PowerPointViewer.vue`.
  *
  * Top-level orchestrator that loads `.pptx` bytes and renders the slides with
- * navigation and zoom. This is the viewer-first milestone of the port: the
- * React component additionally composes a full editor (toolbar, inspector
- * panels, dialogs, presentation mode, collaboration, export). The roadmap and
- * per-area status live in `packages/angular/PORTING.md`.
+ * navigation and zoom, composing the full editor (toolbar, inspector panels,
+ * dialogs, presentation mode, collaboration, export) like its React and Vue
+ * counterparts.
  *
  * Conventions vs. React/Vue:
  *  - React `forwardRef` handle / Vue `defineExpose` → public {@link getContent}
@@ -80258,6 +80419,8 @@ const translationsEn = {
     'pptx.inspector.fill': 'Fill',
     'pptx.inspector.line': 'Line',
     'pptx.inspector.effects': 'Effects',
+    'pptx.inspector.softEdge': 'Soft Edge',
+    'pptx.inspector.softEdgeRadius': 'Soft Edge Radius',
     'pptx.arrange.positionSize': 'Position & Size',
     'pptx.arrange.lockElement': 'Lock element',
     'pptx.arrange.unlockElement': 'Unlock element',
@@ -80279,6 +80442,9 @@ const translationsEn = {
     'pptx.media.trimEndTime': 'End (mm:ss)',
     'pptx.media.trimmedDuration': 'Trimmed duration',
     'pptx.media.resetTrim': 'Reset trim',
+    'pptx.media.trimErrorNegative': 'Trim times cannot be negative.',
+    'pptx.media.trimErrorStartAfterEnd': 'Trim start must be before trim end.',
+    'pptx.media.trimErrorBeyondDuration': 'Trim times cannot exceed the clip duration.',
     'pptx.media.playback': 'Playback',
     'pptx.media.volume': 'Volume',
     'pptx.media.speed': 'Speed',
@@ -81513,13 +81679,18 @@ const translationsEn = {
     'pptx.documentProperties.custom.typeNumber': 'Number',
     'pptx.documentProperties.custom.typeText': 'Text',
     'pptx.documentProperties.custom.typeYesNo': 'Yes or No',
+    'pptx.documentProperties.statistics.application': 'Application',
+    'pptx.documentProperties.statistics.appVersion': 'Application Version',
     'pptx.documentProperties.statistics.elements': 'Elements',
     'pptx.documentProperties.statistics.hiddenSlides': 'Hidden Slides',
     'pptx.documentProperties.statistics.lastModifiedBy': 'Last Modified By',
     'pptx.documentProperties.statistics.notes': 'Notes',
     'pptx.documentProperties.statistics.paragraphs': 'Paragraphs',
+    'pptx.documentProperties.statistics.presentationFormat': 'Presentation Format',
     'pptx.documentProperties.statistics.revision': 'Revision',
     'pptx.documentProperties.statistics.slides': 'Slides',
+    'pptx.documentProperties.statistics.template': 'Template',
+    'pptx.documentProperties.statistics.totalTime': 'Total Editing Time',
     'pptx.documentProperties.statistics.words': 'Words',
     'pptx.documentProperties.summary.category': 'Category',
     'pptx.documentProperties.summary.description': 'Description',