@geekity/cms 0.30.0 → 0.32.0

package/dist/files/export-archives.js

@@ -0,0 +1,67 @@
+import { readdir, rm, stat } from 'node:fs/promises';
+import { isNotFound } from '../util/files.js';
+import { EXPORTS, dataFolder, dataPath } from './data-files.js';
+const EXPORT_LIFETIME_MS = 24 * 60 * 60 * 1000;
+const ARCHIVE = /^geekity-.+-(\d{4})(\d{2})(\d{2})T(\d{2})(\d{2})(\d{2})Z\.tar\.gz$/;
+function archiveOf(dataDir, name) {
+    const match = ARCHIVE.exec(name);
+    if (match === null)
+        return undefined;
+    const [, year, month, day, hour, minute, second] = match;
+    const writtenAt = new Date(`${year}-${month}-${day}T${hour}:${minute}:${second}Z`);
+    return {
+        name,
+        path: dataPath(dataDir, EXPORTS, name),
+        writtenAt,
+        expiresAt: new Date(writtenAt.getTime() + EXPORT_LIFETIME_MS),
+    };
+}
+async function namesIn(dataDir) {
+    try {
+        return await readdir(dataFolder(dataDir, EXPORTS));
+    }
+    catch (error) {
+        if (isNotFound(error))
+            return [];
+        throw error;
+    }
+}
+async function archives(dataDir) {
+    return (await namesIn(dataDir))
+        .flatMap((name) => archiveOf(dataDir, name) ?? [])
+        .sort((a, b) => b.writtenAt.getTime() - a.writtenAt.getTime());
+}
+function expired(archive, now) {
+    return archive.expiresAt.getTime() <= now.getTime();
+}
+export async function expireExports(dataDir, now) {
+    let deleted = 0;
+    for (const archive of await archives(dataDir)) {
+        if (expired(archive, now)) {
+            await rm(archive.path, { force: true });
+            deleted += 1;
+        }
+    }
+    return deleted;
+}
+export async function currentExport(dataDir, now) {
+    await expireExports(dataDir, now);
+    const [newest] = await archives(dataDir);
+    if (newest === undefined)
+        return undefined;
+    try {
+        return { ...newest, size: (await stat(newest.path)).size };
+    }
+    catch (error) {
+        if (isNotFound(error))
+            return undefined;
+        throw error;
+    }
+}
+export async function keepOnlyExport(dataDir, keep) {
+    for (const name of await namesIn(dataDir)) {
+        if (name !== keep)
+            await rm(dataPath(dataDir, EXPORTS, name), { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=export-archives.js.map

package/dist/files/export-archives.js.map

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

package/dist/files/static-files.d.ts

@@ -0,0 +1,21 @@
+import type { Stats } from 'node:fs';
+/** A file on disk, located and described, ready to be served. */
+export interface StaticAsset {
+    /** Absolute path on disk. */
+    file: string;
+    /** Size and modification time, for the validators. */
+    stats: Stats;
+    /** Media type, from the extension. */
+    contentType: string;
+    /** Strong-looking validator over size and mtime. */
+    etag: string;
+}
+/**
+ * Find one file under a list of roots, first root that has it winning.
+ *
+ * Returns `undefined` when the request escapes its root, names a directory, or
+ * matches nothing. Traversal is checked after resolution rather than by
+ * inspecting the request, so an encoded `..` cannot slip past.
+ */
+export declare function findAsset(relative: string, roots: string[]): StaticAsset | undefined;
+//# sourceMappingURL=static-files.d.ts.map

package/dist/files/static-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-files.d.ts","sourceRoot":"","sources":["../../src/files/static-files.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAKrC,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,KAAK,EAAE,KAAK,CAAC;IACb,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,WAAW,GAAG,SAAS,CA6BpF"}

package/dist/files/static-files.js

@@ -0,0 +1,73 @@
+import { statSync } from 'node:fs';
+import path from 'node:path';
+import { servedType, UPLOAD_MEDIA_TYPES } from './upload-types.js';
+/**
+ * Find one file under a list of roots, first root that has it winning.
+ *
+ * Returns `undefined` when the request escapes its root, names a directory, or
+ * matches nothing. Traversal is checked after resolution rather than by
+ * inspecting the request, so an encoded `..` cannot slip past.
+ */
+export function findAsset(relative, roots) {
+    const normalized = normalizeAssetPath(relative);
+    if (normalized === undefined)
+        return undefined;
+    for (const directory of roots) {
+        const root = path.resolve(directory);
+        const file = path.resolve(root, normalized);
+        // `path.resolve` has already collapsed every `..`; anything that landed
+        // outside the root was trying to get out.
+        if (file !== root && !file.startsWith(root + path.sep))
+            continue;
+        let stats;
+        try {
+            stats = statSync(file);
+        }
+        catch {
+            continue;
+        }
+        if (!stats.isFile())
+            continue;
+        return {
+            file,
+            stats,
+            contentType: contentTypeFor(file),
+            etag: `"${stats.size.toString(16)}-${Math.trunc(stats.mtimeMs).toString(16)}"`,
+        };
+    }
+    return undefined;
+}
+/**
+ * A request path under an asset prefix as a path relative to the directory it
+ * is served from, or `undefined` when it is not one worth looking up.
+ */
+function normalizeAssetPath(relative) {
+    if (relative === '' || relative.endsWith('/'))
+        return undefined;
+    if (relative.includes('\0'))
+        return undefined;
+    // A leading slash would make `path.resolve` ignore the theme directory.
+    return relative.replace(/^\/+/, '');
+}
+const THEME_CONTENT_TYPES = new Map([
+    ['.css', 'text/css; charset=utf-8'],
+    ['.js', 'text/javascript; charset=utf-8'],
+    ['.mjs', 'text/javascript; charset=utf-8'],
+    ['.json', 'application/json; charset=utf-8'],
+    ['.map', 'application/json; charset=utf-8'],
+    ['.svg', 'image/svg+xml'],
+    ['.ico', 'image/x-icon'],
+    ['.woff', 'font/woff'],
+    ['.woff2', 'font/woff2'],
+    ['.ttf', 'font/ttf'],
+    ['.otf', 'font/otf'],
+    ['.webmanifest', 'application/manifest+json'],
+]);
+function contentTypeFor(file) {
+    const extension = path.extname(file).toLowerCase();
+    const upload = UPLOAD_MEDIA_TYPES.get(extension);
+    if (upload !== undefined)
+        return servedType(upload);
+    return THEME_CONTENT_TYPES.get(extension) ?? 'application/octet-stream';
+}
+//# sourceMappingURL=static-files.js.map

package/dist/files/static-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-files.js","sourceRoot":"","sources":["../../src/files/static-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAcnE;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,QAAgB,EAAE,KAAe;IACzD,MAAM,UAAU,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAChD,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAE/C,KAAK,MAAM,SAAS,IAAI,KAAK,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAE5C,wEAAwE;QACxE,0CAA0C;QAC1C,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC;YAAE,SAAS;QAEjE,IAAI,KAAY,CAAC;QACjB,IAAI,CAAC;YACH,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;YAAE,SAAS;QAE9B,OAAO;YACL,IAAI;YACJ,KAAK;YACL,WAAW,EAAE,cAAc,CAAC,IAAI,CAAC;YACjC,IAAI,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG;SAC/E,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,SAAS,kBAAkB,CAAC,QAAgB;IAC1C,IAAI,QAAQ,KAAK,EAAE,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAChE,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9C,wEAAwE;IACxE,OAAO,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,mBAAmB,GAAgC,IAAI,GAAG,CAAC;IAC/D,CAAC,MAAM,EAAE,yBAAyB,CAAC;IACnC,CAAC,KAAK,EAAE,gCAAgC,CAAC;IACzC,CAAC,MAAM,EAAE,gCAAgC,CAAC;IAC1C,CAAC,OAAO,EAAE,iCAAiC,CAAC;IAC5C,CAAC,MAAM,EAAE,iCAAiC,CAAC;IAC3C,CAAC,MAAM,EAAE,eAAe,CAAC;IACzB,CAAC,MAAM,EAAE,cAAc,CAAC;IACxB,CAAC,OAAO,EAAE,WAAW,CAAC;IACtB,CAAC,QAAQ,EAAE,YAAY,CAAC;IACxB,CAAC,MAAM,EAAE,UAAU,CAAC;IACpB,CAAC,MAAM,EAAE,UAAU,CAAC;IACpB,CAAC,cAAc,EAAE,2BAA2B,CAAC;CAC9C,CAAC,CAAC;AAEH,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IACnD,MAAM,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACjD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;IACpD,OAAO,mBAAmB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,0BAA0B,CAAC;AAC1E,CAAC"}

package/dist/files/tar.d.ts

@@ -0,0 +1,29 @@
+export interface TarFile {
+    readonly name: string;
+    readonly mode: number;
+    readonly size: number;
+    readonly mtime: Date;
+}
+export type TarEntryType = 'file' | 'directory' | 'link' | 'other';
+export interface TarEntry {
+    readonly name: string;
+    readonly type: TarEntryType;
+    readonly mode: number;
+    readonly body: Buffer;
+}
+export interface TarStreamEntry {
+    readonly name: string;
+    readonly type: TarEntryType;
+    readonly mode: number;
+    readonly size: number;
+    readonly mtime: Date;
+    /** The entry's bytes. Whatever is left unread is skipped when the next entry is asked for. */
+    readonly body: AsyncIterable<Buffer>;
+}
+export declare const TAR_END: Buffer;
+export declare function tarPadding(size: number): Buffer;
+export declare function sealHeader(block: Buffer): Buffer;
+export declare function tarHeader(file: TarFile): Buffer;
+export declare function readTarStream(gzipped: AsyncIterable<Uint8Array> | Iterable<Uint8Array>): AsyncGenerator<TarStreamEntry>;
+export declare function readTar(gzipped: Buffer): Promise<TarEntry[]>;
+//# sourceMappingURL=tar.d.ts.map

package/dist/files/tar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tar.d.ts","sourceRoot":"","sources":["../../src/files/tar.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;CACtB;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;AAEnE,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IACrB,8FAA8F;IAC9F,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACtC;AAED,eAAO,MAAM,OAAO,EAAE,MAAgC,CAAC;AAEvD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AA0BD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKhD;AAWD,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAsB/C;AAkED,wBAAuB,aAAa,CAClC,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,GACxD,cAAc,CAAC,cAAc,CAAC,CA6DhC;AAED,wBAAsB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAalE"}

package/dist/files/tar.js

@@ -0,0 +1,206 @@
+import { pipeline } from 'node:stream/promises';
+import { createGunzip } from 'node:zlib';
+/**
+ * A ustar archive, written one entry at a time, and read whole or as a stream. A name that
+ * does not fit the header's 100 bytes, or is not ASCII, and a size past the
+ * header's octal field, travel in a PAX extended header before the entry, as
+ * GNU and BSD tar read them.
+ */
+const BLOCK = 512;
+const NAME_BYTES = 100;
+const SIZE_LIMIT = 8 ** 11;
+export const TAR_END = Buffer.alloc(BLOCK * 2);
+export function tarPadding(size) {
+    return Buffer.alloc((BLOCK - (size % BLOCK)) % BLOCK);
+}
+function octal(value, width) {
+    return `${value.toString(8).padStart(width - 1, '0')}\0`;
+}
+function header(fields) {
+    const block = Buffer.alloc(BLOCK);
+    block.write(fields.name, 0, NAME_BYTES, 'utf8');
+    block.write(octal(fields.mode & 0o7777, 8), 100, 'ascii');
+    block.write(octal(0, 8), 108, 'ascii');
+    block.write(octal(0, 8), 116, 'ascii');
+    block.write(octal(fields.size, 12), 124, 'ascii');
+    block.write(octal(fields.mtime, 12), 136, 'ascii');
+    block.write(fields.type, 156, 'ascii');
+    block.write('ustar\0', 257, 'ascii');
+    block.write('00', 263, 'ascii');
+    return sealHeader(block);
+}
+export function sealHeader(block) {
+    block.write(' '.repeat(8), 148, 'ascii');
+    const sum = block.reduce((total, byte) => total + byte, 0);
+    block.write(`${sum.toString(8).padStart(6, '0')}\0 `, 148, 'ascii');
+    return block;
+}
+function paxRecord(key, value) {
+    const text = ` ${key}=${value}\n`;
+    let length = Buffer.byteLength(text) + 1;
+    while (String(length).length + Buffer.byteLength(text) !== length) {
+        length = String(length).length + Buffer.byteLength(text);
+    }
+    return `${String(length)}${text}`;
+}
+export function tarHeader(file) {
+    const mtime = Math.floor(file.mtime.getTime() / 1000);
+    const fitsName = /^[\x20-\x7e]*$/.test(file.name) && file.name.length <= NAME_BYTES;
+    const fitsSize = file.size < SIZE_LIMIT;
+    const plain = header({
+        name: fitsName ? file.name : file.name.slice(0, NAME_BYTES).replace(/[^\x20-\x7e]/g, '_'),
+        mode: file.mode,
+        size: fitsSize ? file.size : 0,
+        mtime,
+        type: '0',
+    });
+    if (fitsName && fitsSize)
+        return plain;
+    const records = Buffer.from((fitsName ? '' : paxRecord('path', file.name)) +
+        (fitsSize ? '' : paxRecord('size', String(file.size))));
+    return Buffer.concat([
+        header({ name: 'PaxHeader', mode: 0o644, size: records.length, mtime, type: 'x' }),
+        records,
+        tarPadding(records.length),
+        plain,
+    ]);
+}
+function field(block, start, length) {
+    return block
+        .subarray(start, start + length)
+        .toString('utf8')
+        .replace(/\0.*$/s, '');
+}
+function paxValues(records) {
+    const values = new Map();
+    for (const record of records.split('\n')) {
+        const match = /^\d+ ([^=]+)=(.*)$/s.exec(record);
+        if (match?.[1] !== undefined && match[2] !== undefined)
+            values.set(match[1], match[2]);
+    }
+    return values;
+}
+function typeOf(flag) {
+    if (flag === '0' || flag === '\0')
+        return 'file';
+    if (flag === '5')
+        return 'directory';
+    if (flag === '1' || flag === '2')
+        return 'link';
+    return 'other';
+}
+const EXTENDED_HEADER_LIMIT = 1024 * 1024;
+function cutShort() {
+    return new Error('The archive is cut short: it ends inside an entry.');
+}
+class ByteReader {
+    #chunks;
+    #held = Buffer.alloc(0);
+    constructor(chunks) {
+        this.#chunks = chunks[Symbol.asyncIterator]();
+    }
+    async #more() {
+        const next = await this.#chunks.next();
+        if (next.done === true)
+            return false;
+        this.#held = this.#held.length === 0 ? next.value : Buffer.concat([this.#held, next.value]);
+        return true;
+    }
+    async exactly(count) {
+        while (this.#held.length < count) {
+            if (!(await this.#more())) {
+                if (this.#held.length === 0)
+                    return undefined;
+                throw cutShort();
+            }
+        }
+        const taken = this.#held.subarray(0, count);
+        this.#held = this.#held.subarray(count);
+        return taken;
+    }
+    async piece(most) {
+        if (this.#held.length === 0 && !(await this.#more()))
+            throw cutShort();
+        const taken = this.#held.subarray(0, Math.min(most, this.#held.length));
+        this.#held = this.#held.subarray(taken.length);
+        return taken;
+    }
+}
+export async function* readTarStream(gzipped) {
+    const gunzip = createGunzip();
+    pipeline(gzipped, gunzip).catch(() => undefined);
+    const reader = new ByteReader(gunzip);
+    let pax = new Map();
+    let longName;
+    try {
+        for (;;) {
+            const block = await reader.exactly(BLOCK);
+            if (block === undefined || block.every((byte) => byte === 0))
+                return;
+            const flag = String.fromCharCode(block[156] ?? 0);
+            const size = Number(pax.get('size') ?? Number.parseInt(field(block, 124, 12).trim() || '0', 8));
+            if (!Number.isSafeInteger(size) || size < 0) {
+                throw new Error('The archive holds an entry with a size that is not a whole number.');
+            }
+            const padding = tarPadding(size).length;
+            if (flag === 'x' || flag === 'L') {
+                if (size > EXTENDED_HEADER_LIMIT)
+                    throw new Error('The archive holds an oversized header.');
+                const body = (await reader.exactly(size + padding)) ?? Buffer.alloc(0);
+                if (body.length < size)
+                    throw cutShort();
+                const text = body.subarray(0, size).toString('utf8');
+                if (flag === 'x')
+                    pax = paxValues(text);
+                else
+                    longName = text.replace(/\0.*$/s, '');
+                continue;
+            }
+            const prefix = field(block, 345, 155);
+            const name = pax.get('path') ?? longName ?? (prefix === '' ? '' : `${prefix}/`) + field(block, 0, 100);
+            const seconds = Number(pax.get('mtime') ?? Number.parseInt(field(block, 136, 12).trim() || '0', 8));
+            pax = new Map();
+            longName = undefined;
+            let left = size;
+            yield {
+                name,
+                type: typeOf(flag),
+                mode: Number.parseInt(field(block, 100, 8).trim() || '0', 8),
+                size,
+                mtime: new Date(Math.floor(seconds * 1000)),
+                body: {
+                    async *[Symbol.asyncIterator]() {
+                        while (left > 0) {
+                            const piece = await reader.piece(left);
+                            left -= piece.length;
+                            yield piece;
+                        }
+                    },
+                },
+            };
+            while (left > 0)
+                left -= (await reader.piece(left)).length;
+            if (padding > 0 && (await reader.exactly(padding)) === undefined)
+                throw cutShort();
+        }
+    }
+    finally {
+        gunzip.destroy();
+    }
+}
+export async function readTar(gzipped) {
+    const entries = [];
+    for await (const entry of readTarStream([gzipped])) {
+        const pieces = [];
+        for await (const piece of entry.body)
+            pieces.push(piece);
+        entries.push({
+            name: entry.name,
+            type: entry.type,
+            mode: entry.mode,
+            body: Buffer.concat(pieces),
+        });
+    }
+    return entries;
+}
+//# sourceMappingURL=tar.js.map

package/dist/files/tar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tar.js","sourceRoot":"","sources":["../../src/files/tar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;;GAKG;AAEH,MAAM,KAAK,GAAG,GAAG,CAAC;AAClB,MAAM,UAAU,GAAG,GAAG,CAAC;AACvB,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,CAAC;AA4B3B,MAAM,CAAC,MAAM,OAAO,GAAW,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;AAEvD,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,KAAK,CAAC,KAAa,EAAE,KAAa;IACzC,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC;AAC3D,CAAC;AAED,SAAS,MAAM,CAAC,MAMf;IACC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAChD,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,GAAG,MAAM,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAC1D,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IACvC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IACvC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAClD,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IACnD,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IACvC,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IACrC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3D,KAAK,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IACpE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,SAAS,CAAC,GAAW,EAAE,KAAa;IAC3C,MAAM,IAAI,GAAG,IAAI,GAAG,IAAI,KAAK,IAAI,CAAC;IAClC,IAAI,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,MAAM,EAAE,CAAC;QAClE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,UAAU,CAAC;IACpF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACxC,MAAM,KAAK,GAAG,MAAM,CAAC;QACnB,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC;QACzF,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,KAAK;QACL,IAAI,EAAE,GAAG;KACV,CAAC,CAAC;IACH,IAAI,QAAQ,IAAI,QAAQ;QAAE,OAAO,KAAK,CAAC;IACvC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CACzB,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CACzD,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;QAClF,OAAO;QACP,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC;QAC1B,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AAED,SAAS,KAAK,CAAC,KAAa,EAAE,KAAa,EAAE,MAAc;IACzD,OAAO,KAAK;SACT,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC;SAC/B,QAAQ,CAAC,MAAM,CAAC;SAChB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,SAAS,CAAC,OAAe;IAChC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,MAAM,CAAC,IAAY;IAC1B,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IACjD,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,WAAW,CAAC;IACrC,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,MAAM,CAAC;IAChD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,qBAAqB,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1C,SAAS,QAAQ;IACf,OAAO,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU;IACL,OAAO,CAAwB;IACxC,KAAK,GAAW,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEhC,YAAY,MAA6B;QACvC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACvC,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QACrC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5F,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAa;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;YACjC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC;gBAC1B,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO,SAAS,CAAC;gBAC9C,MAAM,QAAQ,EAAE,CAAC;YACnB,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAY;QACtB,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YAAE,MAAM,QAAQ,EAAE,CAAC;QACvE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QACxE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC/C,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,aAAa,CAClC,OAAyD;IAEzD,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IACpC,IAAI,QAA4B,CAAC;IACjC,IAAI,CAAC;QACH,SAAS,CAAC;YACR,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC1C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,CAAC;gBAAE,OAAO;YACrE,MAAM,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;YAClD,MAAM,IAAI,GAAG,MAAM,CACjB,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC,CAC3E,CAAC;YACF,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;gBAC5C,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;YACxF,CAAC;YACD,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;YAExC,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjC,IAAI,IAAI,GAAG,qBAAqB;oBAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;gBAC5F,MAAM,IAAI,GAAG,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBACvE,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI;oBAAE,MAAM,QAAQ,EAAE,CAAC;gBACzC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACrD,IAAI,IAAI,KAAK,GAAG;oBAAE,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;;oBACnC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;gBAC3C,SAAS;YACX,CAAC;YAED,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;YACtC,MAAM,IAAI,GACR,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,QAAQ,IAAI,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;YAC5F,MAAM,OAAO,GAAG,MAAM,CACpB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC,CAC5E,CAAC;YACF,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,QAAQ,GAAG,SAAS,CAAC;YAErB,IAAI,IAAI,GAAG,IAAI,CAAC;YAChB,MAAM;gBACJ,IAAI;gBACJ,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;gBAClB,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;gBAC5D,IAAI;gBACJ,KAAK,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;gBAC3C,IAAI,EAAE;oBACJ,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;wBAC3B,OAAO,IAAI,GAAG,CAAC,EAAE,CAAC;4BAChB,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;4BACvC,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC;4BACrB,MAAM,KAAK,CAAC;wBACd,CAAC;oBACH,CAAC;iBACF;aACF,CAAC;YACF,OAAO,IAAI,GAAG,CAAC;gBAAE,IAAI,IAAI,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;YAC3D,IAAI,OAAO,GAAG,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,SAAS;gBAAE,MAAM,QAAQ,EAAE,CAAC;QACrF,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,OAAO,EAAE,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,OAAe;IAC3C,MAAM,OAAO,GAAe,EAAE,CAAC;IAC/B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QACnD,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,KAAK,CAAC,IAAI;YAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzD,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;SAC5B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/files/upload-types.d.ts

@@ -0,0 +1,81 @@
+/**
+ * What may be uploaded into `content/uploads/`, described once.
+ *
+ * The upload endpoint is the only door into the content directory that does
+ * not write Markdown, so what it accepts is a list rather than a judgement:
+ * an extension the CMS has never heard of is refused, and one it has is
+ * checked against the media type the browser declared and, where the format
+ * has one, against the bytes the file actually starts with.
+ *
+ * The table lives here rather than beside the endpoint because
+ * {@link ResolvedConfig} validates a site's allowlist against it and the
+ * static file server serves each upload as the type named here, and neither
+ * may depend on the admin or the content layer.
+ */
+/** Bytes a file of some format carries at a fixed offset. */
+export interface UploadSignature {
+    /** Where in the file the bytes are. */
+    offset: number;
+    /** The bytes themselves. */
+    bytes: readonly number[];
+}
+/**
+ * What an upload is for, which decides what the CMS offers to do with it.
+ *
+ * An image is embedded and gets variants, audio and video can be a post's
+ * enclosure and are held to their own size limit, and a document is linked.
+ */
+export type UploadKind = 'image' | 'audio' | 'video' | 'document';
+/** One kind of file the upload endpoint knows about. */
+export interface UploadMediaType {
+    /**
+     * Media types a browser may declare for this extension. An empty string is
+     * always accepted alongside these: a browser that does not recognise a file
+     * sends no type at all, and there is then nothing to disagree with.
+     */
+    declared: readonly [string, ...string[]];
+    /** What the file is for. */
+    kind: UploadKind;
+    /**
+     * Byte patterns that identify the format, as alternatives: a file matches
+     * when every part of any one of them matches. Absent for the text formats,
+     * which have no header to check.
+     */
+    signatures?: readonly (readonly UploadSignature[])[] | undefined;
+    text?: true;
+}
+/**
+ * Every extension the upload endpoint can accept, and what it takes to be one.
+ *
+ * SVG is deliberately absent. An SVG is a document that may carry script, and
+ * an upload is served from the site's own origin, so accepting one would hand
+ * anybody who can reach the editor a stored cross-site scripting hole. A site
+ * that wants them anyway can put `.svg` in `uploadTypes` — and then it has
+ * chosen that, which is the point.
+ */
+export declare const UPLOAD_MEDIA_TYPES: ReadonlyMap<string, UploadMediaType>;
+/** The extensions a site may put in its allowlist, sorted. */
+export declare const KNOWN_UPLOAD_TYPES: readonly string[];
+/**
+ * An extension as the allowlist spells it: lower case, with the dot.
+ *
+ * `PNG`, `.Png` and `png` are all the same thing to somebody writing a config
+ * file, so they are the same thing here.
+ */
+export declare function normalizeUploadType(value: string): string;
+/**
+ * The media type a feed or an attachment announces for this kind of file: the
+ * first one {@link UploadMediaType.declared} lists, which is the registered
+ * name where a browser may also send an older one.
+ */
+export declare function canonicalType(media: UploadMediaType): string;
+export declare function servedType(media: UploadMediaType): string;
+/**
+ * Whether the first bytes of a file are the ones its extension implies.
+ *
+ * A format with no signature — the text ones — matches anything, because there
+ * is nothing to compare. Returns `false` for a file too short to hold the
+ * header it claims.
+ */
+export declare function matchesSignature(media: UploadMediaType, bytes: Uint8Array): boolean;
+//# sourceMappingURL=upload-types.d.ts.map

package/dist/files/upload-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-types.d.ts","sourceRoot":"","sources":["../../src/files/upload-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,6DAA6D;AAC7D,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;AAElE,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACzC,4BAA4B;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,SAAS,CAAC,SAAS,eAAe,EAAE,CAAC,EAAE,GAAG,SAAS,CAAC;IACjE,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAgBD;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAkKlE,CAAC;AAEH,8DAA8D;AAC9D,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAA0C,CAAC;AAE3F;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAE5D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAGzD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CASnF"}