ooxml-ui 0.30.0 → 0.31.0

package/dist/pptx/theme/presets.d.ts

@@ -0,0 +1,21 @@
+import type { ViewerTheme, ViewerThemeColors } from './types.js';
+/**
+ * Built-in "vermilion" theme presets.
+ *
+ * These mirror the pptx-viewer brand used on the documentation site:
+ * a warm paper canvas in light mode, a dimmed presenter room in dark
+ * mode, and the vermilion accent in both. Pass one to the viewer's
+ * `theme` prop (React/Vue) or `provideViewerTheme` (Angular), or spread
+ * the color objects to derive your own variant.
+ */
+/** Light "paper" palette: a projection screen in a bright room. */
+export declare const vermilionLightColors: ViewerThemeColors;
+/** Dark "presenter" palette: the presenter room with the lights down. */
+export declare const vermilionDarkColors: ViewerThemeColors;
+/** Shared border-radius for the vermilion presets (slightly sharper than the default). */
+export declare const vermilionRadius = "0.375rem";
+/** Light vermilion theme, ready for the viewer's `theme` prop. */
+export declare const vermilionLightTheme: ViewerTheme;
+/** Dark vermilion theme, ready for the viewer's `theme` prop. */
+export declare const vermilionDarkTheme: ViewerTheme;
+//# sourceMappingURL=presets.d.ts.map

package/dist/pptx/theme/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../src/pptx/theme/presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE9D;;;;;;;;GAQG;AAEH,mEAAmE;AACnE,eAAO,MAAM,oBAAoB,EAAE,iBA4BlC,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,mBAAmB,EAAE,iBA4BjC,CAAC;AAEF,0FAA0F;AAC1F,eAAO,MAAM,eAAe,aAAa,CAAC;AAE1C,kEAAkE;AAClE,eAAO,MAAM,mBAAmB,EAAE,WAGjC,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,EAAE,WAGhC,CAAC"}

package/dist/pptx/theme/theme-catalog.d.ts

@@ -0,0 +1,20 @@
+import type { ViewerTheme } from './types.js';
+/** One selectable entry in the viewer chrome's built-in theme picker (File > Options > Appearance). */
+export interface ThemeCatalogEntry {
+    /** Stable identifier persisted to storage and passed to `onThemeChange`. */
+    key: string;
+    /** `pptx.*` translation key for the entry's display label. */
+    labelKey: string;
+    /** The theme to apply, or `undefined` to reset to the built-in default. */
+    theme: ViewerTheme | undefined;
+}
+/**
+ * Built-in theme choices offered by File > Options > Appearance when a host
+ * doesn't supply its own `availableThemes`. Keep this list short: it's meant
+ * as a sensible out-of-the-box picker, not a full theme gallery. Hosts that
+ * want more (or fewer) choices pass their own `availableThemes` prop.
+ */
+export declare const THEME_CATALOG: readonly ThemeCatalogEntry[];
+/** Look up a catalog entry by key, falling back to `undefined` (the built-in default) if not found. */
+export declare function resolveThemeCatalogEntry(key: string | undefined, catalog?: readonly ThemeCatalogEntry[]): ViewerTheme | undefined;
+//# sourceMappingURL=theme-catalog.d.ts.map

package/dist/pptx/theme/theme-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-catalog.d.ts","sourceRoot":"","sources":["../../../src/pptx/theme/theme-catalog.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,uGAAuG;AACvG,MAAM,WAAW,iBAAiB;IACjC,4EAA4E;IAC5E,GAAG,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,KAAK,EAAE,WAAW,GAAG,SAAS,CAAC;CAC/B;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,iBAAiB,EAarD,CAAC;AAEF,uGAAuG;AACvG,wBAAgB,wBAAwB,CACvC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,OAAO,GAAE,SAAS,iBAAiB,EAAkB,GACnD,WAAW,GAAG,SAAS,CAEzB"}

package/dist/pptx/theme/theme-gallery-presets.d.ts

@@ -0,0 +1,30 @@
+/**
+ * theme-gallery-presets: the exact theme set shown in the Design tab's Browse
+ * Themes gallery, shared by every binding.
+ *
+ * This is a DIFFERENT set from core's `THEME_PRESETS`: it adds Wisp, Berlin,
+ * Slice, and Dividend and omits Slate and Metropolitan, in this order:
+ *
+ *   office, facet, integral, ion, retrospect, organic,
+ *   wisp, berlin, slice, dividend
+ *
+ * The six themes that also exist in core (office, facet, integral, ion,
+ * organic, retrospect) are reused verbatim from core's `THEME_PRESETS` (looked
+ * up by id) so their colour/font schemes stay canonical. The four gallery-only
+ * themes are defined here as `PptxThemePreset` values with core's nested
+ * `{ majorFont: { latin }, minorFont: { latin } }` font-scheme shape.
+ */
+import type { PptxTheme, PptxThemePreset } from 'ooxml-core/pptx';
+/**
+ * The gallery theme set, in canonical order. Six canonical core presets plus
+ * the four gallery-only additions.
+ */
+export declare const GALLERY_THEME_PRESETS: readonly PptxThemePreset[];
+/**
+ * The gallery preset the deck's theme currently is, for highlighting the
+ * active tile in Design > Browse Themes: the preset whose colour scheme the
+ * theme carries, else the one whose name it carries, else undefined (a
+ * custom or edited theme).
+ */
+export declare function activeGalleryThemePreset(theme: Pick<PptxTheme, 'name' | 'colorScheme'> | undefined): PptxThemePreset | undefined;
+//# sourceMappingURL=theme-gallery-presets.d.ts.map

package/dist/pptx/theme/theme-gallery-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-gallery-presets.d.ts","sourceRoot":"","sources":["../../../src/pptx/theme/theme-gallery-presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AA4GlE;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,eAAe,EAW3D,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAAC,GAAG,SAAS,GACxD,eAAe,GAAG,SAAS,CAY7B"}

package/dist/pptx/theme/types.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Theme configuration types for the PowerPoint viewer.
+ *
+ * All color values accept any valid CSS color string:
+ * hex (`#6366f1`), rgb (`rgb(99 102 241)`), hsl (`hsl(239 84% 67%)`),
+ * oklch (`oklch(0.585 0.233 277)`), named colors, etc.
+ *
+ * Framework-agnostic  -  shared by the React, Vue, and Angular bindings.
+ */
+/**
+ * Semantic color tokens for the viewer UI.
+ *
+ * These map to CSS custom properties (`--pptx-<token>`) and drive all
+ * UI component colors. The naming follows the shadcn/ui convention so
+ * that Tailwind + shadcn users get a familiar experience.
+ */
+export interface ViewerThemeColors {
+    /** Page / root background */
+    background: string;
+    /** Default text color */
+    foreground: string;
+    /** Card / panel surface */
+    card: string;
+    /** Text on card surfaces */
+    cardForeground: string;
+    /** Popover / dropdown surface */
+    popover: string;
+    /** Text inside popovers */
+    popoverForeground: string;
+    /** Primary action color (buttons, active indicators) */
+    primary: string;
+    /** Text on primary-colored backgrounds */
+    primaryForeground: string;
+    /** Secondary / subdued action color */
+    secondary: string;
+    /** Text on secondary backgrounds */
+    secondaryForeground: string;
+    /** Muted / disabled surface */
+    muted: string;
+    /** Text on muted surfaces (also used for secondary text) */
+    mutedForeground: string;
+    /** Accent / hover-highlight surface */
+    accent: string;
+    /** Text on accent surfaces */
+    accentForeground: string;
+    /** Destructive / danger action color */
+    destructive: string;
+    /** Text on destructive backgrounds */
+    destructiveForeground: string;
+    /** Default border color */
+    border: string;
+    /** Input field border color */
+    input: string;
+    /** Focus ring color */
+    ring: string;
+}
+/**
+ * Full viewer theme configuration.
+ *
+ * Every property is optional  -  unset values fall back to the built-in
+ * dark theme defaults.
+ */
+export interface ViewerTheme {
+    /** Semantic UI colors. Each key maps to a `--pptx-<key>` CSS custom property. */
+    colors?: Partial<ViewerThemeColors>;
+    /** Base border-radius value (e.g. `"0.5rem"`, `"8px"`). */
+    radius?: string;
+    /**
+     * Escape hatch: arbitrary CSS custom properties to set on the viewer
+     * root element. Keys should include the `--` prefix.
+     *
+     * @example
+     * ```ts
+     * { "--my-custom-shadow": "0 4px 12px rgba(0,0,0,0.5)" }
+     * ```
+     */
+    cssVars?: Record<string, string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/pptx/theme/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/pptx/theme/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IACjC,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IAEnB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,cAAc,EAAE,MAAM,CAAC;IAEvB,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAE1B,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,iBAAiB,EAAE,MAAM,CAAC;IAE1B,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,mBAAmB,EAAE,MAAM,CAAC;IAE5B,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,eAAe,EAAE,MAAM,CAAC;IAExB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IAEzB,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,qBAAqB,EAAE,MAAM,CAAC;IAE9B,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;CACb;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC3B,iFAAiF;IACjF,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEpC,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC"}

package/dist/pptx/three-view/chart-events.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Maps `<pptx-three-view>`'s chart events onto a binding's chart-part
+ * selection and value-commit paths, the SAME ones its 2D SVG mark interaction
+ * uses, so the chart inspector and undo history react to a 3D mark exactly
+ * as they do to a 2D one.
+ *
+ * Each binding supplies a {@link Chart3DSelectionBridge} (its own selection
+ * store and update path) and forwards the element's events to
+ * {@link handleThreeViewChartEvent}; everything that decides what a click or
+ * drag means lives here.
+ *
+ * @module three-view/chart-events
+ */
+import type { PptxChartData } from 'ooxml-core/pptx';
+import type { ChartPartRef } from '../render/chart-view-model.js';
+import type { ThreeViewDragDetail, ThreeViewState } from './types.js';
+/** DOM event names `<pptx-three-view>` dispatches. */
+export declare const THREE_VIEW_EVENTS: {
+    readonly state: 'pptx-three-state';
+    readonly select: 'pptx-three-select';
+    readonly drag: 'pptx-three-drag';
+};
+/** `detail` of a `pptx-three-select` event. */
+export interface ThreeViewSelectDetail {
+    part: ChartPartRef | null;
+}
+/** `detail` of a `pptx-three-state` event. */
+export interface ThreeViewStateDetail {
+    state: ThreeViewState;
+}
+/** A binding's chart selection + commit path, as seen by one chart element. */
+export interface Chart3DSelectionBridge {
+    /** The chart element's id (selection scope). */
+    elementId: string;
+    /** The committed chart data a value drag is applied to. */
+    chartData: PptxChartData | undefined;
+    /** `false` on read-only mounts (thumbnails, sorter, presenter): they never touch the selection. */
+    canSelect: boolean;
+    /** Id of the element the current chart-part selection belongs to, or `null`. */
+    selectedElementId: string | null;
+    setSelection: (selection: {
+        elementId: string;
+        part: ChartPartRef;
+    } | null) => void;
+    /** Live value for the on-canvas drag badge; `null` clears it. */
+    setDragValue?: (value: number | null) => void;
+    /** Commit new chart data through the history-tracked update path; omit when not editable. */
+    commitChartData?: (next: PptxChartData) => void;
+}
+/** Apply a 3D mark selection (or a click on empty space) to the binding's selection. */
+export declare function applyChart3DSelect(bridge: Chart3DSelectionBridge, part: ChartPartRef | null): void;
+/** Apply a 3D value drag: `move` drives the badge only, `commit` writes the data once. */
+export declare function applyChart3DDrag(bridge: Chart3DSelectionBridge, detail: ThreeViewDragDetail): void;
+/**
+ * Route one `pptx-three-select` / `pptx-three-drag` event to the bridge.
+ * Returns `true` when the event was a chart event (and was handled).
+ */
+export declare function handleThreeViewChartEvent(event: Event, bridge: Chart3DSelectionBridge): boolean;
+/** The state carried by a `pptx-three-state` event, or `null` for any other event. */
+export declare function threeViewStateOf(event: Event): ThreeViewState | null;
+//# sourceMappingURL=chart-events.d.ts.map

package/dist/pptx/three-view/chart-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-events.d.ts","sourceRoot":"","sources":["../../../src/pptx/three-view/chart-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEnE,sDAAsD;AACtD,eAAO,MAAM,iBAAiB;aAC7B,KAAK,EAAE,kBAAkB;aACzB,MAAM,EAAE,mBAAmB;aAC3B,IAAI,EAAE,iBAAiB;CACd,CAAC;AAEX,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACrC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;CAC1B;AAED,8CAA8C;AAC9C,MAAM,WAAW,oBAAoB;IACpC,KAAK,EAAE,cAAc,CAAC;CACtB;AAED,+EAA+E;AAC/E,MAAM,WAAW,sBAAsB;IACtC,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,SAAS,EAAE,aAAa,GAAG,SAAS,CAAC;IACrC,mGAAmG;IACnG,SAAS,EAAE,OAAO,CAAC;IACnB,gFAAgF;IAChF,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,YAAY,EAAE,CAAC,SAAS,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,YAAY,CAAA;KAAE,GAAG,IAAI,KAAK,IAAI,CAAC;IACpF,iEAAiE;IACjE,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC9C,6FAA6F;IAC7F,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;CAChD;AAED,wFAAwF;AACxF,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,sBAAsB,EAC9B,IAAI,EAAE,YAAY,GAAG,IAAI,GACvB,IAAI,CASN;AAED,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAC/B,MAAM,EAAE,sBAAsB,EAC9B,MAAM,EAAE,mBAAmB,GACzB,IAAI,CAgBN;AAOD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAc/F;AAED,sFAAsF;AACtF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,cAAc,GAAG,IAAI,CAKpE"}

package/dist/pptx/three-view/element.d.ts

@@ -0,0 +1,53 @@
+/**
+ * `<pptx-three-view>`: the one custom element every binding uses to show a
+ * three.js chart or SmartArt scene.
+ *
+ * Bindings set the `spec` property and slot their 2D SVG rendering inside
+ * the element as its fallback. The fallback shows while the scene loads,
+ * and again if `three` is not installed, WebGL is unavailable, or the scene
+ * throws; the canvas shows once the scene is ready. That replaces the five
+ * per-binding copies of "lazy import three, error boundary, SVG fallback,
+ * resize, dispose" per chart kind.
+ *
+ * Properties: `spec` ({@link ThreeViewSpec} | null), `interactive` (also the
+ * `interactive` attribute), `selectedPart`, `textStyle`.
+ *
+ * Events (bubbling, composed):
+ *  - `pptx-three-state`  detail `{ state }` on every lifecycle change;
+ *  - `pptx-three-select` detail `{ part }` when a chart mark is clicked;
+ *  - `pptx-three-drag`   detail `{ part, value, phase }` while a mark is dragged.
+ *
+ * The current state is also reflected on the `data-state` attribute.
+ *
+ * @module three-view/element
+ */
+import type { TextStyleAnimationDescriptor } from '../render/animation-text-style-resolve.js';
+import type { ChartPartRef } from '../render/chart-view-model.js';
+import type { ThreeViewOverflow, ThreeViewSpec, ThreeViewState } from './types.js';
+/** The element's tag name. */
+export declare const THREE_VIEW_TAG = "pptx-three-view";
+/** Marker attribute every connected view carries (export clones are found by it). */
+export declare const THREE_VIEW_MARKER_ATTR = "data-pptx-three-view";
+/** Public shape of the element (for binding type declarations). */
+export interface PptxThreeViewElement extends HTMLElement {
+    spec: ThreeViewSpec | null;
+    interactive: boolean;
+    selectedPart: ChartPartRef | null;
+    textStyle: TextStyleAnimationDescriptor | undefined;
+    readonly state: ThreeViewState;
+    /** The 2D canvas the scene is drawn onto (for export/snapshot). */
+    readonly canvas: HTMLCanvasElement | null;
+    /**
+     * How far {@link canvas} reaches past the element box, as fractions of it
+     * (a turned scene-style SmartArt; see `view-overflow.ts`).
+     */
+    readonly overflowInsets: ThreeViewOverflow;
+    /** Draw any pending frame now. */
+    flush: () => void;
+}
+/**
+ * Register `<pptx-three-view>` (idempotent; a no-op outside the browser).
+ * Every binding calls this once before rendering the element.
+ */
+export declare function defineThreeViewElement(registry?: CustomElementRegistry): void;
+//# sourceMappingURL=element.d.ts.map

package/dist/pptx/three-view/element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element.d.ts","sourceRoot":"","sources":["../../../src/pptx/three-view/element.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,wCAAwC,CAAC;AAC3F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EACX,iBAAiB,EAEjB,aAAa,EACb,cAAc,EACd,MAAM,SAAS,CAAC;AAKjB,8BAA8B;AAC9B,eAAO,MAAM,cAAc,oBAAoB,CAAC;AAEhD,qFAAqF;AACrF,eAAO,MAAM,sBAAsB,yBAAyB,CAAC;AAiB7D,mEAAmE;AACnE,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACxD,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,SAAS,EAAE,4BAA4B,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC1C;;;OAGG;IACH,QAAQ,CAAC,cAAc,EAAE,iBAAiB,CAAC;IAC3C,kCAAkC;IAClC,KAAK,EAAE,MAAM,IAAI,CAAC;CAClB;AAsMD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAW7E"}

package/dist/pptx/three-view/export-snapshot.d.ts

@@ -0,0 +1,23 @@
+/** Longest {@link settleThreeViews} waits for a view still loading, in ms. */
+export declare const THREE_VIEW_SETTLE_TIMEOUT_MS = 4000;
+/** Attribute marking the `<img>` a snapshot left in a clone. */
+export declare const THREE_VIEW_SNAPSHOT_ATTR = "data-three-view-snapshot";
+/**
+ * Resolve once every `<pptx-three-view>` under `root` has finished loading
+ * (ready, unavailable, error, or no spec), or after `timeoutMs`. Then draws
+ * each ready view once so its canvas holds a current frame.
+ */
+export declare function settleThreeViews(root: ParentNode, timeoutMs?: number): Promise<void>;
+/**
+ * Replace every `<pptx-three-view>` in `cloneRoot` with the live view's
+ * current pixels plus a copy of its DOM overlay. `originalRoot` is the live
+ * tree `cloneRoot` was cloned from; views are paired in document order, so
+ * call this BEFORE anything removes nodes from the clone. Views that are not
+ * ready are left alone (their slotted 2D fallback is what gets captured).
+ *
+ * Serves both raster paths: the `foreignObject` path passes its own
+ * `cloneNode(true)` copy, and html2canvas passes the element it cloned into
+ * its capture iframe (see `export/html2canvas-clone.ts`).
+ */
+export declare function snapshotThreeViewsIntoClone(originalRoot: ParentNode, cloneRoot: ParentNode): void;
+//# sourceMappingURL=export-snapshot.d.ts.map

package/dist/pptx/three-view/export-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-snapshot.d.ts","sourceRoot":"","sources":["../../../src/pptx/three-view/export-snapshot.ts"],"names":[],"mappings":"AAuBA,8EAA8E;AAC9E,eAAO,MAAM,4BAA4B,OAAO,CAAC;AAEjD,gEAAgE;AAChE,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AAuBnE;;;;GAIG;AACH,wBAAsB,gBAAgB,CACrC,IAAI,EAAE,UAAU,EAChB,SAAS,GAAE,MAAqC,GAC9C,OAAO,CAAC,IAAI,CAAC,CA4Bf;AAyCD;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,GAAG,IAAI,CAwCjG"}

package/dist/pptx/three-view/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `three-view`: the shared host for every three.js scene (3D charts, 3D
+ * SmartArt). See `element.ts` for the `<pptx-three-view>` element bindings
+ * render, `renderer-host.ts` for the single shared WebGL context, and
+ * `types.ts` for the scene-module contract.
+ *
+ * Nothing reachable from here imports `three` at runtime: scenes receive the
+ * module through their mount context, so the main barrel stays free of the
+ * optional peer.
+ *
+ * @module three-view
+ */
+export { defineThreeViewElement, THREE_VIEW_MARKER_ATTR, THREE_VIEW_TAG } from './element.js';
+export { chartThreeViewSpec, isChart3DViewEnabled, resolveChartThreeViewSpec, resolveSmartArtThreeViewSpec, smartArtThreeViewSpec, } from './view-spec.js';
+export type { Chart3DFlags } from './view-spec.js';
+export { applyChart3DDrag, applyChart3DSelect, handleThreeViewChartEvent, THREE_VIEW_EVENTS, threeViewStateOf, } from './chart-events.js';
+export type { Chart3DSelectionBridge, ThreeViewSelectDetail, ThreeViewStateDetail, } from './chart-events.js';
+export { settleThreeViews, snapshotThreeViewsIntoClone, THREE_VIEW_SETTLE_TIMEOUT_MS, THREE_VIEW_SNAPSHOT_ATTR, } from './export-snapshot.js';
+export type { PptxThreeViewElement } from './element.js';
+export { computeThreeViewSize, MAX_DEVICE_PIXEL_RATIO } from './view-size.js';
+export { MAX_VIEW_PIXELS } from './renderer-host.js';
+export { hasThreeViewOverflow, MAX_THREE_VIEW_OVERFLOW, NO_THREE_VIEW_OVERFLOW, overflowCanvasCss, overflowPixelSize, overflowViewOffset, threeViewOverflowFromNdc, } from './view-overflow.js';
+export type { ThreeModule, ThreeViewContext, ThreeViewDragDetail, ThreeViewOverflow, ThreeViewScene, ThreeViewSceneEvent, ThreeViewSceneFactory, ThreeViewSize, ThreeViewSpec, ThreeViewState, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/pptx/three-view/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pptx/three-view/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3F,OAAO,EACN,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,4BAA4B,EAC5B,qBAAqB,GACrB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACN,gBAAgB,EAChB,kBAAkB,EAClB,yBAAyB,EACzB,iBAAiB,EACjB,gBAAgB,GAChB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACX,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACN,gBAAgB,EAChB,2BAA2B,EAC3B,4BAA4B,EAC5B,wBAAwB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EACN,oBAAoB,EACpB,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,GACxB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACX,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,cAAc,GACd,MAAM,SAAS,CAAC"}

package/dist/pptx/three-view/renderer-host.d.ts

@@ -0,0 +1,60 @@
+/**
+ * One shared WebGL context for every `<pptx-three-view>` on the page.
+ *
+ * Browsers cap live WebGL contexts at roughly 16 per page and silently kill
+ * the oldest when a new one is created. Before this host, every 3D chart and
+ * SmartArt graphic (on the slide AND in each thumbnail) created its own
+ * `WebGLRenderer`, so a deck with more than a handful of them rendered a
+ * blank main slide: its context was the one the thumbnails had evicted.
+ *
+ * Here a single offscreen `WebGLRenderer` draws each dirty view into the top
+ * left of its own drawing buffer, and the pixels are copied straight onto
+ * the view's own 2D `<canvas>` in the same task (so no
+ * `preserveDrawingBuffer` is needed). Views render on demand only: a scene
+ * asks for a frame when something changed, and only scenes that report
+ * `isAnimating()` keep getting frames. A 2D canvas is also something every
+ * export path (html2canvas, `toDataURL`) can read, which a WebGL canvas
+ * without `preserveDrawingBuffer` is not.
+ *
+ * @module three-view/renderer-host
+ */
+import type * as THREE from 'three';
+import type { ThreeModule } from './types.js';
+/** Largest backing-store edge a single view is drawn at, in device pixels. */
+export declare const MAX_VIEW_PIXELS = 4096;
+/** A view the host draws: its target canvas, its size, and how to draw it. */
+export interface HostedView {
+    /** The 2D canvas the view's pixels are copied onto. */
+    readonly canvas: HTMLCanvasElement;
+    /** Current backing size in device pixels. */
+    pixelSize: () => {
+        width: number;
+        height: number;
+    };
+    /** Whether the view is currently worth drawing (connected and on screen). */
+    isVisible: () => boolean;
+    /** Draw the scene; the host has already set viewport, scissor and cleared. */
+    draw: (renderer: THREE.WebGLRenderer) => void;
+    /** `true` while the view wants continuous frames. */
+    isAnimating: () => boolean;
+}
+/** The shared host's public surface. */
+export interface ThreeRendererHost {
+    /** `false` when WebGL could not be initialised at all (caller falls back to 2D). */
+    readonly available: boolean;
+    register: (view: HostedView) => void;
+    unregister: (view: HostedView) => void;
+    requestRender: (view: HostedView) => void;
+    /** Draw every pending view immediately (tests, export). */
+    flushNow: () => void;
+    /** Draw one registered view immediately, even when it is off screen (export snapshots). */
+    drawNow: (view: HostedView) => void;
+}
+/**
+ * The page-wide renderer host, created on first use from the given `three`
+ * module. Every later call returns the same host, whatever module it passes.
+ */
+export declare function getThreeRendererHost(three: ThreeModule): ThreeRendererHost;
+/** Test hook: forget the shared host so the next call builds a fresh one. */
+export declare function resetThreeRendererHostForTests(): void;
+//# sourceMappingURL=renderer-host.d.ts.map

package/dist/pptx/three-view/renderer-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-host.d.ts","sourceRoot":"","sources":["../../../src/pptx/three-view/renderer-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,8EAA8E;AAC9E,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IAC1B,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,6CAA6C;IAC7C,SAAS,EAAE,MAAM;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,6EAA6E;IAC7E,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,8EAA8E;IAC9E,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,aAAa,KAAK,IAAI,CAAC;IAC9C,qDAAqD;IACrD,WAAW,EAAE,MAAM,OAAO,CAAC;CAC3B;AAED,wCAAwC;AACxC,MAAM,WAAW,iBAAiB;IACjC,oFAAoF;IACpF,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IACrC,UAAU,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IACvC,aAAa,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IAC1C,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,2FAA2F;IAC3F,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;CACpC;AAmID;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CAqD1E;AAED,6EAA6E;AAC7E,wBAAgB,8BAA8B,IAAI,IAAI,CAErD"}

package/dist/pptx/three-view/scene-registry.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Maps a {@link ThreeViewSpec} `kind` to its lazily-imported scene factory.
+ *
+ * Each scene module is a separate dynamic import, so a deck with only charts
+ * never downloads the SmartArt scene code (and vice versa), and nothing here
+ * pulls `three` into the main bundle: scenes receive `three` through their
+ * mount context.
+ *
+ * @module three-view/scene-registry
+ */
+import type { ThreeViewSceneFactory, ThreeViewSpec } from './types.js';
+type SpecOf<K extends ThreeViewSpec['kind']> = Extract<ThreeViewSpec, {
+    kind: K;
+}>['spec'];
+/** Resolve the scene factory for a spec kind. */
+export declare function loadThreeViewScene<K extends ThreeViewSpec['kind']>(kind: K): Promise<ThreeViewSceneFactory<SpecOf<K>>>;
+export {};
+//# sourceMappingURL=scene-registry.d.ts.map

package/dist/pptx/three-view/scene-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-registry.d.ts","sourceRoot":"","sources":["../../../src/pptx/three-view/scene-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEpE,KAAK,MAAM,CAAC,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,aAAa,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,CAAC,MAAM,CAAC,CAAC;AAS3F,iDAAiD;AACjD,wBAAsB,kBAAkB,CAAC,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,EACvE,IAAI,EAAE,CAAC,GACL,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAE3C"}

package/dist/pptx/three-view/types.d.ts

@@ -0,0 +1,119 @@
+/**
+ * `three-view` contract: what a three.js scene module must provide to be
+ * hosted by the shared `<pptx-three-view>` custom element.
+ *
+ * The element (see `element.ts`) owns everything every binding used to
+ * duplicate five times over: lazily loading `three`, sizing, a DOM overlay
+ * layer, visibility, disposal, and the SVG fallback. The shared renderer host
+ * (see `renderer-host.ts`) owns the ONE WebGL context every view draws with,
+ * so a deck with dozens of 3D charts/SmartArt graphics (slide + thumbnails)
+ * never exhausts the browser's context limit.
+ *
+ * A scene module only builds meshes and a camera. It never creates a
+ * `WebGLRenderer`, never calls `renderer.setSize`/`setViewport`, and never runs
+ * its own `requestAnimationFrame` loop: it calls `ctx.requestRender()` when
+ * something visible changed, and draws in {@link ThreeViewScene.render}.
+ *
+ * Type-only `three` imports here; scene modules receive the runtime module as
+ * `ctx.three` so nothing in `pptx-viewer-shared` imports `three` statically.
+ *
+ * @module three-view/types
+ */
+import type * as THREE from 'three';
+import type { TextStyleAnimationDescriptor } from '../render/animation-text-style-resolve.js';
+import type { ChartPartRef } from '../render/chart-view-model.js';
+/** The runtime `three` module handed to a scene. */
+export type ThreeModule = typeof THREE;
+/** A view's size: CSS pixels of the element's own (untransformed) box, plus the device-pixel backing size. */
+export interface ThreeViewSize {
+    /** Layout width in CSS px (the element's own box, before any ancestor CSS transform). */
+    width: number;
+    /** Layout height in CSS px. */
+    height: number;
+    /** Backing-store width in device pixels (accounts for ancestor zoom and devicePixelRatio). */
+    pixelWidth: number;
+    /** Backing-store height in device pixels. */
+    pixelHeight: number;
+}
+/**
+ * How far a scene draws past each edge of the element box, as fractions of
+ * the box's width (`left`/`right`) or height (`top`/`bottom`). See
+ * `view-overflow.ts`.
+ */
+export interface ThreeViewOverflow {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+/** A value drag on a chart mark, in progress (`move`) or finished (`commit`). */
+export interface ThreeViewDragDetail {
+    part: ChartPartRef;
+    value: number;
+    phase: 'move' | 'commit';
+}
+/** Events a scene can raise; the element re-dispatches them as DOM `CustomEvent`s. */
+export type ThreeViewSceneEvent = {
+    type: 'select';
+    part: ChartPartRef | null;
+} | {
+    type: 'drag';
+    detail: ThreeViewDragDetail;
+};
+/** What the element gives a scene when mounting it. */
+export interface ThreeViewContext {
+    three: ThreeModule;
+    size: ThreeViewSize;
+    /** The element pointer input lands on (attach raycast listeners here). */
+    eventTarget: HTMLElement;
+    /** Absolutely positioned layer above the canvas, same box, for HTML/SVG chrome (titles, labels, tooltips). */
+    overlay: HTMLElement;
+    /** The document the view lives in (use it to create overlay nodes). */
+    document: Document;
+    /** Whether pointer interaction (select, drag) is enabled at mount. */
+    interactive: boolean;
+    /** Schedule a redraw of this view on the next frame. Cheap; coalesced. */
+    requestRender: () => void;
+    /** Raise a select/drag event to the host element. */
+    emit: (event: ThreeViewSceneEvent) => void;
+}
+/** A mounted scene, driven by the element and the renderer host. */
+export interface ThreeViewScene {
+    /**
+     * Draw one frame. The host has already bound the view's viewport and
+     * scissor and cleared colour + depth; the scene may issue several passes
+     * (calling `renderer.clearDepth()` between them) but must not resize the
+     * renderer or change its viewport.
+     */
+    render: (renderer: THREE.WebGLRenderer) => void;
+    /** The view's size changed; update camera aspect / overlay layout. */
+    resize: (size: ThreeViewSize) => void;
+    /**
+     * How far the scene draws past the element box (see `view-overflow.ts`).
+     * A scene that implements it must frame its camera for the grown buffer
+     * (`overflowViewOffset`) whenever it reports a non-zero overflow; it is
+     * read after mount and after every {@link resize}. Omitted: no overflow.
+     */
+    overflow?: () => ThreeViewOverflow;
+    /** `true` while the scene needs continuous frames (damping, auto-rotate, a tween). */
+    isAnimating?: () => boolean;
+    setInteractive?: (on: boolean) => void;
+    /** Mirror an externally chosen chart part (e.g. picked in the inspector) onto the scene. */
+    setSelectedPart?: (part: ChartPartRef | null) => void;
+    /** Apply (or clear) a font-style emphasis override on the scene's text. */
+    setTextStyle?: (style: TextStyleAnimationDescriptor | undefined) => void;
+    dispose: () => void;
+}
+/** A scene module's mount function. */
+export type ThreeViewSceneFactory<Spec> = (spec: Spec, ctx: ThreeViewContext) => ThreeViewScene | Promise<ThreeViewScene>;
+/** Everything `<pptx-three-view>` can show; `kind` picks the lazily-loaded scene module. */
+export type ThreeViewSpec = {
+    kind: 'chart';
+    spec: import('../render/chart-3d-spec.js').Chart3DSpec;
+} | {
+    kind: 'smartart';
+    spec: import('../render/smartart-3d-types.js').SmartArt3DModel;
+};
+/** Lifecycle state the element reflects on its `data-state` attribute. */
+export type ThreeViewState = 'idle' | 'loading' | 'ready' | 'unavailable' | 'error';
+//# sourceMappingURL=types.d.ts.map

package/dist/pptx/three-view/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/pptx/three-view/types.ts"],"names":[],"mappings":"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"}

package/dist/pptx/three-view/view-controller.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Mount lifecycle for one hosted 3D view: load `three` and the scene module,
+ * mount the scene against a canvas + overlay, register it with the shared
+ * renderer host, and tear it down. The `<pptx-three-view>` element is a thin
+ * shell around this; keeping the logic here keeps it testable without
+ * custom-element registration.
+ *
+ * Swapping specs never flashes: the previous scene keeps drawing until the
+ * replacement has mounted, then the two are exchanged in one step.
+ *
+ * @module three-view/view-controller
+ */
+import type { TextStyleAnimationDescriptor } from '../render/animation-text-style-resolve.js';
+import type { ChartPartRef } from '../render/chart-view-model.js';
+import type { ThreeViewOverflow, ThreeViewSceneEvent, ThreeViewSize, ThreeViewSpec, ThreeViewState } from './types.js';
+/** What the controller needs from its host element. */
+export interface ThreeViewControllerOptions {
+    canvas: HTMLCanvasElement;
+    overlay: HTMLElement;
+    eventTarget: HTMLElement;
+    measure: () => ThreeViewSize;
+    isVisible: () => boolean;
+    onState: (state: ThreeViewState) => void;
+    onSceneEvent: (event: ThreeViewSceneEvent) => void;
+    /** The scene now draws this far past the element box (see `view-overflow.ts`). */
+    onOverflow?: (overflow: ThreeViewOverflow) => void;
+}
+/** Drives one view. */
+export declare class ThreeViewController {
+    private readonly opts;
+    private host;
+    private mounted;
+    private token;
+    private size;
+    private overflow;
+    private interactive;
+    private selectedPart;
+    private textStyle;
+    constructor(opts: ThreeViewControllerOptions);
+    /** Mount `spec` (or clear the view for `null`). */
+    setSpec(spec: ThreeViewSpec | null): Promise<void>;
+    /** Re-measure; resizes the scene and redraws when anything changed. */
+    remeasure(force?: boolean): void;
+    /** Read the mounted scene's overflow and report a change to the element. */
+    private syncOverflow;
+    requestRender(): void;
+    setInteractive(on: boolean): void;
+    setSelectedPart(part: ChartPartRef | null): void;
+    setTextStyle(style: TextStyleAnimationDescriptor | undefined): void;
+    /**
+     * Draw this view synchronously (export / snapshot), even when it is off
+     * screen, then any other pending views.
+     */
+    flush(): void;
+    dispose(): void;
+    private unmount;
+}
+//# sourceMappingURL=view-controller.d.ts.map

package/dist/pptx/three-view/view-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-controller.d.ts","sourceRoot":"","sources":["../../../src/pptx/three-view/view-controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,wCAAwC,CAAC;AAE3F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAI/D,OAAO,KAAK,EACX,iBAAiB,EAEjB,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,cAAc,EACd,MAAM,SAAS,CAAC;AAOjB,uDAAuD;AACvD,MAAM,WAAW,0BAA0B;IAC1C,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,MAAM,aAAa,CAAC;IAC7B,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IACzC,YAAY,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACnD,kFAAkF;IAClF,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,IAAI,CAAC;CACnD;AAQD,uBAAuB;AACvB,qBAAa,mBAAmB;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;IAClD,OAAO,CAAC,IAAI,CAAkC;IAC9C,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,QAAQ,CAA6C;IAC7D,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,SAAS,CAA2C;IAE5D,YAAY,IAAI,EAAE,0BAA0B,EAG3C;IAED,mDAAmD;IAC7C,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAkFvD;IAED,uEAAuE;IACvE,SAAS,CAAC,KAAK,UAAQ,GAAG,IAAI,CAe7B;IAED,4EAA4E;IAC5E,OAAO,CAAC,YAAY;IASpB,aAAa,IAAI,IAAI,CAIpB;IAED,cAAc,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAIhC;IAED,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAI/C;IAED,YAAY,CAAC,KAAK,EAAE,4BAA4B,GAAG,SAAS,GAAG,IAAI,CAIlE;IAED;;;OAGG;IACH,KAAK,IAAI,IAAI,CAMZ;IAED,OAAO,IAAI,IAAI,CAGd;IAED,OAAO,CAAC,OAAO;CAef"}