ooxml-pages 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kai Jungsthoefel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,117 @@
-# Temporary Holding Version
+# ooxml-pages
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Render Word (`.docx`) and PowerPoint (`.pptx`) files in the browser as real pages and slides.
+
+- **Laid out like Word:** line breaking, page breaks, columns, sections, headers and footers, footnotes and endnotes, tables that split across pages, floating pictures with every wrap type, keep-with-next, widow control.
+- **View only, and small:** about 160 KB (min + gzip) for Word including the PowerPoint drawing code, about 100 KB for PowerPoint alone. No framework, one dependency ([zip.js](https://github.com/gildas-lormeau/zip.js)).
+- **Fast:** a typical document lays out in a few hundred milliseconds; pages are drawn lazily while scrolling.
+- **Private:** everything happens in the browser. Nothing is uploaded, and no script from the document is ever run.
+
+[Live demo](https://kai-jungsthoefel.github.io/ooxml-pages/) · [Changelog](CHANGELOG.md)
+
+## Install
+
+```sh
+npm install ooxml-pages
+```
+
+## Usage
+
+```ts
+import { renderDocx } from 'ooxml-pages/docx';
+import 'ooxml-pages/docx.css';
+
+const view = await renderDocx(file, document.getElementById('pages')!, {
+  root: document.getElementById('scroller'), // the element that scrolls, for lazy rendering
+  onProgress: ({ phase, fraction }) => console.log(phase, fraction),
+});
+console.log(view.pages.length, 'pages');
+// later
+view.destroy();
+```
+
+```ts
+import { renderPptx } from 'ooxml-pages/pptx';
+import 'ooxml-pages/pptx.css';
+
+const view = await renderPptx(file, container, {
+  // Optional: wrap each slide, e.g. with a caption.
+  frame: (slide, { index, hidden }) => {
+    const figure = document.createElement('figure');
+    const caption = document.createElement('figcaption');
+    caption.textContent = `Slide ${index + 1}${hidden ? ' (hidden)' : ''}`;
+    figure.append(slide, caption);
+    return figure;
+  },
+});
+```
+
+`file` is any `Blob` (a `File` from an `<input>`, a `fetch` response's `blob()` …). Pages and slides are laid out at 96 dpi in CSS pixels; scale them with CSS (`zoom` or `transform`) to fit your layout.
+
+### Options
+
+| Option | Default | |
+|---|---|---|
+| `lazy` | `true` | Draw pages only when they come near the visible area. `false` draws all of them in order. |
+| `root` | viewport | The scrolling element, used for lazy rendering (and for scrolling to bookmarks in Word documents). |
+| `preloadMargin` | `'1600px 0px'` (Word), `'1200px 0px'` (PowerPoint) | How far outside the visible area pages are prepared. |
+| `errorText` | `'This page could not be displayed.'` | Shown in place of a page that fails to render. |
+| `onProgress` | | Word: `{ phase: 'read' \| 'parse' \| 'layout' \| 'relayout', fraction? }`. PowerPoint: share of slides read (0–1). |
+| `frame` | | PowerPoint only: wraps each slide element before it is added. |
+
+Both views have `renderNow(index)`, `settled()` (resolves once everything started so far is drawn) and `destroy()`. A Word view also has `scrollToBookmark(name)`; links inside the document (tables of contents, cross references) already use it.
+
+### Lower level
+
+To draw pages yourself (thumbnails, printing, your own virtual scrolling), load the document without any DOM output and render single pages into elements you own:
+
+```ts
+import { layoutDocx } from 'ooxml-pages/docx';
+import { loadPresentation } from 'ooxml-pages/pptx';
+
+const doc = await layoutDocx(file);            // { pages: [{ width, height, number }], bookmarks, renderPage, close }
+await doc.renderPage(0, element);
+
+const deck = await loadPresentation(file);     // { width, height, slides: [{ hidden }], renderSlide, close }
+await deck.renderSlide(0, element);
+```
+
+Call `close()` when done: it releases the file, the picture URLs and embedded fonts.
+
+## What is supported
+
+**Word:** styles and direct formatting, numbering and lists, tab stops with leaders, borders and shading, columns, sections with different page sizes and orientations, headers and footers (first page, even and odd), footnotes and endnotes, fields (page numbers, NUMPAGES, PAGEREF, table of contents), equations (Office Math), tables (merged cells, header rows that repeat, rows that split, cell spacing, vertical text), floating pictures and shapes with every wrap type and anchor, rotation, flips and cropping, text boxes, groups, charts and SmartArt, VML shapes, watermarks and horizontal rules, legacy form fields and content controls with check boxes, symbol fonts, drop caps and text frames, embedded fonts, page color and background pictures, page borders, Word 2010 text effects (gradient fill, outline, shadow), EMF and WMF pictures.
+
+**PowerPoint:** slide → layout → master inheritance, themes and color maps, preset and custom shapes, fills (solid, gradient, picture, pattern), lines and arrowheads, text with bullets, autofit and columns, tables with table styles, charts (bar, line, pie, area, scatter …), SmartArt (from the drawing PowerPoint saved), groups, hidden slides.
+
+## Limits
+
+- **View only.** There is no editing and no saving. If you need an editor, look at [folio](https://github.com/stella/folio) or [ooxml](https://github.com/ChristopherVR/ooxml).
+- **Browser only.** Layout measures text with the browser's canvas, so it needs a DOM (no Node.js or server-side rendering).
+- **Fonts decide the line breaks.** Text is measured in the fonts the browser has. Where a document's fonts (Calibri, Cambria …) are not installed, the browser falls back to metric-compatible ones if present (Carlito, Caladea, Liberation) and otherwise to similar fonts, and lines may break differently from Word. Fonts embedded in a document are used.
+- **Approximations.** Art page borders (apples, stars …) are pictures built into Word; they are drawn as a dotted band of the same width. Text that Word sets slightly tighter can wrap a word earlier, so long documents may end up with a page more or less.
+- **Not supported:** the binary formats `.doc` and `.ppt`, password-protected files, tracked changes (the document is shown as it was saved), comments, animations and transitions, embedded videos.
+
+## Security
+
+Documents are untrusted input. The renderers never run scripts from a document, never load anything from the network, and show SVG only through `<img>` (where browsers run no scripts). Sizes, nesting and counts are capped so that a hostile file cannot exhaust memory. If you find a way around this, please report it privately (see [SECURITY.md](SECURITY.md)).
+
+## Development
+
+```sh
+npm install
+npm run dev          # demo page with the test files on http://localhost:5180
+npm test             # renders every test file in a browser and checks the page counts against Word
+npm run build        # dist/: ES modules, type declarations, stylesheets
+npm run samples      # regenerates the test files in test/fixtures/
+```
+
+Tests use Playwright. Run `npx playwright install chromium` once, or use an installed browser with `PW_CHANNEL=msedge npm test` (or `chrome`).
+
+The files in `test/fixtures/` are written from scratch by the scripts in `scripts/`, so they can be shared freely. The expected page counts come from Word 365 and PowerPoint 365.
+
+To release, set the version in `package.json` and `CHANGELOG.md`, commit, and push a tag `v<version>` on that commit. The release workflow publishes it to npm.
+
+## License
+
+[MIT](LICENSE)

package/dist/docx/document.d.ts

@@ -0,0 +1,52 @@
+import { type Theme } from '../pptx/color.js';
+import type { MediaSource, Source } from '../pptx/env.js';
+import { Package } from '../pptx/package.js';
+import { Numbering } from './numbering.js';
+import { Styles } from './styles.js';
+export interface NoteSettings {
+    numFmt: string;
+    numStart: number;
+    numRestart: string;
+    pos: string;
+}
+export interface Settings {
+    /** Default tab stop distance in twips. */
+    defaultTabStop: number;
+    evenAndOddHeaders: boolean;
+    /** Word version the layout follows: 11 (2003), 12 (2007), 14 (2010), 15 (2013 and later). */
+    compatMode: number;
+    footnotes: NoteSettings;
+    endnotes: NoteSettings;
+    /** w:clrSchemeMapping: bg1 → light1 … */
+    colorMap: Map<string, string>;
+    displayBackground: boolean;
+    /** Compatibility switches that change layout, e.g. doNotExpandShiftReturn. */
+    compat: Set<string>;
+    mirrorMargins: boolean;
+    gutterAtTop: boolean;
+    autoHyphenation: boolean;
+    decimalSymbol: string;
+}
+export interface DocxDocument {
+    pkg: Package;
+    media: MediaSource;
+    main: string;
+    source: Source;
+    body: Element;
+    background: Element | null;
+    styles: Styles;
+    numbering: Numbering;
+    theme: Theme;
+    settings: Settings;
+    footnotes: Map<string, Element>;
+    endnotes: Map<string, Element>;
+    /** Separator notes (type separator / continuationSeparator) of the footnotes part. */
+    footnoteSeparator: Element | null;
+    endnoteSeparator: Element | null;
+    footnoteSource: Source | null;
+    endnoteSource: Source | null;
+    /** Font table part, which lists embedded fonts. */
+    fontTable: string | null;
+}
+export declare function loadDocument(file: Blob): Promise<DocxDocument>;
+//# sourceMappingURL=document.d.ts.map

package/dist/docx/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/docx/document.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,KAAK,EAA6B,MAAM,kBAAkB,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,QAAQ;IACvB,0CAA0C;IAC1C,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,6FAA6F;IAC7F,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,YAAY,CAAC;IACxB,QAAQ,EAAE,YAAY,CAAC;IACvB,yCAAyC;IACzC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,8EAA8E;IAC9E,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,sFAAsF;IACtF,iBAAiB,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,gBAAgB,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,mDAAmD;IACnD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AA0FD,wBAAsB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,CAwDpE"}

package/dist/docx/document.js

@@ -0,0 +1,163 @@
+// SPDX-License-Identifier: MIT
+// The DOCX package: main document part, styles, numbering, theme, settings, notes, and the relationships the
+// content needs. Headers and footers are read when a section refers to them.
+import { parseColorMap, parseTheme } from '../pptx/color.js';
+import { Package } from '../pptx/package.js';
+import { DocxMedia } from './media.js';
+import { Numbering } from './numbering.js';
+import { Styles } from './styles.js';
+import { clampNum, kid, kids, wa, wi, wv } from './xml.js';
+/** Word's mapping names (light1, dark1 …) to DrawingML scheme slots. */
+const MAP_SLOT = {
+    light1: 'lt1', dark1: 'dk1', light2: 'lt2', dark2: 'dk2', accent1: 'accent1', accent2: 'accent2', accent3: 'accent3',
+    accent4: 'accent4', accent5: 'accent5', accent6: 'accent6', hyperlink: 'hlink', followedHyperlink: 'folHlink',
+};
+/** Colors of the default Office theme, which Word uses when a document has no theme part. */
+const DEFAULT_SCHEME = [
+    ['dk1', '000000'], ['lt1', 'FFFFFF'], ['dk2', '44546A'], ['lt2', 'E7E6E6'], ['accent1', '4472C4'], ['accent2', 'ED7D31'],
+    ['accent3', 'A5A5A5'], ['accent4', 'FFC000'], ['accent5', '5B9BD5'], ['accent6', '70AD47'], ['hlink', '0563C1'], ['folHlink', '954F72'],
+];
+function defaultTheme() {
+    const slots = DEFAULT_SCHEME.map(([slot, rgb]) => `<a:${slot}><a:srgbClr val="${rgb}"/></a:${slot}>`).join('');
+    const xml = `<a:theme xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main"><a:themeElements><a:clrScheme name="Office">${slots}</a:clrScheme></a:themeElements></a:theme>`;
+    return new DOMParser().parseFromString(xml, 'application/xml');
+}
+function noteSettings(el, fallbackFmt, base) {
+    return {
+        numFmt: wv(kid(el, 'numFmt')) ?? base?.numFmt ?? fallbackFmt,
+        numStart: clampNum(wi(kid(el, 'numStart')) ?? base?.numStart ?? 1, 0, 32767),
+        numRestart: wv(kid(el, 'numRestart')) ?? base?.numRestart ?? 'continuous',
+        pos: wv(kid(el, 'pos')) ?? base?.pos ?? 'pageBottom',
+    };
+}
+function parseSettings(doc) {
+    const root = doc?.documentElement ?? null;
+    const compat = kid(root, 'compat');
+    let compatMode = 12;
+    const flags = new Set();
+    for (const c of kids(compat)) {
+        if (c.localName === 'compatSetting') {
+            if (wa(c, 'name') === 'compatibilityMode')
+                compatMode = Number(wa(c, 'val')) || compatMode;
+            else if (wa(c, 'val') === '1' || wa(c, 'val') === 'true')
+                flags.add(wa(c, 'name') ?? '');
+        }
+        else if (wv(c) !== '0' && wv(c) !== 'false') {
+            flags.add(c.localName);
+        }
+    }
+    const mapEl = kid(root, 'clrSchemeMapping');
+    const colorMap = parseColorMap(null);
+    if (mapEl) {
+        for (const a of mapEl.attributes) {
+            const slot = MAP_SLOT[a.value];
+            // Word's attribute names: bg1, t1, bg2, t2, accent1 …
+            const key = a.localName === 't1' ? 'tx1' : a.localName === 't2' ? 'tx2' : a.localName;
+            if (slot)
+                colorMap.set(key, slot);
+        }
+    }
+    const on = (name) => {
+        const el = kid(root, name);
+        return !!el && wv(el) !== '0' && wv(el) !== 'false' && wv(el) !== 'off';
+    };
+    return {
+        defaultTabStop: clampNum(wi(kid(root, 'defaultTabStop')) ?? 720, 36, 31680),
+        evenAndOddHeaders: on('evenAndOddHeaders'),
+        compatMode,
+        footnotes: noteSettings(kid(root, 'footnotePr'), 'decimal'),
+        endnotes: noteSettings(kid(root, 'endnotePr'), 'lowerRoman'),
+        colorMap,
+        displayBackground: on('displayBackgroundShape'),
+        compat: flags,
+        mirrorMargins: on('mirrorMargins'),
+        gutterAtTop: on('gutterAtTop'),
+        autoHyphenation: on('autoHyphenation'),
+        decimalSymbol: (wv(kid(root, 'decimalSymbol')) ?? '.').slice(0, 1) || '.',
+    };
+}
+async function notes(pkg, rels, type, item) {
+    const out = new Map();
+    let separator = null;
+    for (const rel of rels.values()) {
+        if (rel.type !== type || rel.external)
+            continue;
+        const doc = await pkg.xml(rel.target);
+        for (const el of kids(doc?.documentElement)) {
+            if (el.localName !== item)
+                continue;
+            const id = wa(el, 'id');
+            const kind = wa(el, 'type');
+            if (kind === 'separator')
+                separator = el;
+            else if (id !== null && !kind)
+                out.set(id, el);
+        }
+        return { notes: out, separator, source: { part: rel.target, rels: await pkg.rels(rel.target) } };
+    }
+    return { notes: out, separator, source: null };
+}
+export async function loadDocument(file) {
+    const head = new Uint8Array(await file.slice(0, 4).arrayBuffer());
+    if (head[0] === 0xd0 && head[1] === 0xcf && head[2] === 0x11 && head[3] === 0xe0) {
+        throw new Error('This document is password-protected (encrypted) or in the old Word 97–2003 format and cannot be displayed.');
+    }
+    let pkg;
+    try {
+        pkg = await Package.open(file);
+    }
+    catch {
+        throw new Error('The file is not a valid Word document.');
+    }
+    try {
+        const main = (await pkg.related('', 'officeDocument')) ?? 'word/document.xml';
+        const doc = await pkg.xml(main);
+        const root = doc?.documentElement;
+        const body = kid(root, 'body');
+        if (!root || root.localName !== 'document' || !body)
+            throw new Error('The file is not a Word document.');
+        const rels = await pkg.rels(main);
+        const partOf = (type) => {
+            for (const rel of rels.values())
+                if (rel.type === type && !rel.external)
+                    return rel.target;
+            return null;
+        };
+        const stylesPart = partOf('styles');
+        const styles = new Styles(stylesPart ? await pkg.xml(stylesPart) : null);
+        const numberingPart = partOf('numbering');
+        const numbering = new Numbering(numberingPart ? await pkg.xml(numberingPart) : null, styles);
+        const themePart = partOf('theme');
+        let theme = parseTheme(themePart ? await pkg.xml(themePart) : null);
+        if (!theme.colors.size)
+            theme = { ...theme, colors: parseTheme(defaultTheme()).colors };
+        const settingsPart = partOf('settings');
+        const settings = parseSettings(settingsPart ? await pkg.xml(settingsPart) : null);
+        const foot = await notes(pkg, rels, 'footnotes', 'footnote');
+        const end = await notes(pkg, rels, 'endnotes', 'endnote');
+        return {
+            pkg,
+            media: new DocxMedia(pkg),
+            main,
+            source: { part: main, rels },
+            body,
+            background: kid(root, 'background'),
+            styles,
+            numbering,
+            theme,
+            settings,
+            footnotes: foot.notes,
+            endnotes: end.notes,
+            footnoteSeparator: foot.separator,
+            endnoteSeparator: end.separator,
+            footnoteSource: foot.source,
+            endnoteSource: end.source,
+            fontTable: partOf('fontTable'),
+        };
+    }
+    catch (error) {
+        pkg.close();
+        throw error;
+    }
+}
+//# sourceMappingURL=document.js.map

package/dist/docx/document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../../src/docx/document.ts"],"names":[],"mappings":"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"}

package/dist/docx/drawing.d.ts

@@ -0,0 +1,30 @@
+import { type Env, type Source } from '../pptx/env.js';
+import type { DocxDocument } from './document.js';
+import { type FlowContext, type StoryLayout } from './flow.js';
+import type { DrawingObj } from './model.js';
+import { parseBlocks } from './parse.js';
+import { wa } from './xml.js';
+export interface DrawContext {
+    doc: DocxDocument;
+    flow: FlowContext;
+    env: Env;
+    /** Draws laid out story content (text box contents) into a container. */
+    drawStory(layout: StoryLayout, container: HTMLElement, source: Source): void;
+    /** Parse contexts for text box contents, by story part. */
+    parsed: WeakMap<Element, ReturnType<typeof parseBlocks>>;
+}
+/** Word text box content (wps:txbx or a linked box) inside a shape's text rectangle. */
+declare function textBox(sp: Element, rect: {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    rot: number;
+}, dc: DrawContext, source: Source): HTMLElement | null;
+/**
+ * Element for a drawing object of the given size; positioned by the caller. Resolves when pictures are in
+ * (through env.pending).
+ */
+export declare function renderObject(obj: DrawingObj, dc: DrawContext, env: Env): Promise<HTMLElement | null>;
+export { textBox, wa };
+//# sourceMappingURL=drawing.d.ts.map

package/dist/docx/drawing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drawing.d.ts","sourceRoot":"","sources":["../../src/docx/drawing.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,MAAM,EAAW,MAAM,gBAAgB,CAAC;AAIhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAe,MAAM,WAAW,CAAC;AAE5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAoC,WAAW,EAAE,MAAM,YAAY,CAAC;AAE3E,OAAO,EAAuB,EAAE,EAAE,MAAM,UAAU,CAAC;AAEnD,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,YAAY,CAAC;IAClB,IAAI,EAAE,WAAW,CAAC;IAClB,GAAG,EAAE,GAAG,CAAC;IACT,yEAAyE;IACzE,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7E,2DAA2D;IAC3D,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC;CAC1D;AAwID,wFAAwF;AACxF,iBAAS,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CA4CpJ;AAkFD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAsB1G;AAED,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC"}