wolfy-reader 0.1.0

package/dist/view/appearance.js

@@ -0,0 +1,274 @@
+/**
+ * The appearance system's theme half: the `--wr-*` CSS custom-property contract,
+ * the built-in themes, and the frame stylesheet that delivers them so publisher
+ * CSS can restyle its own content but can never reach the theme variables.
+ *
+ * This module is pure and DOM-free. It maps an {@link Appearance} to a variable
+ * set and emits the `<style>` the frame injects at document-assembly time — no
+ * `document`, no `window`, no protocol traffic. The frame-injection seam lives in
+ * `frame.ts`; the reader facade owns the live appearance state.
+ *
+ * The typography half (font family, size, line height, alignment, hyphenation,
+ * columns) adds more `--wr-*` names to the same namespace and rides the same
+ * cascade. The reflowing knobs (font, size, line height, columns) change chunk
+ * geometry, so the reader re-lays out and restores the reading position for them
+ * rather than repainting in place the way a colour change does.
+ */
+import { CONTENT_ROOT_ID } from './frame.js';
+/**
+ * The built-in themes. Each is a full {@link ThemeVariables} set so a forced
+ * theme is self-contained — it needs no media query to be complete.
+ */
+export const THEMES = {
+    light: {
+        '--wr-background': '#ffffff',
+        '--wr-color': '#1a1a1a',
+        '--wr-link-color': '#1a5fb4',
+        '--wr-selection-background': '#b4d5fe',
+        '--wr-selection-color': '#1a1a1a',
+    },
+    dark: {
+        '--wr-background': '#121212',
+        '--wr-color': '#e6e6e6',
+        '--wr-link-color': '#8ab4f8',
+        '--wr-selection-background': '#2f5fb0',
+        '--wr-selection-color': '#ffffff',
+    },
+    sepia: {
+        '--wr-background': '#f4ecd8',
+        '--wr-color': '#5b4636',
+        '--wr-link-color': '#8a5a1a',
+        '--wr-selection-background': '#e0cfa8',
+        '--wr-selection-color': '#5b4636',
+    },
+};
+/** The default theme when the host does not force one and the OS is in light mode. */
+const DEFAULT_LIGHT = { ...THEMES.light };
+/** The default theme when the host does not force one and the OS is in dark mode. */
+const DEFAULT_DARK = { ...THEMES.dark };
+/** The cascade layer the theme reset lives in, so publisher rules outrank it. */
+const THEME_LAYER = 'wolfy-reader-theme';
+/** Normalize a custom-property key to its `--`-prefixed form. */
+function normalizeVarName(name) {
+    return name.startsWith('--') ? name : `--${name}`;
+}
+/**
+ * Merge two partial `Appearance`s. `update` wins field-by-field; `customProperties`
+ * shallow-merges (an update's keys override the base's, and only the base's other
+ * keys survive). Passing `theme: undefined` in `update` does not clear the base
+ * theme — omit the key to keep it, since `exactOptionalPropertyTypes` distinguishes
+ * absent from `undefined`.
+ */
+export function mergeAppearance(base, update) {
+    const merged = {};
+    const theme = 'theme' in update ? update.theme : base.theme;
+    if (theme !== undefined)
+        merged.theme = theme;
+    const custom = { ...(base.customProperties ?? {}), ...(update.customProperties ?? {}) };
+    if (Object.keys(custom).length > 0)
+        merged.customProperties = custom;
+    const fontFamily = 'fontFamily' in update ? update.fontFamily : base.fontFamily;
+    if (fontFamily !== undefined)
+        merged.fontFamily = fontFamily;
+    const fontSize = 'fontSize' in update ? update.fontSize : base.fontSize;
+    if (fontSize !== undefined)
+        merged.fontSize = fontSize;
+    const lineHeight = 'lineHeight' in update ? update.lineHeight : base.lineHeight;
+    if (lineHeight !== undefined)
+        merged.lineHeight = lineHeight;
+    const margin = 'margin' in update ? update.margin : base.margin;
+    if (margin !== undefined)
+        merged.margin = margin;
+    const textAlign = 'textAlign' in update ? update.textAlign : base.textAlign;
+    if (textAlign !== undefined)
+        merged.textAlign = textAlign;
+    const justify = 'justify' in update ? update.justify : base.justify;
+    if (justify !== undefined)
+        merged.justify = justify;
+    const hyphenate = 'hyphenate' in update ? update.hyphenate : base.hyphenate;
+    if (hyphenate !== undefined)
+        merged.hyphenate = hyphenate;
+    const columns = 'columns' in update ? update.columns : base.columns;
+    if (columns !== undefined)
+        merged.columns = columns;
+    return merged;
+}
+/**
+ * The resolved `--wr-*` variables for a forced theme, or `null` when no theme is
+ * forced (the frame follows `prefers-color-scheme` instead). Custom properties
+ * merge over the theme's base and win; for `theme: 'custom'` the base is the light
+ * theme so an incomplete custom set still yields a complete, readable variable set.
+ */
+export function resolveThemeProperties(appearance) {
+    const theme = appearance.theme;
+    const custom = appearance.customProperties;
+    if (theme === undefined && custom === undefined)
+        return null;
+    const base = theme === undefined || theme === 'custom'
+        ? { ...(theme === 'custom' ? DEFAULT_LIGHT : {}) }
+        : { ...THEMES[theme] };
+    // With no theme and only custom properties, seed from the light theme so a
+    // partial custom set is still complete; a forced-null default (below) covers
+    // the truly-unset case.
+    if (theme === undefined && custom !== undefined)
+        Object.assign(base, DEFAULT_LIGHT);
+    if (custom !== undefined) {
+        for (const [name, value] of Object.entries(custom))
+            base[normalizeVarName(name)] = value;
+    }
+    return base;
+}
+/**
+ * The resolved typography `--wr-*` variables for an appearance, or `null` when no
+ * typography knob is set. `columns` maps to `--wr-column-count`; `justify` folds
+ * into `--wr-text-align` (an explicit `textAlign` wins over `justify`). Only the
+ * knobs the caller supplied are emitted — an unset knob leaves the publisher's own
+ * value in place rather than forcing a default.
+ */
+export function resolveTypographyProperties(appearance) {
+    const vars = {};
+    if (appearance.fontFamily !== undefined)
+        vars['--wr-font-family'] = appearance.fontFamily;
+    if (appearance.fontSize !== undefined)
+        vars['--wr-font-size'] = `${appearance.fontSize}px`;
+    if (appearance.lineHeight !== undefined)
+        vars['--wr-line-height'] = String(appearance.lineHeight);
+    const align = resolveTextAlign(appearance);
+    if (align !== undefined)
+        vars['--wr-text-align'] = align;
+    if (appearance.hyphenate !== undefined) {
+        vars['--wr-hyphens'] = appearance.hyphenate ? 'auto' : 'manual';
+    }
+    if (appearance.columns !== undefined)
+        vars['--wr-column-count'] = String(appearance.columns);
+    return Object.keys(vars).length === 0 ? null : vars;
+}
+/** The effective text alignment: an explicit `textAlign` wins over `justify`. */
+function resolveTextAlign(appearance) {
+    if (appearance.textAlign !== undefined)
+        return appearance.textAlign;
+    if (appearance.justify !== undefined)
+        return appearance.justify ? 'justify' : 'start';
+    return undefined;
+}
+/** Serialize a variable set into `--name: value;` declarations. */
+function declarations(vars) {
+    return Object.entries(vars)
+        .map(([name, value]) => `${name}:${value}`)
+        .join(';');
+}
+/** The `:root` variable block for a set of resolved theme variables. */
+function forcedRoot(vars) {
+    return `:root{${declarations(vars)}}`;
+}
+/**
+ * The `prefers-color-scheme`-driven default variables, used when the host does
+ * not force a theme. Light values sit at `:root`; a `@media (prefers-color-scheme:
+ * dark)` block swaps them, so the frame picks up the OS mode on its own opaque
+ * origin — the resolution stays inside the frame rather than being sniffed by the
+ * host. A forced theme's explicit `:root` block (emitted after this) overrides it.
+ */
+function preferenceDefaults() {
+    return (`:root{${declarations(DEFAULT_LIGHT)}}` +
+        `@media (prefers-color-scheme: dark){:root{${declarations(DEFAULT_DARK)}}}`);
+}
+/**
+ * The reading surface — the outermost background and base text colour, anchored
+ * on the content root. This belongs to the reader, not the book, so it is set
+ * unlayered and `!important` at id specificity: an id selector plus `!important`
+ * outranks even a publisher `*{…!important}` or `body{…!important}`, so a hostile
+ * book cannot repaint the surface out from under the theme. It only pins the
+ * content root's *own* background/colour; descendants a book styles (`p{color}`)
+ * still win for themselves, because that is a direct match on the descendant.
+ */
+function surfaceGuarantee() {
+    return (`#${CONTENT_ROOT_ID}{` +
+        `background:var(--wr-background) !important;` +
+        `color:var(--wr-color) !important` +
+        `}`);
+}
+/**
+ * The themeable defaults that consume the `--wr-*` variables: the html/body
+ * fallback surface, link colour and selection colours. These live in a cascade
+ * layer, so an unlayered publisher rule of any specificity outranks them *for the
+ * properties it sets* — a book restyling its own links or background wins — while
+ * the `--wr-*` variables themselves are unreachable by publisher CSS (they are
+ * custom-property names the book does not know). An unstyled book still themes
+ * fully, because nothing overrides the layer.
+ */
+function themeableDefaults() {
+    return (`@layer ${THEME_LAYER}{` +
+        `html{background:var(--wr-background);color:var(--wr-color)}` +
+        `body{background:var(--wr-background);color:var(--wr-color)}` +
+        `a{color:var(--wr-link-color)}` +
+        `::selection{background:var(--wr-selection-background);color:var(--wr-selection-color)}` +
+        `}`);
+}
+/**
+ * The unlayered typography block: the reader's own font, size, line height,
+ * alignment and hyphenation, anchored on the content root and set `!important` at
+ * id specificity — the same cascade device as {@link surfaceGuarantee}. An id
+ * selector plus `!important` outranks even a hostile publisher `*{…!important}`,
+ * so a user's typography choice wins the reading surface; a descendant the book
+ * styles directly (`p{font-size:20px}`) still wins for itself, which is the
+ * intended split. Only the knobs actually set emit a declaration, and each reads
+ * its own `--wr-*` variable (unreachable by publisher CSS). `column-count` is not
+ * here — column geometry is per-chunk and applied frame-side by the paginator.
+ */
+function typographyGuarantee(vars) {
+    const rules = [];
+    if (vars['--wr-font-family'] !== undefined)
+        rules.push('font-family:var(--wr-font-family) !important');
+    if (vars['--wr-font-size'] !== undefined)
+        rules.push('font-size:var(--wr-font-size) !important');
+    if (vars['--wr-line-height'] !== undefined)
+        rules.push('line-height:var(--wr-line-height) !important');
+    if (vars['--wr-text-align'] !== undefined)
+        rules.push('text-align:var(--wr-text-align) !important');
+    if (vars['--wr-hyphens'] !== undefined) {
+        rules.push('-webkit-hyphens:var(--wr-hyphens) !important', 'hyphens:var(--wr-hyphens) !important');
+    }
+    if (rules.length === 0)
+        return '';
+    return `:root{${declarations(vars)}}#${CONTENT_ROOT_ID}{${rules.join(';')}}`;
+}
+/**
+ * The full appearance stylesheet the frame injects at document assembly, before
+ * the publisher's `headHtml`. It carries the theme half (colours) and the
+ * typography half (font/size/line-height/alignment/hyphenation) through one
+ * `--wr-*` namespace. It declares the theme layer first (so its ordering is fixed
+ * regardless of any `@layer` a book declares later), emits the themeable defaults
+ * and the unlayered surface guarantee, then the `prefers-color-scheme` defaults,
+ * then — if a theme is forced — an unlayered `:root` block that overrides the
+ * media query, and finally the unlayered typography guarantee. `null` from
+ * {@link resolveThemeProperties} means "follow the OS"; a variable set means
+ * "force it".
+ */
+export function themeStyleSheet(appearance) {
+    const forced = resolveThemeProperties(appearance);
+    const typography = resolveTypographyProperties(appearance);
+    return (`@layer ${THEME_LAYER};` +
+        themeableDefaults() +
+        surfaceGuarantee() +
+        preferenceDefaults() +
+        (forced === null ? '' : forcedRoot(forced)) +
+        (typography === null ? '' : typographyGuarantee(typography)));
+}
+/**
+ * The typography knobs that change chunk geometry and therefore require a re-layout
+ * (a `paginate`), not just a variable poke: font family, font size, line height,
+ * page margin, and column count. Alignment and hyphenation can shift line breaks
+ * too, so they are treated as reflowing to be safe. Whether an `update` touches any
+ * of these decides which path {@link Reader.setAppearance} takes.
+ */
+export function isReflowingUpdate(update) {
+    return (update.fontFamily !== undefined ||
+        update.fontSize !== undefined ||
+        update.lineHeight !== undefined ||
+        update.margin !== undefined ||
+        update.textAlign !== undefined ||
+        update.justify !== undefined ||
+        update.hyphenate !== undefined ||
+        update.columns !== undefined);
+}
+//# sourceMappingURL=appearance.js.map

package/dist/view/appearance.js.map

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

package/dist/view/css.d.ts

@@ -0,0 +1,24 @@
+export type CssReferenceKind = 'import' | 'url';
+export interface CssReference {
+    readonly kind: CssReferenceKind;
+    /** The reference as written, with quotes and escapes removed. */
+    readonly value: string;
+    /** Index of the first character of the replaceable token. */
+    readonly start: number;
+    /** Index one past the last character of the replaceable token. */
+    readonly end: number;
+}
+/**
+ * Finds every `url(...)` and `@import` target in a stylesheet.
+ *
+ * This is a token-level scan that understands strings and comments, not a CSS
+ * parser: those two constructs are the only ones a renderer has to rewrite, and
+ * a conforming parser is orders of magnitude more code for no extra coverage.
+ */
+export declare function findCssReferences(css: string): CssReference[];
+/**
+ * Rewrites every reference the scan finds. A replacer returning undefined
+ * leaves the reference exactly as written.
+ */
+export declare function rewriteCssReferences(css: string, replace: (reference: CssReference) => Promise<string | undefined>): Promise<string>;
+//# sourceMappingURL=css.d.ts.map

package/dist/view/css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css.d.ts","sourceRoot":"","sources":["../../src/view/css.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEhD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AA2FD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,EAAE,CAsC7D;AAMD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,CAAC,SAAS,EAAE,YAAY,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,GAChE,OAAO,CAAC,MAAM,CAAC,CAYjB"}

package/dist/view/css.js

@@ -0,0 +1,153 @@
+const IDENT_CHAR = /[A-Za-z0-9_\-\\\u0080-\uFFFF]/;
+function isIdentChar(character) {
+    return character !== '' && IDENT_CHAR.test(character);
+}
+function matchesAt(css, index, literal) {
+    return css.slice(index, index + literal.length).toLowerCase() === literal;
+}
+function skipComment(css, index) {
+    const close = css.indexOf('*/', index + 2);
+    return close === -1 ? css.length : close + 2;
+}
+function skipSpace(css, index) {
+    let i = index;
+    while (i < css.length) {
+        const character = css.charAt(i);
+        if (character === '/' && css.charAt(i + 1) === '*') {
+            i = skipComment(css, i);
+            continue;
+        }
+        if (character === ' ' || character === '\t' || character === '\n' || character === '\r' || character === '\f') {
+            i += 1;
+            continue;
+        }
+        return i;
+    }
+    return i;
+}
+function readString(css, index) {
+    const quote = css.charAt(index);
+    let i = index + 1;
+    let value = '';
+    while (i < css.length) {
+        const character = css.charAt(i);
+        if (character === '\\') {
+            if (css.charAt(i + 1) !== '\n')
+                value += css.charAt(i + 1);
+            i += 2;
+            continue;
+        }
+        if (character === quote)
+            return { value, end: i + 1 };
+        if (character === '\n')
+            return null;
+        value += character;
+        i += 1;
+    }
+    return null;
+}
+function readUrl(css, index) {
+    let i = skipSpace(css, index + 4);
+    let value;
+    const quote = css.charAt(i);
+    if (quote === '"' || quote === "'") {
+        const string = readString(css, i);
+        if (string === null)
+            return null;
+        value = string.value;
+        i = skipSpace(css, string.end);
+    }
+    else {
+        let raw = '';
+        while (i < css.length && css.charAt(i) !== ')') {
+            if (css.charAt(i) === '\\') {
+                raw += css.charAt(i + 1);
+                i += 2;
+                continue;
+            }
+            raw += css.charAt(i);
+            i += 1;
+        }
+        value = raw.trim();
+    }
+    if (css.charAt(i) !== ')')
+        return null;
+    return { value, end: i + 1 };
+}
+function readReference(css, index) {
+    const character = css.charAt(index);
+    if (character === '"' || character === "'")
+        return readString(css, index);
+    if (matchesAt(css, index, 'url('))
+        return readUrl(css, index);
+    return null;
+}
+/**
+ * Finds every `url(...)` and `@import` target in a stylesheet.
+ *
+ * This is a token-level scan that understands strings and comments, not a CSS
+ * parser: those two constructs are the only ones a renderer has to rewrite, and
+ * a conforming parser is orders of magnitude more code for no extra coverage.
+ */
+export function findCssReferences(css) {
+    const references = [];
+    let i = 0;
+    while (i < css.length) {
+        const character = css.charAt(i);
+        if (character === '/' && css.charAt(i + 1) === '*') {
+            i = skipComment(css, i);
+            continue;
+        }
+        if (character === '"' || character === "'") {
+            const string = readString(css, i);
+            i = string === null ? i + 1 : string.end;
+            continue;
+        }
+        if (character === '@' && matchesAt(css, i, '@import') && !isIdentChar(css.charAt(i + 7))) {
+            const start = skipSpace(css, i + 7);
+            const token = readReference(css, start);
+            if (token === null) {
+                i += 7;
+                continue;
+            }
+            references.push({ kind: 'import', value: token.value, start, end: token.end });
+            i = token.end;
+            continue;
+        }
+        if (matchesAt(css, i, 'url(') && !isIdentChar(css.charAt(i - 1))) {
+            const token = readUrl(css, i);
+            if (token === null) {
+                i += 1;
+                continue;
+            }
+            references.push({ kind: 'url', value: token.value, start: i, end: token.end });
+            i = token.end;
+            continue;
+        }
+        i += 1;
+    }
+    return references;
+}
+function escapeCssUrl(url) {
+    return url.replace(/[\\"]/g, '\\$&').replace(/[\n\r]/g, '');
+}
+/**
+ * Rewrites every reference the scan finds. A replacer returning undefined
+ * leaves the reference exactly as written.
+ */
+export async function rewriteCssReferences(css, replace) {
+    const references = findCssReferences(css);
+    if (references.length === 0)
+        return css;
+    let out = '';
+    let cursor = 0;
+    for (const reference of references) {
+        const replacement = await replace(reference);
+        if (replacement === undefined)
+            continue;
+        out += `${css.slice(cursor, reference.start)}url("${escapeCssUrl(replacement)}")`;
+        cursor = reference.end;
+    }
+    return out + css.slice(cursor);
+}
+//# sourceMappingURL=css.js.map

package/dist/view/css.js.map

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

package/dist/view/frame.d.ts

@@ -0,0 +1,54 @@
+export declare const CONTENT_ROOT_ID = "wolfy-reader-content";
+/** Class marking each per-chunk container the host emits into the frame body. */
+export declare const CHUNK_CLASS = "wolfy-reader-chunk";
+/** Cumulative character offset of a chunk's first glyph into the section text. */
+export declare const CHUNK_START_ATTR = "data-chunk-start";
+/** Cumulative character offset just past a chunk's last glyph. */
+export declare const CHUNK_END_ATTR = "data-chunk-end";
+/** Zero-based index of a chunk in section order. */
+export declare const CHUNK_INDEX_ATTR = "data-chunk-index";
+/** Class every draw-only decoration overlay box carries, alongside the caller's class. */
+export declare const DECORATION_CLASS = "wolfy-reader-decoration";
+export declare function createNonce(): string;
+export declare function coordinationScript(hostOrigin: string, keyboardNav?: boolean): string;
+/** One chunk's markup plus its character count, as `chunkElement` reports it. */
+export interface ChunkPart {
+    readonly html: string;
+    readonly chars: number;
+}
+/**
+ * Wraps each chunk in its own container element, tagging it with the cumulative
+ * character range it covers in the section's concatenated text. Offsets are
+ * end-exclusive: chunk *i* covers `[start, end)`, and chunk *i+1* starts exactly
+ * at the previous `end`, so the ranges tile the section text without gap or
+ * overlap. The frame reads these attributes to build per-chunk multi-column
+ * contexts and to map pages to character offsets.
+ *
+ * The container is a `<div class="wolfy-reader-chunk">`; the char count comes from
+ * `chunkElement` (`textContent.length` of the chunk's nodes), so it matches what
+ * the frame measures with `textContent` at runtime.
+ */
+export declare function assembleChunkedBody(chunks: readonly ChunkPart[]): string;
+export interface FrameDocumentParts {
+    readonly headHtml: string;
+    readonly bodyHtml: string;
+    readonly nonce: string;
+    readonly hostOrigin: string;
+    /**
+     * The appearance theme stylesheet ({@link themeStyleSheet}). Injected before
+     * the publisher's `headHtml` so its cascade layer loses specificity fights on
+     * the properties the book sets, while the theme variables it declares stay
+     * unreachable by publisher CSS. Omit for an unthemed document.
+     */
+    readonly themeCss?: string;
+    /**
+     * Whether the host acts on forwarded navigation keydowns. Baked into the
+     * coordination script (not a wire message — no protocol change): when `false`
+     * the frame still forwards nav keys but no longer `preventDefault`s them, so
+     * a key the host will ignore keeps its default action instead of going dead.
+     * Defaults to `true`.
+     */
+    readonly keyboardNav?: boolean;
+}
+export declare function assembleFrameDocument(parts: FrameDocumentParts): string;
+//# sourceMappingURL=frame.d.ts.map

package/dist/view/frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../../src/view/frame.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe,yBAAyB,CAAC;AAEtD,iFAAiF;AACjF,eAAO,MAAM,WAAW,uBAAuB,CAAC;AAChD,kFAAkF;AAClF,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AACnD,kEAAkE;AAClE,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAC/C,oDAAoD;AACpD,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AAEnD,0FAA0F;AAC1F,eAAO,MAAM,gBAAgB,4BAA4B,CAAC;AA+C1D,wBAAgB,WAAW,IAAI,MAAM,CAIpC;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,GAAE,OAAc,GAAG,MAAM,CAi2B1F;AAED,iFAAiF;AACjF,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAcxE;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CA2BvE"}